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. PROJ-649
5.4
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. GRP-229
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. SR-4597 B-22011 Single Value
only? (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. B-16325 Rejected
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. Proj-1424
|
Control
|
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. C-1990
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.
C-2526
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.
PROJ-198 RULE-298 - To cut, copy, or paste a Select box in a
cell, right-click in the cell to access a context-menu.
PROJ-198 TASK-141
About Flow Action rules
About Harness rules
About Section rules