Members for Pane Class

The table below lists the members for the Pane class.

Note: These methods cannot be used to control panes that are inside of record or grid panes. Record and grid panes contain a list of values for the panes and controls that are inside of them, but the pane methods do not contain indexes to specify which pane or control to act upon. For example, the following cannot be used to control the visibility of a tabbed pane in a record pane:
pane.Accounts_correspondence.visible = false;

However, a computation action can be used as a workaround. For the example shown above, create a computation action on the "Visible" property of the "correspondence" pane for the "Accounts" update event, and compute the value using the context.record property. For example:

var correspVisible = true;
if (context.record != null) {
var genInfo = context.record.generalInformation;
if (genInfo != null)
{ correspVisible = "PROXYHOLDER" != genInfo.selectType; }

}
correspVisible;

This will make the "correspondence" tab invisible when "PROXYHOLDER" is selected. The context.record will point to that record in the record pane relative to the instance where the value is computed.

Property Return Value Description Read Only
reallyEnabled
Boolean The enabled setting of a pane is controlled both by its own enabled property, and the enabled properties of any of its ancestors. If the parent pane of a pane is disabled, then reallyEnabled returns false for that control. The method returns true only if its own enabled property is true and all of its ancestor's enabled properties are set to true. Y
reallyReadOnly
Boolean

The readOnly setting of a control is controlled both by its own readOnly property, and the readOnly properties of any of its ancestors. If the parent pane of a control is not read only, then reallyReadOnly returns false for that control. The method returns true everytime it's own readOnly property is true or any of its ancestor's readOnly property is true.

.
Y
reallyVisible
Boolean The visibility of a pane is controlled both by its own visibility property, and the visibility properties of any of its ancestors. If the parent pane of a pane is not visible, then reallyVisible returns false for that control. The method returns true only if it's own visibility property is true and all of its ancestor's visibility properties are set to true. Y
activeTab
Pane Returns the active child pane for a tabbed pane.
controls
Control[] Returns an array of controls that are direct children of this pane. Y
enabled
Boolean Retrieves the enabled flag for this pane.
form
Form Returns the form object to which this pane belongs. Y
label
String Retrieves the label for this pane.
name
String Returns the name of the pane. Y
panes
Pane[] Returns an array of panes that are direct children of this pane. Y
paneType
String Returns the pane type of this pane (for example, 
"com.tibco.forms.panes.vertical"). Y
parent
Pane or Form Returns the parent pane or form object to which this pane belongs. Y
readOnly
Boolean Returns the read-only state of this pane.
selection
List or Object Returns the object currently selected in the grid or record pane. If the grid supports multiple selections, then this is a list that contains the selected records. Y
selectedIndex
Pane Returns the index of the currently selected row of a single select grid pane or the index of the currently selected record of the record pane. If there is no selection, it returns -1
value
List or Object For grid and record panes returns a list. Returns null or a complex object value for other pane types. Y
visible
Boolean Retrieves the visible flag for this pane. Y
Method Return Value Description Read Only
addMessage(String message, String cssClasses, Control or Pane target, Integer row)
String Adds a message at the end of the message pane and returns a message identifier, which can be used to remove the message. The parameters are:
  • message: is the message string that is added at the end of the message pane
  • cssClasses: is the space-separated list of CSS classes to allow custom styling of the message. You need to add the cssClasses string to the element containing the message.
  • target: is either a control or a pane to which the message is targeted. If specified, renders a message as a link, to allow users to navigate directly to the target of the message. If null, then the message is not rendered as a link.
  • row: is the row of the list control or the control in a grid pane, to which the message is targeted. This is used only if a control is specified in the target parameter, and it is a list control or the control is in a grid pane. This is an optional parameter. If null, then the first element in the list control or grid pane column is targeted with a clickable message. If the target is a list control within a grid pane, then an array of length two needs to be specified. The first number in the array indicates the row of the control. The second value indicates the index of the value within the list control that receives the focus.
cancel()
Void Cancels the modal dialog and triggers a cancel event.
clearMessages()
Void Clears all messages added to the message pane using the addMessage() API.
close()
Void Closes the modal dialog and triggers a close event.
isOpen
Boolean Returns True if the modal dialog is open. Y
open()
Void Opens the modal dialog and triggers an open event. Throws an exception if the same or another modal dialog is already open on the form.
removeMessage(String messageId)
Void Removes a message previously added to the message pane using the addMessage()API. You may only remove the messages added using the addMessage() API. The messageId is an identifier used to specify which message needs to be removed.
setActiveTab(Pane childPane)
Void Sets the active child pane for a tabbed pane. The tab to be set as active tab is passed as childPane parameter to the method. The childPane parameter must be a direct child pane of the tabbed pane.
validate(Boolean updateMessagePane)
Boolean Forces validation to run on the pane and all child panes and controls. Returns true if all validations return true. If updateMessagePane is true, then validation messages are displayed in the messages pane for any validation that failed. If updateMessagePane is not specified, it is treated as false