Adding Extended Attributes and Other Controls to Your Form

You insert controls into your form using the tools in the Form tab toolbar.

You can reorder controls in the form control tree by dragging and dropping them. To place a control inside a container control (group box or horizontal or vertical layout), drop it onto the container. For example, if you want the extended attributes GUID, InputGUID, and OutputGUID to be displayed in a GUI group box, you should create a group box, name it GUI and drag and drop all three extended attributes under the GUI group box.

Tool

Description

Add Group Box - inserts a group box, intended to contain other controls within a named box.


Tool - Add Tab Window

Add Tab Window - inserts a sub-tab layout, in which each child control appears, by default, in its own sub-tab. To place multiple controls on a single sub-tab, use a horizontal or vertical layout.

Add Horizontal Layout - inserts a horizontal layout. To arrange controls to display side by side, drag them onto the horizontal layout in the list.

Add Vertical Layout - inserts a vertical layout. To arrange attributes to display one under the other, drag them onto the vertical layout in the list. Vertical layouts are often used in conjunction with a horizontal layout, to provide columns of controls.



Include Another Form - inserts a form defined on this or another metaclass in the present form (see Example: Including a Form in a Form).

Add Attribute – opens a selection box in which you select standard or extended attributes belonging to the metaclass. Select one or more attributes and then click OK to insert them into the form.

The type of control associated with the attribute depends on its type: booleans are associated with check boxes, lists with combo boxes, text fields with multi-line edit boxes, and so on.

Unless you enter a label, the attribute name is used as its form label, and any comment that you have entered is displayed as its tooltip.

Add Collection – opens a selection box in which you select standard collections belonging to the metaclass. Select one or more collections and then click OK to insert them into the form.

Collections are displayed as standard grids with all the appropriate tools.

Unless you enter a label, the collection name is used as its form label and any comment that you have entered is displayed as its tooltip.

Add Method Push Button - opens a selection box in which you select one or more methods, which will be associated with the form via form buttons. This list is limited to methods defined under the same metaclass in the profile. Select one or more methods and then click OK to insert them into the form.

Each method is displayed as a button on the form that, when clicked, invokes the method. Unless you enter a label, the method name is used as the button label. Any comment that you have entered for the method is displayed as its tooltip in the form.

Add Edit Field [dialog boxes only] inserts an edit field.

Add Multi-Line Edit Field [dialog boxes only] - inserts a multi-line edit field below the selected item in the tree.

Add Combo Box [dialog boxes only] - inserts a combo box.

Add List Box [dialog boxes only] - inserts a list box.

Add Check Box [dialog boxes only] - inserts a check box.

Add Text - inserts a text control.

Add Separator Line – inserts a separator line. The line is vertical when its parent control is a vertical layout.

Add Spacer – inserts an area of blank space.

Delete – deletes the currently selected control.