Gets or sets the style of the Subfile from a member of the SubfileStyles enumeration that specifies the HTML element used for the subfile data; Classic, Checkboxes, DropDown, ListBox, and RadioButtons.
Syntax
BegProp SubfileStyle Access(*Public) Type(SubfileStyles) BegGet; BegSet
Property Values
SubfileStyles that specifies the HTML element used for the subfile data; Classic, Checkboxes, DropDown, ListBox, and RadioButtons.
Remarks
The default subfile style is Classic, which functions the same as subfiles in AVR Classic.
To set this property at design-time, click on the arrow to the right of the SubfileStyle property and select one of the options from the drop-down box.
A subfile is typically rendered in a classic tabular format with each record in the subfile providing the data for a row and field shown as a column. However, it is possible to render a subfile records as a sequence of checkboxes, radio buttons, in a drop-down box, or a list box. This property determines the widget(s) to use for rendering the subfile. If a style other than Classic is selected, the subfile record must have at least three fields where the first three fields must have the following format:
| Field | Type | Notes |
|---|---|---|
| Control | Numeric | Determines which button is selected. 0 = not selected, 1 = selected. |
| Value | Any | Used to help the program distinguish this record from other records. |
| Text | Any | Displayed in the browser. Used to help the user distinguish this record from other records. |
The order of the three fields is significant and is determined by the sequence in how they are ordered in the markup file and not in the screen (top, left) position. The name of the fields is not important; neither are the details of their types, as long as the Control field is of numeric type.
Besides the classic style, the SubfileStyle permits selecting one of the following styles: CheckBoxes, Dropdown, Listbox, RadioButtons
Checkboxes
The Dropdown style displays each record on the subfile as a checkbox with the Text as the checkbox's text. Multiple checkboxes can be selected. If a record's Control field is set to 1, then it is considered selected, otherwise it is not. The user can modify the selected state of each record and the Control field will be updated accordingly; READC will return all records modified.
Listbox
A style of Listbox displays every record of the subfile as an element of a listbox. Only one element can be selected, the first one found to have its Control field set to 1. The user can change the selection, in this case READC will return the new record selected and the old record that was de-selected.
Radio Buttons
The RadioButtons style is similar to the Checkboxes style, the difference between the two styles lies in that RadioButtons permit the user to only select one of the records of the subfile.
Requirements
Namespace: ASNA.Monarch.WebDspF
Assembly: ASNA.Monarch.WebDspF.DLL
Platforms: Windows Server 2012, Windows Server 2012 R2, Windows Server 2016, Windows 7, Windows 8 Pro, Windows 10 Pro