Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 7 Reference : Properties View Tabs

Properties View Tabs
Forms, panes, and controls can be configured by specifying or modifying values in Properties views. Each form, as well as each of its panes and controls, has a Properties view with a set of tabs, and each tab provides access to a group of properties.
The tabs on a Properties view provide easy access to the many properties you can set for the objects on a form. Properties tabs are provided for: Forms, Data, Parameter, Shared Actions, Rules, Pane, and Controls.
See Table 29 for details.
Properties View for Forms
The Properties view for a form contains eight tabs: General, Mappings, Font, Child Layout, Child Labels, Rules, Resources, and Preview Data. The form Properties view can be found by selecting the root-most element in the Outline view or clicking outside the panes of the form.
General Tab
The setting in this tab is used to specify one or more CSS classes for styling the form.
 
Table 30 Fields on the Forms General Tab
Mappings Tab
This tab is used to view, edit, and create mappings for the form. You can refer to Working with the Mappings Tab section for further details.
 
 
 
 
Font Tab
 
Table 31 Fields on the Forms Font Tab
Child Layout Tab
The setting in this tab apply to the labels of the root panes within the Form.
 
Table 32 Fields on the Forms Child Layout Tab
Determines the default border style inherited by top-level panes. Supported values are line and none. A line-style pane border is drawn as a horizontal line beneath the pane label and only appears when the label position is top.
Determines the default overflow strategy inherited by top-level panes. Overflow strategy determines how the pane responds to an explicit width and/or height setting that is less than the minimum required to display all of its content. Supported values are expand, auto, and hidden. The default strategy, expand, causes the pane to ignore a width or height setting if it is less than the minimum required. The auto strategy accepts the explicit size and displays scrollbars to enabled the hidden content to be revealed. The hidden strategy simply crops any content which lies outside the explicit bounds.
Child Labels Tab
 
Table 33 Fields in the Forms Child Labels Tab
Rules Tab
Resources Tab
 
Table 35 Fields on the Forms Resources Tab
 
Preview Data Tab
 
Table 36 Fields on the Preview Data Tab
Select a file to furnish initial data values for the controls on the form. Choices are None, Default, or Custom. If None is selected, no values appear initially in the form controls. Default provides a default value for each type of control. To use Custom, first create a copy of the default .data.json file. Edit its values, and then select the file in the Custom field.
It is also possible to create input data from the data submitted in preview. To do this, open the form in preview, fill out the values in the form, and click Submit. The submitted data is logged in the preview application. Copy the JSON object from the log, and paste it as the content of the custom .data.json file.
Properties View for Panes
The Properties view for a pane, whether it be a horizontal, vertical, tabbed, or message pane, contains nine tabs: General, Properties, Mappings, Layout, Font, Child Layout, Child Labels, Rules, and Mobile Properties. The Layout and Font tabs for panes are identical to those for controls.
General Tab
The Properties view for panes contain a General tab. This tab contains general properties for the pane currently selected in the canvas, and contains the following fields as shown in Table 37.
 
Table 37 General Tab for Panes
The name of the pane, used in JavaScript to refer to this object. The Rename button allows you to change the name using the Enter the Name dialog. The Name field only appears when the Solutions Design mode is active.
The label for the pane that appears on the form (if the Label Visibility > Visible check box is selected). This property is bindable.
See Setting Bindings and Setting Rules for more details.
A drop-down list showing the type of the pane. Allows you to select another type. If the object is a Vertical Pane, for instance, this setting can be used to change it to a Horizontal Pane.
See Setting Bindings and Setting Rules for more details.
See Setting Bindings and Setting Rules for more details.
Properties Tab
The Properties tab contains special fields that pertain specifically to the type of pane being configured. Thus the Properties tabs on the Properties view for panes differ in their fields.
The horizontal pane, vertical pane, tabbed pane, and message pane have a common set of properties on the Properties tab. The grid pane and record pane have some additional properties.
The following sections describes the Properties tab for these panes separately.
Properties Tab for the Horizontal Pane, Vertical Pane, and Tabbed Pane
Properties Tab for the Message Pane
Check box to suppress the display of messages from the modeled pane and control validations. The default value is false, in which case the message pane displays all messages, both modeled validations and those programmatically added using the API. If true, the message pane displays only programmatically added messages.
Properties Tab for the Record Pane
Check box to render a button in the record pane that can delete the currently viewed record. The default label is Delete, but can be overridden by providing a new value in the Label input box.
Properties Tab for the Grid Pane
Check box to render a button in the record pane that can delete the currently viewed record. The default label is Delete, but can be overridden by providing a new value in the Label input box.
External Reference: to pick the row label from an external resource. You need to define the row labels in the <row_labels>.properties file. The resource key for the row label must follow the naming convention <component-name>[.property].<featureName>, and end with .rowLabel or _rowLabel.
For example, pane.grid.property.rowLabel=Attr1 {0}.
 
