A style definition defines a set of style elements
that can be applied to the Agentry
Client user interface to affect its appearance. These elements
include text and background colors, font face and size, borders,
and other similar UI items. A style may be defined for all
supported application platforms or for a single
the developer to create display styles for screens, buttons, text,
fields and list controls. A style is defined as a collection of
display elements combined to provide an overall look and feel to
Styles exist at the application level in
a project. They are then available to be used, or “applied” at the application,
module, platform, screen and control levels. Each attribute, or
“style element” of a style definition may be set to a specific value
or default. Default results in the system default being used for
that aspect of the user interface.
If styles are applied at
multiple levels within the application they are merged at run time
before being applied to the user interface. The style definition
applied at a lower level in the application hierarchy will override
the settings of a style applied at a higher level. If the lower
level style has an element set to default, the setting for that
same element in the higher level style definition will be used.
This merge then results in the overall appearance of the user interface
component to which the style is applied.
A style may defined
for a specific platform. Multiple styles may be defined with the
same name but with different platform selections. When a style is
applied to the user interface, only the name is referenced. At run
time, a given client device type will receive only the styles with
a matching platform. This is optional behavior and a style may defined
for all platforms.
iPhone and iPad/iPod Touch Platform Note
to the nature of the iOS devices, the current style support for
these device platforms is limited to the specification of the Font
Face and the Foreground Color. Styles can only be applied to specific
controls and the affects of the two supported style attributes are
the font in which text is displayed and the color of that text.
Following is a list of
the attributes for a style definition. In the context of a style
definition these attributes are commonly referred to as “style elements”
and the terms are interchangeable:
- Foreground Color: This
attribute specifies the color of any text displayed on the user
interface component to which the style is applied. If a particular
user interface component has no text, the Foreground Color setting
will have no affect on its appearance.
- Background Color: This attribute specifies the color
of the background of the user interface component. The background
of a screen or control is the area that contains no controls, text,
or list items.
- Font Face: This attribute specifies the font used to
display any text on the user interface to which the style is applied.
Within the Agentry
the Font Face attribute field contains a drop-down list.
Its contents will be any fonts installed on the host system of the
Editor. The name of a font may also be manually entered if it is
one that is known to be available on the client devices, even if
it is not available on the Editor’s host system. Any font face entered
manually in the list will be available in this same list for all
style definitions within the application. If a font name is entered that
is not available on a client device, the behavior will be the same
as if Default had been selected for the Font Face attribute.
- Point Size: This attribute specifies the size of the
text displayed to the user. If the point size is larger than the
viewable area given to that text value, that viewable area will
not be increased in size.
- Font Style: This attribute specifies whether the text
is displayed normally (referred to as the regular font style), or
in bold, italics, or bold italics. The Font Style attribute may
not have an effect on the appearance of the text based on the selected
Font Face. Certain fonts are inherently bold or italicized, or may
not support either behavior.
- Underline: This attribute specifies whether the text
is underlined. This attribute may have no effect on certain Font
Face selections, as the selected font may not support underline
or may be inherently underlined.
- Border Style: This attribute controls how the border
around certain UI components will appear. This includes detail screen
fields and buttons. The border style can be None, Flat, or 3-D.
- Text Alignment - Horizontal Alignment: This attribute
specifies the alignment of the text displayed by the UI component
to which the style is applied. The options are:
- “Align Left”
- This selection specifies that the text is to be aligned to the
left of the viewable area allotted for the text being displayed.
- “Align Right” - This selection specifies that the text is to
be aligned to the right of the viewable area allotted for the text
- “Center” - This selection horizontally centers the text within
the viewable area allotted for the text being displayed.
- “Default” - This selection will horizontally align the text
according to the default behavior of the item containing the text.