ASNA WingsRPG™ Reference Manual

ASNA Wings™ Subfile Properties

The following properties have been added to, and allow customization of the appearance and function of subfiles in Wings pages. There is a full list of the Subfile properties in this MonarchFX help topic, and a similar list of the Subfile Control properties in this topic.

DdsSubfileControl

Name Data Type Description Default Value (when property is not defined) Default Migration
CueCurrentRecord boolean

If "true", the subfile's current record will be highlighted by a style change. When the mouse hovers over the subfile, the background of the row under the mouse pointer will change styles. If the user navigates elsewhere in the subfile using the keyboard (Tab key), then the current record is set by the row the active field is on, and the cueing ceases to be shown (instead the "current record" visual is shown).

To customize the style of the visual cue, change the CSS style: .DdsSubfileCandidateCurrentRecord		 "false" "true" except for Message Subfile Control record.
ClickSetsCurrentRecord boolean

If "true", a mouse (left) click will change the current record to the one under the mouse pointer, visually indicated by a highlight on the row. If the user navigates elsewhere in the subfile using the keyboard (Tab key), then the current record is set to the row the active field is on.

To customize the style of the visual highlight, change the CSS style: .DdsSubfileCurrentRecord		 "false" "true" except for Message Subfile Control record.
DblClickTargetField string The name of the field to be modified when double-click is detected. empty Not generated.
DblClickTargetValue string The value that the target field is to be set to. (Requires the DblClickTargetField to contain a valid field name, of fields in the corresponding record). empty "true" except for Message Subfile Control record.
DblClickKey string Optionally, if this value is not empty, the Key will be "pushed" (and the Page will be submitted). empty Not generated.
VerticalScrollBar boolean Shows a vertical scrollbar to the right of the subfile.
Note: This increases the subfile width by 19 pixels. 		"false" Not generated.

DdsSubfile

Name Data Type Description Default Value (when property is not defined) Default Migration
VirtualRowCol row, col Upper-Left corner of the Subfile screen area, as defined by DDS. empty row, col from DDS
VirtualWidth integer Horizontal positions occupied by fields in a subfile record (as described by DDS). 0 Computed (max pos - min pos) as DDS subfile record fields are found in DDS.
VirtualRowsPerRecord integer Vertical positions occupied by fields in a subfile record (as described by DDS). 1 Computed (max pos - min pos) as DDS subfile record fields are found in DDS.

CSS Styles

Two new styles have been added to Themes.css specifically to tailor the appearance of subfiles.

Name Description Comments
.DdsSubfileCandidateCurrentRecord Style to be applied to Subfile row while the mouse hovers over the subfile (if DdsSubfileControl's property CueCurrentRecord is set to "true"). The default changes the background color to a shade of light blue color, and makes the corners rounded.
.DdsSubfileCurrentRecord Style to be applied to Subfile row that is currently selected (via mouse-click or by tabbing over input capable fields on different records of the subfile). The default changes the background color to a darker blue, to contrast with the "candidate" current record style. The corners of the DIV are rounded.

Scrollbar Styles

Three styles define the look of the vertical scrollbar (also added to Themes.css).

Name Description Comments
.DdsSubfileSBar Defines the background image to be used to give the sunken effect of the tracking area. (Image repeats vertically, to adapt to the height of the scrollbar). Currently defined as a PNG image with 19 pixels width. Change it to match your website Theme colors.
.DdsSubfileSBarUp Defines the Up arrow image to be used as background. Currently defined as a PNG image with 19 x 19 pixels. Change it to match your website Theme colors.
.DdsSubfileSBarDn Defines the Down arrow image to be used as background. Currently defined as a PNG image with 19 x 19 pixels. Change it to match your website Theme colors.