Understanding Form Control Design-Time Considerations
Some control property values are common to all controls, although many are shared by just a few. This table lists the property values for all control types. The descriptions given in some cases are for general use only. If a particular property significantly impacts a given form type, then those impacts are discussed in detail in the chapter devoted to that control. In addition to the standard controls you can add to a form using the Insert menu in FDA, this table includes grid columns which have their own property values separate from the grid itself and the standard menu properties such as OK, Save, Cancel, and so forth because they can act as push button controls. They are referred to as buttons in this table; for example, Select button.
Property |
Control |
Description |
---|---|---|
Allow Image Items |
Media Object |
An option to permit image items in the media object. |
Allow OLE Items |
Media Object |
An option to permit OLE objects in the media object. |
Allow RTF Text |
Media Object |
An option to permit RTF text to be included in the media object. |
Allow Text Items |
Media Object |
An option to permit plain text objects in the media object. The plain text in the file is stored in the database. |
Allowed in Saved Query |
Edit Grid column Saved Query Control |
An option to enable users to include the control as a filter value for a saved query. The property is available for entry only when a BV item is associated with the control. |
Alternate Grid Row Format String |
Grid |
An HTML string that provides values for formatting the grid differently from the default system grid formatting. The system uses this string only if the Use Alternate Grid Row Format property is selected. You can also choose the formatting at runtime with the Set Grid Row Format system function. Set it to <DEFAULT> to use the system grid formatting and <ALTERNATE> to use this HTML string instead. The system function can switch between formats regardless of whether Use Alternate Grid Row Format is enabled. |
Always Hidden |
Parent Child |
An option to hide the grid portion of the control. |
Automatic Scroll Horizontal |
Edit |
A property that indicates whether the user can see text that exceeds the width of the field. If you permit scrolling, you can choose to have the system automatically scroll ten characters to the right when the user types text, or you can display a horizontal scroll bar. |
Automatic Scroll Vertical |
Edit |
A property that indicates whether the user can see text that exceeds the height of the field when the Lines property is set to Multiple. If you permit scrolling, you can choose to have the system automatically scroll down a page when the user presses Enter, or you can display a vertical scroll bar. |
Automatically Find on Entry |
Grid Parent Child |
An option to cause runtime to populate the grid automatically when the form is entered. |
Business View Name |
Grid Parent Child Subform Subform Alias |
A property that indicates the BV underlying the control. In all cases except one, the BV for the control is the same as the one for the form. On a header detail form, the grid control may have a BV that is different than the one underlying the controls that comprise the header. |
Button Type |
Push Button |
A property that indicates the button type: OK, Cancel, Yes, No, and so forth. For form types except Message, the only option is Other. |
Calendar Day View Visible |
Calendar |
An option to enable users to access the view of the calendar that shows a single day at a time. |
Calendar Month View Visible |
Calendar |
An option to enable users to access the view of the calendar that shows an entire month at once. |
Calendar Week View Visible |
Calendar |
An option to enable users to access the view of the calendar that shows an entire week at once. |
Checked Value |
Check Box Grid column |
A property that is the value that the control returns when a user selects the control. The property applies to a grid column only when its Display Style property is set to Check Box. |
Clickable |
Grid column Icon grid column Image Static Text |
An option to cause runtime to fire the Text Clicked event when the user clicks the control. |
Client Edge |
Group Box |
An option to give the group box the appearance of depth. |
Collapsable |
Subform Subform Alias Group Box |
An option to enable users to hide the content of the subform or group box, displaying only its header. |
Column Header One |
Grid column |
A property that shows the text to be displayed in the first line of the column heading. |
Column Header Two |
Grid column |
A property that shows the text to be displayed in the second line of the column heading. |
Column Moved to Tree |
Parent Child |
A property that enables you to control which columns appear in the tree portion of the control. |
Column Order |
Grid Parent Child |
A property that controls the order in which the grid columns appear in the grid, from left to right in English. |
Column Sort Order |
Grid Parent Child |
A property that controls the order in which data returned to the grid is ordered for display. |
Control ID |
All control types |
A property that shows the system ID of the current control. It cannot be changed. |
Data Item Information |
Check Box Combo Box Edit Grid column Radio Button Static Text |
A property that shows the DD item or BV column associated with the control. BV column choices come from the BV associated with the form. |
Data Structure |
Subform Subform Alias |
A property that shows the data structure being used to pass data between parent and child. If no data structure is attached to the form, the property is unavailable for entry. |
Default cursor on add mode |
Edit Grid column Media Object |
An option to designate this field as the one in which the cursor appears initially when the form appears in Add mode. You can select this option for only one edit control on any given form. |
Default cursor on update mode |
Edit Grid column Media Object |
An option to designate this field as the one in which the cursor appears initially when the form appears in Update mode. You can select this option for only one edit control on any given form. |
Disable Copy |
Parent Child |
An option to prevent users from using the copy function in a cut/copy/paste operation. |
Disable Drag and Drop (Cut/Copy/Paste) |
Parent Child |
An option to prevent users from using the cut/copy/paste function. |
Disable Move (Cut) |
Parent Child |
An option to prevent users from using the move/cut function in a cut/copy/paste operation. |
Disable Page-at-a-Time Process |
Grid Parent Child |
An option to disable page-at-a-time processing. Page-at-a-time processing enables the runtime engine to fetch a single page of data only on the initial search call. If the user pages down, then runtime fetches only enough data to fill the next page. When disabled, runtime fetches and loads into memory all of the data at once. The number of rows that constitute a page of data is based on the Grid Row Count property. |
Disable QBE |
Grid column |
An option to disable the QBE cell above a given column. |
Disabled |
Calendar Check Box Close button Combo Box Delete button Edit Find button Grid Grid column Group Box Media Object OK button Parent Child Push Button Radio Button Saved Query Control Select button Static Text Subform Subform Alias Text Search Control |
An option to disable the control, preventing user interaction with it (although it can still be seen). You can also enable and disable controls during runtime with the Enable Control and Disable Control system functions. |
Display Customized Grid |
Grid |
An option to enable users the option to customize the grid through grid formats. |
Display Export to Excel |
Grid |
An option to enable users the option to send the contents of the control to an Excel spreadsheet. |
Display Export to Word |
Grid |
An option to enable users the option to send the contents of the control to a Microsoft Word file. |
Display Import from Excel |
Grid |
An option to enable users the option to bring the contents of an Excel spreadsheet into the control. |
Display Style |
Grid column |
An option to make cells in the column act (and appear) as check boxes. |
Do Not Clear After Add |
Edit Grid column |
An option to retain the data in the field after runtime performs an add function. After performing an add, runtime usually clears all form fields. |
Editable |
Subform Subform Alias |
A property that indicates whether the subform type can be edited. Reusable edit subforms can be edited, reusable browse subforms cannot. Embedded subforms are editable or not based on their context within the parent form. |
Expand All/Collapse All |
Parent Child |
An option to provide a button for the user to expand or collapse the entire tree. |
Fetch on Form/Subform Businessview |
Subform Subform Alias |
An option to cause the system to perform fetches from the subform business view. This option is disabled unless you have attached a BV to the subform. |
File Name |
Image |
A property that displays the name of the image file to be displayed in the control. |
Filter Criteria |
Edit Radio Button |
A property that indicates whether the control value should be incorporated into the database fetch. If you want to use the value, then you must also choose the relational operator by which the value should be evaluated. In some cases, you can designate that the relational value should be chosen by the user at runtime instead. |
Filter Criteria - Checked Filter |
Check Box |
A property that indicates whether the control should be incorporated in the database fetch as a filter criteria when the check box is selected. If you want to use this control as a filter, then you must also define how the filter value will be used by providing a relational operator or designate that the relational value should be set by the user at runtime instead. |
Filter Criteria - Unchecked Filter |
Check Box |
A property that indicates whether the control should be incorporated in the database fetch as a filter criteria when the check box is cleared. If you want to use this control as a filter, then you must also define how the filter value will be used by providing a relational operator or designate that the relational value should be set by the user at runtime instead. |
Flat |
Group Box |
An option to give the group box border the appearance of height. |
Form Name |
Subform Subform Alias |
A property that shows the system name for the subform. FDA names the subform based on JD Edwards EnterpriseOne naming standards (subforms start with S), the application name, and the creation sequence (the first subform is appended with an A, the second with a B, and so forth). You cannot change this property. |
Full File Name |
Image |
A property that displays the name and location of the image file to be displayed in the control. |
Grid Row Count |
Grid |
A property that shows the number of rows in a grid that constitute a "page." |
Height |
Calendar Check Box Close button Combo Box Delete button Edit Find button Grid Group Box Image Media Object OK button Parent Child Push Button Radio Button Saved Query Control Select button Static Text Subform Tab Control Text Box Control Text Search Control Tree Control Wizard |
A property that shows the height of the control in dialog units. You can change the height by typing a different value. |
Hide HTML Row Selector |
Grid |
An option to hide the row selector when the form is viewed in HTML. You might choose to hide the selector either because it is not needed or because you want to prevent users from selecting entire rows. |
Hide in Grid |
Parent Child |
A property that controls whether the designated tree column should be hidden in the grid. You should set this property to prevent the same column being displayed in two places, both in the tree and the grid. |
Hide Query By Example |
Grid Parent Child |
An option to hide the query-by-example (QBE) line above the grid. You might choose to hide the QBE either because it is not needed or because you want to prevent the users from defining query criteria on grid columns. |
Indent and Outdent |
Parent Child |
An option to enable the user to change the horizontal position of a node in the tree. |
Justification |
Check Box Edit Radio Button Static Text |
A property that indicates whether the text of the control will be left-, center-, or right-justified. |
Key Relations |
Parent Child |
A property that defines the values to use for certain key fields when the system builds queries. When you map a child key to a parent key, then the system sets the value of the parent variable equal to the associated child value for purposes of filtering the query. |
Left |
Calendar Check Box Close button Combo Box Delete button Edit Find button Grid Group Box Image Media Object OK button Parent Child Push Button Radio Button Saved Query Control Select button Static Text Subform Subform Alias Tab Control Text Box Control Text Search Control Tree Control |
A property that shows the distance from the left edge of the form to the left edge of the control in dialog units. You can change the horizontal placement of the control by typing a different value. |
Lines |
Edit |
An option to enable the field to display multiple lines of text. If you select this option, usually you also set the Automatic Scroll View property such that users can view the text if it exceeds the height of the control. |
Load Text by Instance |
Subform Alias |
An option that defines how jargon will be loaded for reusable subforms. If selected, the system fetches jargon based on the form that is using the subform. If cleared, the system fetches jargon based on the application where the subform is defined. |
Location Indicator Feature |
Parent Child |
An option to enable or disable location indicator functionality for the parent child control. If selected, the system enables the user to choose to display a location indicator for each tree node. |
Maintain Aspect Ratio |
Image |
An option to maintain the original width-to-height ratio when the image is resized. |
Mapping Links |
Subform Subform Alias |
A property that shows the mapping of data between a parent and its child forms. You must define this mapping to pass data between parent and child forms. |
Menubar Separator |
Close button Delete button Find button OK button Select button |
An option to display a line above the name of the control when viewed in a menu list. |
Modal Frame |
Group Box |
An option to give the group box the appearance of height. |
Move Up and Down |
Parent Child |
An option to enable the user to change the vertical position of a node in the tree. |
Multi-Line Edit |
Grid |
An option to post rows in groups of three to five to the database in the background. When disabled, in low interactivity mode, runtime posts each time the user tabs out of the row, forcing the user to wait for a refresh before continuing. This option does not apply to high interactivity. |
Multiple Select |
Grid Parent Child |
An option to enable users to select multiple lines to affect with a single operation, such as cut-and-paste. |
New Text Item on Open |
Media Object |
An option to cause the control to create a new text item automatically when the user first opens the control. |
No Adds On Update Grid |
Grid Parent Child |
An option to prevent users from adding new records to the control. Users can still edit existing rows, however. |
No display if currency is OFF |
Check Box Edit Grid column Radio Button Static Text |
An option to hide the control if currency is disabled. |
Node ID Column |
Parent Child |
An option to use this column as a unique identifier for that row. The system functions, Insert Grid Buffer Row By Node ID and Get Related Node ID, require a node ID column to work correctly. |
Number of columns joined to header |
Grid Parent Child |
A property that enables backwards compatibility of certain legacy applications. Note: Set this property value to zero for new applications. |
Overrides Button |
Check Box Combo Box Edit Grid column Radio Button |
A button to set DD overrides for the control. |
Parent |
Subform Subform Alias |
A property that indicates the form that acts as the parent to the current subform. |
Password |
Edit |
An option to cause the system to display an asterisk in place of the character the user actually typed. This feature is most often used to help protect passwords. |
Prevent Resizing |
Image |
An option to prevent the image from being resized during design time. |
Position of Saved Query links |
Saved Query Control |
A property that indicates where the saved query links appear relative to the main body of the control itself. |
Process All Rows in Grid |
Grid |
An option to cause runtime to apply row changed and row exited logic to all rows, no matter their state. |
Product Synch Mapping |
Parent Child |
A property that indicates how the data in the column will be used if the parent child control on which the grid resides has the Product Synch Mode property enabled. |
Product Synch Mode |
Parent Child |
An option to use the control for process mapping applications (that is, rapid manufacturing). |
Progress Indicator |
Wizard |
An option to display a progress indicator during runtime. You must also indicate its type, if the indicator is displayed. |
Read Only |
Edit Media Object |
An option to prevent users from changing the value in the control. |
Reclaim Whitespace |
Grid |
An option to cause runtime to shrink the control vertically so it displays only those rows which contain data (HTML only). |
Re-entry Save |
Wizard |
An option to enable users to save their input, quit, and then re-launch the wizard later, starting at the point where they saved. |
Required field |
Combo Box Edit Grid column |
An option to force users to enter a value into this control before being able to execute a form-level action such as OK or Save (except Cancel). Runtime displays an asterisk next to the required field label, if control and label are connected. |
Reusable |
Subform Subform Alias |
A property that indicates whether the subform is reusable. Subforms that were created independently of a parent (such as, reusable browse subform and reusable edit subform) are reusable and may be referenced by an alias on any number of power forms. Subforms that were created as a control on a parent form cannot be referenced with an alias and are therefore not reusable. |
Show DD Alias Tooltip |
I con grid column |
An option to display the Data Dictionary alias for the data item that an icon represents in the tooltip for that icon. |
Show DD Name Tooltip |
Icon grid column |
An option to display the Data Dictionary name for the data item that an icon represents in the tooltip for that icon. |
Show details of all tree nodes |
Parent Child |
An option to display one tree node for each grid row. |
Show Header |
Subform Subform Alias |
An option to display the header of the subform during runtime. |
Show Icon Tooltip |
Icon grid column |
An option to display the descriptive text for the data item that an icon represents in the tooltip for that icon. |
Show Value Tooltip |
Icon grid column |
An option to display the value of the data item that an icon represents in the tooltip for that icon. |
Sort Order |
Grid column |
A property that displays the order in which column data will be sorted (ascending or descending). |
Sortable by End User |
Grid column |
An option to enable the user to reorder the grid contents based on this column. |
Sorted |
Combo Box |
An option to sort the items in the drop-down box alphabetically. |
Static Edge |
Group Box |
An option to give the group box border the appearance of depth. |
Subform Application Name |
Subform Alias |
A property that shows the name of the application that contains the reusable subform to which the alias points. |
Support Aggregation |
Grid column |
An option to enable the aggregation of a math numeric or integer column type on a Find Browse form. |
Support Multiple Currencies |
Grid column |
An option to enable the column to handle and display amounts in differing currency types. |
Suppress Validation and Save |
Wizard |
An option to prevent runtime from validating and saving the data in the control. |
Tab Stop |
Calendar Check Box Combo Box Edit Grid Group Box Media Object Parent/Child Push Button Radio Button Saved Query Control Static Text Text Search Control |
An option to enable users to press Tab to move the focus to the control. |
Task List |
Wizard |
An option to display the task list during runtime. |
Text is Overridden |
Check Box Combo Box Edit Grid column Radio Button Static Text |
If the control is associated with a BV column or DD item, an option to change the title (the text that users can see) in this instance. |
Title |
Calendar Check Box Combo Box Edit Grid Group Box Image Media Object Parent Child Push Button Radio Button Saved Query Control Static Text Subform Tab Control Tab Page Text Block Control Text Search Control Tree Control Wizard |
A property that shows the text that the user can see. If the control is associated with a particular BV column or DD item, then you might need to select an overrides option to enable the field if you want to change its displayed text in a given instance. |
Tool Tip |
Image |
A property that shows the text that appears in the tool tip for the image. The tool tip is the text that appears when the user hovers over the object. |
Toolbar |
Close button Delete button Find button OK button Select button |
An option to display the control as a button on the standard application tool bar. |
Toolbar Separator |
Close button Delete button Find button OK button Select button |
An option to display a line to the left of the control button when it appears on the standard application tool bar. |
Top |
Calendar Check Box Close button Combo Box Delete button Edit Find button Grid Group Box Image Media Object OK button Parent Child Push Button Radio Button Saved Query Control Select button Static Text Subform Subform Alias Tab Control Text Search Control Text Box Control Tree Control |
A property that shows the distance from the top edge of the form to the top edge of the control in dialog units. You can change the vertical placement of the control by typing a different value. |
Transaction |
Subform |
An option to cause runtime to commit all changes at one time instead of individually. If the subform makes a single database change or a group of unrelated changes, do not select Transaction. However, if the subform has a group of inserts that rely on each other and if the system should revert to the previously committed changes if a change fails or for another condition, then select Transaction. |
Unchecked Value |
Check Box Grid column |
A property that is the value that the control returns when a user clears the control. The property applies to a grid column only when its Display Style property is set to Check Box. |
Update Mapping Link |
Push Button |
An option to cause the parent to push data to its child before runtime performs any button processing. |
Update Mode |
Grid |
An option to make the grid input-capable. Runtime implements this option only when the grid resides on input-type forms such as fix/inspect or header detail. |
Update on Form/Subform Businessview |
Subform |
An option to cause the system to update the tables underlying the subform (except those underlying the grid control) during runtime when the user clicks the OK button. If you want greater control over subform updates, clear this option. This option is unavailable for entry unless you have attached a BV to the subform. |
Use Alternate Grid Row Format |
Grid |
An option to use the HTML string in the Alternate Grid Row Format property to format the grid instead of using the default system formatting for grids. |
UTC Display Format |
Edit Grid control |
A property that controls how to display time and date fields. This property value is available for entry if the BV column or DD item associated with the control has a type of U-Time. This type of data represents date and time in Coordinated Universal Time (UTC) format. The offset is from Greenwich Mean. This field is not a mask. Whatever format you select comprises the only data that is saved to the database. Therefore, if you select a format that displays only the date and not the time, then only the date is written to the database. |
Value |
Radio Button |
A property that is the value that the control returns when a user selects the control. |
Visible |
Calendar Check Box Combo Box Edit Grid Grid column Group Box Image Media Object Parent Child Push Button Radio Button Saved Query Control Static Text Subform Subform Alias Tab Control Text Box Control Text Search Control Tree Control Wizard |
An option to enable users to see the control. You can also hide and show the control during runtime with the system functions, Hide Control and Show Control. |
Width |
Calendar Check Box Close button Combo Box Delete button Edit Find button Grid Grid column Group Box Image Media Object OK button Parent Child Push Button Radio Button Saved Query Control Select button Static Text Subform Tab Control Text Box Control Text Search Control Tree Control Wizard |
A property that shows the width of the control in dialog units. You can change the width by typing a different value. |
Wildcard |
Edit |
At option to enable users to use the asterisk character as a wildcard when performing searches. |
Wrap Text |
Grid column |
An option to enable text to wrap if it exceeds the column width. Otherwise, the system truncates column text. |