Mappings Tab
The Properties view for panes contain a Mappings tab. This tab is used to view, edit, and create mappings for the selected pane. You can refer to Working with the Mappings Tab section for further details.
Layout Tab
Same as for controls. See Layout Tab.
Font Tab
Same as for controls. See Font Tab.
Child Layout
 
Table 42 Fields in the Child Layout Tab
Child Labels
The settings in this property tab pertain to the child controls and panes of this pane. They have no effect on the label of the pane itself.
 
Table 43 Fields in the Child Labels Tab
Specifies whether the layout properties of the pane are inherited. If the Inherit From Parent check box is selected, all fields are disabled for editing. Clearing the Inherit From Parent field allows you to edit all fields on this tab.
Validations Tab
The Validations tab lists the validation scripts defined for the pane, and provides a mechanism to create new validation for that pane.
true: The validation is invoked with the context.value set to the list value of a multi-valued control.
false: The validation is invoked once for each value in the list, with context.value set to a specific value each time.
true: The validation is invoked at runtime.
false: The validation is not invoked at runtime.
This button opens the Define Validation dialog. The dialog contains two parts, a Script area for writing the validation script, and a Message area for typing the message that is displayed in a message pane if your entry is invalid.
The Define Validation dialog allows you to specify when the validation script runs.
Rules Tab
Similar to the Properties tab, not all panes have a Rules tab on their Properties view, and for those that do, the Rules tabs differ in their supported events.
The following panes do have a Rules tab: Vertical Pane, Horizontal Pane, Record Pane and Grid Pane. The following panes do not have a Rules tab: Tabbed Pane and Message Pane.
 
Table 45 Fields in the Rules Tab
For each pane, only the event types supported by that pane is listed in the tab.
Clicking the icon opens the New Rule wizard, with the corresponding event already added to the new Rule. To add a new rule, see Setting Rules.
Mobile Tab
 
Table 46 Fields in the Mobile Tab
Properties View for Controls
General Tab
The Properties view for controls contains a General tab. This tab contains general properties for the object currently selected in the Canvas.
The Rename button allows you to change the name using the Enter the Name dialog. The Name field only appears when the Solutions Design mode is active.
A drop-down list showing the type of the control. Allows you to select another type. If the object is a Date control, for instance, this field can be used to change it to a Time or DateTime control.
At runtime, it is the value with which a control is initialized. Value is not supported for Hyperlink and Image controls.
Whether the label for the control can be seen on the form. Values can be Inherit, Visible, or not visible (neither check box selected).
 
Tabbing Navigation The Tab Index attribute can be used to determine the order in which elements receive focus as you navigate from field to field through a form with the tab key. The tabbing navigation behavior for a form is as follows:
Mappings Tab
The Properties view for controls contain a Mappings tab. This tab is used to view, edit, and create mappings for the selected control. You can refer to Working with the Mappings Tab section for further details.
Properties Tab
The Properties tab contains special fields that pertain specifically to the type of control being configured. Thus, not all controls have a Properties tab on their Properties view, and for those that do, the Properties tabs differ in their fields.
The following controls do have a Properties tab: Button, Date, Time, Date-Time, Hyperlink, Image, Optionlist, Passthrough, Radiogroup, Text, and Text Area. The following controls do not have a Properties tab: Check box and Label.
The following controls have an extra property on the Properties tab only if the control is a child of a grid pane: Date, Time, Date-Time, Optionlist, Radiogroup, Text, and Text Area.
The property details is as follows:
 
