Field, button, and nested panel properties
In the Guide Properties view, specify properties such as
the control type, caption, display rules, and Help. Guides support
both MX and Spark controls.
The same properties are displayed for fields, buttons, and nested
panels.
When you select a field in the Guide Tree view or the editor,
the Guide Properties view displays several properties that you can
edit:
Data sourceDisplays the path to the entity
in the data model. The binding icon indicates the binding state.
CaptionYou can specify the following
properties for the field caption:
- Text:
- Specifies the caption text. The caption text cannot be blank.
You can edit the text and add rich text formatting (RTF).
- Select font type :
- Displays the font name for the selected text.
- Select font size :
- Displays the font size for the selected text.
- Bold :
- Applies or removes bold formatting to selected text.
- Italic :
- Applies or removes italic formatting to selected text.
- Underline :
- Applies or removes underline formatting to selected text.
- Color :
- Applies a color to the selected text. You can select a color
from the color picker or type the hexadecimal value for the color.
- Left align :
- Aligns text to the left.
- Center align :
- Aligns text to the center.
- Right align :
- Aligns text to the right.
- Spread justify :
- Justifies the text.
- Bullets :
- Creates a bulleted list.
- Remove rich content settings while retaining the text :
- Removes RTF but preserves the text. It also removes any image
that may have been associated with the field.
- Link to:
- Specifies the URL for a link. The URL can use an absolute
or a relative path. When the Guide filler clicks a link, the linked
content appears in a separate browser window.
- Show/Hide image settings :
- Shows or hides the following image settings:
Image: Specifies
the URL for an image file. You can specify a URL to an image, or
you can select an image file that is in your application. To remove
the URL for an image, click the Remove button. Position: Specifies the image position.
Width: Specifies the image width.
Horizontal pad: Specifies horizontal padding for the
image.
Height: Specifies the image height.
Vertical pad: Specifies vertical padding for the image.
Scaling: When selected, maintains the aspect ratio.
- Position:
- Specifies where the caption is located relative to the field.
Select one of the following caption positions:
Left: Specifies
that the caption appears on the left of the field.
Right: Specifies that the caption appears on the right
of the field.
Top: Specifies that the caption appears on the top
of the field.
Bottom: Specifies that the caption appears on the
bottom of the field.
None: No caption appears.
- Style:
- Specifies the style for the field caption. The style options
come from the Guide Style that you specify for the Guide. (See Guide properties.)
You can
create or modify caption styles in the CSS file associated with
the selected Guide layout. The CSS files are located in the Guides
(system) application. For information about modifying the CSS file,
see Guide CSS Styles.
- Width (in pixels):
- Specifies the caption width. Overrides the default Caption Width
setting in the panel properties. If the caption includes both text
and an image, set the width to display the image and text appropriately
at run time.
Control TypeSpecifies properties for the control type. Different
properties are available for different control types. Guides support
both MX and Spark controls.
Note: When Spark checkboxes are
read-only, the error messages do not display as tool tips. However,
the error messages do appear as tool tips for MX checkboxes.
- Display as:
- Sets the run-time appearance for the selected field to a
specific control type. For example, if the control is defined in
the model as a button, you can set it to appear as a check box at
run time.
Note: List objects must have a Data Source, which
means they must be bound to an item in the data model.
- Style:
- Specifies the style for the control type. The style options
come from the Guide Style that you specify for the Guide. (See Guide properties.)
- Width (in pixels or %):
- Specifies the width of the selected field. Leaving this property
blank sets the field width to the default value. If a text object
includes an image, specify the width of the text object to prevent
overlapping. To accommodate multiple lines, adjust the width.
- Height (in pixels):
- Specifies the height of the selected field. This property
is available only when the field allows multiple lines. Leaving
this property blank sets the field height to the default value.
Property
|
Description
|
Applies to control types
|
List source
|
Specifies the item in the Data Model view
that is the source for a list. The list source can be a collection
in the model or the listOfItems value in a list source that you
add.
|
Check Box List
List Box, Radio Button
List
Static List
Drop Down List
|
Object flow
|
Specifies whether the list objects flow
horizontally or vertically.
|
Check Box List
Radio Button List
|
Minimum
|
Specifies the minimum value.
|
Horizontal Slider
Numeric Stepper
Vertical
Slider
|
Maximum
|
Specifies the maximum value.
|
Horizontal Slider
Numeric Stepper
Vertical
Slider
|
Nested panel
|
Specifies the panel to use as the nested
panel.
|
Nested Panel
|
Step size
|
Specifies the increment.
|
Numeric Stepper
|
Display format
|
Specifies the format for displaying the
data.
|
Text Input
Text Input Symbol
Date
Field (only when the Guide is based on an FML data model)
|
Comb length
|
Specifies the length.
|
Text Input Comb
|
Edit mask
|
Specifies a mask for the data.
|
Text Input
Text Input Mask
|
Prefix symbol
|
specifies a prefix for the data
|
Text Input Symbol
|
Suffix symbol
|
Specifies a suffix for the data.
|
Text Input Symbol
|
Advanced propertiesAdvanced Control Properties: Displays the Advanced
Properties dialog box. The dialog box lists additional properties
that are available for the selected control, and includes properties
for custom controls. Select the properties that you want to add
to the Guide Properties view for the current control. The selected properties
appear in the Advanced Properties section below. Configure the properties
as required.
For information about the advanced properties,
see the ActionScript 3.0 Reference for the Adobe
Flash Platform.
Some advanced properties may negatively
affect the behavior of some fields in a Guide.
When a Rotation
value is set, the Guide filler cannot enter data in the control. When
the control type is a drop-down list or a list box, setting a Rotation
value also removes the list items from the Guide.
When the
Enabled property is unchecked, the Guide filler cannot enter data.
Only the following control types support the Enabled property: Text
Area, Text Input, Text Input Comb, Text Input Mask, and Text Input
Symbol.
Display RulesSpecifies the following display rules for the field:
- Displayed:
- Specifies whether the field is displayed in the Guide. If
the Guide is based on an data model (FML), selecting this option
displays the field. If the Guide is based on an XDP form, selecting
this option uses the field’s presence property
to determine visibility. When this option is not selected, the presence property
is ignored and the field does not appear in the Guide.
When
you bind a property in the Data Model view, specify the condition
that determines when the field appears in the Guide. If the Guide
is based on an XDP form and the resulting value is true, the field’s presence property
determines visibility. When the resulting value is false, the field’s presence property
is ignored and the field does not appear in the Guide.
- Read-only:
- Specifies that the current field is read-only and Guide fillers
cannot edit it. When you bind a property in the Data Model view,
specify the condition that determines when the field is read-only.
If the model or the panel that contains the field is set to read-only,
this option is unavailable.
- Required:
- Specifies that Guide fillers are required to fill the current
field. When you bind a property in the Data Model view, specify
the condition that determines when the field is required. If the
model or the panel that contains the field is set to required, this
option is unavailable.
Important: By default, all
objects set to display as radio buttons are automatically assigned
a value of false at run time. If you select the Required display
rule for the radio button, the automatic value satisfies the rule,
even if a user makes no selection. To ensure that users make valid
radio button selections, it is recommended that you add the appropriate
constraint to the corresponding model.
(See Develop
model-driven applications.)
EventsSpecifies
on which event to refresh the data for a particular object. Events
are associated with each control type and can trigger a property
to recalculate the associated expression.
If a property from
the model has the DisableAutoReCalc property set, the expression
executes only if it is associated with an event on a control. However, there
are situations where an expression that automatically recalculates
also must be associated with an event. For example, if an expression
returns the current stock price for the associated stock symbol,
you can retrigger it even though the symbol has not changed.
- onEnter: Refresh data:
- Executes the onEnter event when the specified item in the
Data Model view gains focus.
- onExit: Refresh data:
- Executes the onExit event when the specified field loses focus.
The onExit event executes even if the content of the field has not
changed.
- onChange: Refresh data:
- Executes the onChange event when the value of the specified
field changes and loses focus. It does not execute on every keystroke
in an editor field.
- onActivate: Refresh data:
- Executes the onActivate event when a field, such as a button
or a check box, is activated. With mouse operations, this action
is equivalent to a mouse click. However, either a mouse click or
a keyboard action, such as pressing the Space key, triggers the
event.
Field HelpSpecifies the Help contents that appears for the
selected field. You can format the text and add links to the contents.
If your field Help contains both images and text,
set both the image width and height to a maximum of 200 pixels to
avoid cropping the Help text. - Select font
type:
- Displays the font name for the selected text.
- Select font size :
- Displays the font size for the selected text.
- Bold :
- Applies or removes bold formatting to selected text.
- Italic :
- Applies or removes italic formatting to selected text.
- Underline :
- Applies or removes underline formatting to selected text.
- Color :
- Applies a color to the selected text. You can select a color
from the color picker or type the hexadecimal value for the color.
- Left align :
- Aligns text to the left.
- Center align :
- Aligns text to the center.
- Right align :
- Aligns text to the right.
- Spread justify :
- Justifies the text.
- Bullets :
- Creates a bulleted list.
- Remove rich content settings while retaining the text :
- Removes RTF but preserves the text. It also removes any image
that may have been associated with the field.
- Link to:
- Specifies the URL for a link. The URL can use an absolute
or a relative path. When the Guide filler clicks a link, the linked
content appears in a separate browser window.
- Show/Hide image settings :
- Shows or hides the following image settings:
- Image:
- Specifies the URL for an image file. You can specify a URL
to an image, or you can select an image file that is in your application.
To remove the URL for an image, click the Remove button.
Note: If
a text object includes an image, specify the width of the text object
to prevent overlapping.
Position: Specifies
the image position.
Width: Specifies the image width.
Horizontal pad: Specifies horizontal padding for the
image.
Height: Specifies the image height.
Vertical pad: Specifies vertical padding for the image.
Scaling: When selected, maintains the aspect ratio.
|
|
|
|
|