SUBTYPE attribute

The subtype of a widget.

Data type:

CHARACTER

Access:

Readable/Writeable

Applies to:

BROWSE widget (column), COMBO-BOX widget, FILL-IN widget, MENU-ITEM widget, Server object handle, X-document object handle, X-noderef object handle

This attribute is read-only for combo boxes, the server object handle, the X-document object handle, and the X-noderef object handle. You can set this attribute only before the widget is realized.

For menu items, the value of this attribute is either "NORMAL", "SKIP", or "RULE". "NORMAL" is the default—a menu item that can be chosen, a toggle-box item, or read-only text. (In this case the READ-ONLY and TOGGLE-BOX attributes determine the specific type of the menu item.) "SKIP" specifies a blank line in the menu. "RULE" specifies a visible horizontal line in the menu.

For combo boxes, the value of this attribute is either "SIMPLE", "DROP-DOWN", or "DROP-DOWN-LIST". The DROP-DOWN-LIST subtype is the default. The SIMPLE and DROP-DOWN subtypes apply only to character-field or character-variable combo-box widgets in graphical interfaces only, and only in Windows. If you set the subtype of a combo-box widget to "SIMPLE" or "DROP-DOWN" in a character interface, the AVM treats the combo-box widget as having the "DROP-DOWN-LIST" subtype.

For browses, this attribute applies only to combo-box browse columns.

For fill-ins, the value of this attribute is either "PROGRESS" or "NATIVE". "PROGRESS" is the default. If set to "PROGRESS", the fill-in widget has the behavior of a standard ABL field in character mode. Otherwise, the field has the behavior of a fill-in that is native to the current graphical environment. The NATIVE option of the VIEW-AS phrase specifies that the field adhere to the native behavior of the current window system or environment.

For the X-document object handle or X-noderef object handle, this attribute returns the name of the object type (character representation of the DOM NodeType), which will be one of the following: "ATTRIBUTE", "CDATA-SECTION", "COMMENT", "DOCUMENT", "DOCUMENT-FRAGMENT", "ELEMENT", "ENTITY-REFERENCE", "PROCESSING-INSTRUCTION", or "TEXT".

For the server object handle, this attribute identifies the type of server to which the server object is bound. This is either an AppServer or a Web service. This attribute is set during the execution of the CONNECT( ) method and can be one of three values. Before you invoke the CONNECT( ) method, the attribute value is set to the Unknown value (?). Once you invoke the CONNECT( ) method, the attribute value is set to either "APPSERVER" for an AppServer or "WEBSERVICE" for a Web service.