Table 48 Property for Child Controls of Grid Pane
Check box to render the grid pane child controls directly in edit mode. This property is related to Always render controls property for grid pane. If the Always render controls property is set to true, then all the controls on a grid pane are directly rendered in edit mode. However, if the Always render controls property is set to false, then the Always Render property setting on each control determines whether or not the control is rendered in edit mode. Refer to Properties Tab for the Grid Pane for further details.
The details of the Properties tab for each controls that have this tab is described separately below.
Properties Tab for the Button Control
The Properties tab is identical for each of them, except that the default value in the Button Type drop-down list is primary for the Submit button, and peripheral for the other button types. This means that a Submit button that is placed on a form from the palette, by default, is invoked on a mouse click or when you press the Enter key. Buttons of the other types are invoked only when they are clicked or otherwise selected.
Properties Tab for the Date Control
Check box used to specify whether the value of Start Year is interpreted as being relative to the current year or as an absolute year. The default value is true.
Check box to specify whether the value of End Year is interpreted as being relative to the current year or as an absolute year. The default value is true.
Properties Tab for the Time Control
 
Properties Tab for the Date-Time Control
Check box used to specify whether the value of Start Year is interpreted as being relative to the current year or as an absolute year. The default value is true.
Check box to specify whether the value of End Year is interpreted as being relative to the current year or as an absolute year. The default value is true.
Properties Tab for the Hyperlink Control
Properties Tab for the Image Control
Properties Tab for the Optionlist Control
Click the [...] button to choose an external object with value pairs, such as enumeration containing label values and name values.
 
Properties Tab for the Pass-through Control
Properties Tab for the Radiogroup Control
Click the [...] button to choose an object, such as an Enumeration from a business object model, that contains name-value or label-value pairs.
Properties Tab for the Text Control
The Format options are enabled only if the Numeric property is selected. The supported values are External Reference and Custom. See Using Numeric Controls for more information.
Properties Tab for the Text Area Control
The following controls have an extra property on the Properties tab only if the control is a child of a grid pane: Date, Time, Date-Time, Optionlist, Radiogroup, Text, and Text Area.
The property details are as follows:
 
Table 60 Property for Child Controls of Grid Pane
Check box to render the grid pane child controls directly in edit mode. This property is linked to Always render controls property of grid pane. If the Always render controls property is set to true, then all the controls on a grid pane are directly rendered in edit mode. However, if the Always render controls property is set to false, then the Always Render property setting on each control determines whether or not the control is rendered in edit mode. Refer to Properties Tab for the Grid Pane for further details.
Layout Tab
All Properties views for controls contain a Layout tab, and all Layout tabs contain the same fields. The following fields appear on the Layout tab for forms and for all panes and controls.
Table 61 Layout Tab
Specifies whether the layout properties of the control are inherited. If the Inherit check box is selected, all fields are disabled for editing. Clearing the Inherit field allows you to edit all fields on this tab.
Width of the pane or control. The width is that of the content area. For panes, this is the area occupied by child panes and controls; for controls, it is the area occupied by the control body, excluding label and hint areas.
Height of the pane or control. The height is that of the content area. For panes, this is the area occupied by child panes and controls; for controls, it is the area occupied by the control body, excluding label and hint areas.
expand   The pane expands to show all of its contents. (Manual values for a pane or control’s width or height that are less than the preferred width or height are ignored when the overflow mode is expand.)
auto   The pane uses scroll bars to show any content that cannot fit within the fixed width and height.
hidden   Any content that exceeds the prescribed width and height is not be shown.
Font Tab
Validations Tab
 
Table 63 Validations Tab for Controls
true : The validation is invoked when the context.value is set to the list value for a multi-valued control.
false : The validation is executed once for each value in the list, with context.value set to a specific value each time.
This button opens the Define Validation dialog. The dialog contains two parts, a Script area for writing the validation script, and a Message area for typing the message that is displayed in a message pane if your entry is invalid.
The Define Validation dialog allows you to specify when the validation script is run.
Rules Tab
The Rules tab lists the Rules triggered by each of the events supported by the Control, and provides a mechanism to create new Rules for that control.
For each Control, only the event types supported by that control is listed in the tab.
Clicking the icon opens the New Rule wizard, with the corresponding event already added to the new Rule. To add a new rule, see Setting Rules.
Mobile Tab
The Mobile tab is used for mobile specific configuration.
Specify a short label which is displayed instead of the Label for the mobile rendering of the form.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved