![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |
Table 29 Properties View Tabs Table 30 Fields on the Forms General 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.Table 31 Fields on the Forms Font Tab
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.Table 33 Fields in the Forms Child Labels Tab
Table 34 Fields in the Forms Rules Tab Table 35 Fields on the Forms Resources 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.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. 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.
Table 39 Properties for 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.
Table 40 Record Pane Properties Tab Check box to render a button in the record pane that can add a new record to the end of the list being managed by the record pane. The default label is New, but can be overridden by providing a new value in the Label input box. 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. Check box to defer the initialization of the children of the pane until the pane needs to be rendered. This means that the pane object itself is always instantiated and available, but any nested child is not initialized until the pane is about to be rendered. This property is enabled only if the Defer Rendering property is selected.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.Table 42 Fields in the Child Layout Tab
Sets the white-space gap between the outer edge of the child objects of this pane and their inner content. Specified as one to four implied pixel values applied in this order: top, right, bottom, and left. For example, 8 pixels of padding could be specified as 8, or as four space-separated values: 8 8 8 8. 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.
Table 44 Fields in the Validation Tab
• 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. Table 45 Fields in the Rules Tab
Clicking the iconopens the New Rule wizard, with the corresponding event already added to the new Rule. To add a new rule, see Setting Rules.
Table 46 Fields in the Mobile Tab
Used to specify a short label which is displayed instead of the ordinary label for the mobile rendering of the form.
Table 47 General Tab Fields 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). Determines whether the control is visible to you. This field can be bound to a parameter value, or its value can be set at runtime by an Action script, based on an event. Indicates whether you must provide a value for this control in order for the form to be successfully validated. At runtime, required fields are preceded by an asterisk, to indicate that the field is required. If you do not provide a value for a control that is required, the form cannot be submitted. This property is bindable. See Setting Bindings and Setting Rules for more details. Determines the position of the element in the tabbing order for the form. The tabbing order determines the order in which elements on the form receive focus when the tab key is used to navigate from one element to another. This attribute is valid for all controls except Image and Label controls, where focus is irrelevant. See the note Tabbing Navigation, page 332, for more details.
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: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.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.
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.
Table 49 Button Properties Tab Radiogroup list that allows the Form Designer to configure the type of button. Possible values are primary, peripheral, and associative. There are four kinds of buttons on the palette: Button (generic), Cancel Button, Submit Button, and Close Button.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.
Table 50 Date Control Properties Tab 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.
Table 51 Time Control Properties Tab
Table 52 Date Control Properties Tab 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. Specify the increment to be used while displaying the choice of minutes in the date-time control. The default value is 15 and the maximum value is 60.
Table 53 Hyperlink Properties Tab
Table 54 Image Properties Tab This value can be updated via script at runtime or by using a binding. If the location of the image is set dynamically to a relative path, then those resources are not be automatically deployed with the form. You can add these images as references in the form resources tab, so they are deployed when the form resource is deployed. See Configuring Parameters for more details.
Table 55 Optionlist Properties Tab Click the [...] button to choose an external object with value pairs, such as enumeration containing label values and name values.
Table 56 Pass-through Control Properties Tab
Table 57 Radiogroup Control Properties Tab
•
•
• Click the [...] button to choose an object, such as an Enumeration from a business object model, that contains name-value or label-value pairs.
Table 58 Text Properties Tab 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.
Table 59 Text Area Properties Tab
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.
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.
Table 62 Font Tab for Controls If selected, the font settings are inherited from the parent pane. This check box is selected by default for all controls and panes. Top level panes inherit their font settings from the form itself. At the form level, the equivalent default setting is Inherit from System Defaults. Clearing one of these Inherit check boxes makes the remaining fields on the Font tab editable. 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.
Table 64 Fields in the Controls Rules tab Clicking the iconopens the New Rule wizard, with the corresponding event already added to the new Rule. To add a new rule, see Setting Rules.
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 |