Show all
A cell in a layout can present the value of a property, as
display-only or as an input field. Follow these instructions to
control the presentation of a property value in a Select box.
Don't confuse this Select control — which supports the
run-time presentation of a fixed list of choices, such as produced in the Table Type area of a property rule —
with the Dynamic Select control, where the choices are
determined at runtime by running an activity. See Harness, Section, and Flow
Action forms — Adding a Dynamic Select control.
1. Drag and drop the Select
control
2. Complete the Cell Properties panel
— Top fields
Click the magnifying glass icon () to open
the Cell Properties panel. Complete the top fields that appear.
If the panel is
pinned (), the wireframe presentation on
the rule form changes immediately to reflect of your inputs.
If the panel is not pinned (), click Apply to apply your inputs.
Field
|
Description
|
Property
|
Select or type a property reference that
identifies a single text value. (If you are only prototyping a
form and the property you want to reference is not yet
defined, use the template property .pyTemplateSelect.)
Alternatively, you can drag a property name from the
lists of properties visible in the Application
Explorer. Typically, this works for Single
Value properties belonging to in the Applies to class of the current rule
(or a higher class). If the container in which this
field sits has a non-blank Using Page value, you can drag a Single Value property from within that embedded page property.
Click the pencil icon () to review the property rule (if the
reference is to an existing property in the Applies To class of this rule or a
parent of that class). If the property is not found,
the New dialog box for the property form appears.
You can reference properties on any page identified
on the Pages & Classes tab, using the normal notation pagename.propertyname for pages other than the
page corresponding to the Applies To class of the rule.
If this field is in a cell of a section that
includes parameter declarations on the Parameters tab, you can enter the
notation param.NAME here, to use a parameter
value for the field, where NAME identifies a string
parameter. Make sure that the NAME parameter is
declared on the Parameters tab, and that your application provides a non-blank
value for the parameter value in all possible
situations where the section appears. See Section rules
— Completing the Parameter tab.
|
Display As
|
To represent the property as a select box, keep the value PromptSelect. (If you are only prototyping a
form and the property you want to reference is not yet
defined, use the template property .pyTemplateSelect.)
Click the magnifying glass icon ()to supply parameter values for this HTML property rule:
Parameter
|
Description
|
DisplayProperty
|
Optional. Leave blank in most cases. If the property in the Property field has a Table Type of Class Key Value (on the General tab of the Property form) you can enter a property name here (with no preceding period) from the class, to provide an initial value for the select. |
Size
|
Number of items to show at once in the select list. |
Width
|
Width of the select box, in HTML characters. |
ReadOnlySmartInfo
|
Optional. Purpose key part of a section to present as a SmartInfo pop-up for this control when the field is read-only. |
ReadWriteSmartInfo
|
Optional. Purpose key part of a section to present as a SmartInfo pop-up for this control when the field is read-only. |
SmartInfoHeader
|
Optional. Text to appear in a SmartInfo header. |
Click OK to save parameter values.
|
Behavior
|
Optional. Leave blank if no dynamic form actions to
other parts of the form are to occur based on user
updates or values for this field.
To establish a dynamic form action, click the
magnifying glass icon () to open the
Client Event Editor in a new dialog window. Complete
the Client Event Editor to select an event
(OnBlur , OnChange , or OnClick ) and the resulting form action.
Click the help icon ( ) on the Client Event Editor for
assistance. For general information on this capability,
see Implementing
dynamic form actions and the Client Event
Editor.
Client event support is not available for harness, section, or
flow action rules that use directives.
|
3. Complete the Cell Properties panel — General tab
4. Complete the Cell Properties panel — Advanced tab
Copying, deleting, duplicating, or
moving a Select box
Use these Windows operations
to speed development:
- To move a cell containing a Select box, hold
down the
SHIFT
key, select the cell, drag and
drop it in another cell, in the same one layout or another
layout. - To cut, copy, or paste a Select
box in a cell, right-click in the cell to access a
context-menu.
About Flow Action rules
About Harness rules
About Section rules