Common Desktop Environment: Application Builder User's Guide

Property Editor: Common Properties

The following properties are common to three or more property editors.

Border Frame

Determines the type of border, if any, around certain objects. Choices are None, Shadow Out, Shadow In, Etched Out, and Etched In.

Geometry

Indicates the X and Y location of the selected object, and the W(idth) and H(eight) of the object. X and Y values specify the position of the selected object in relation to its parent. The values are in pixels and are measured from the top-left corner of the parent object to the top-left corner of the child object. W and H values are in pixels.

Graphic Filename

Indicates the name of the pixmap (.pm) or bitmap (.bm) file that contains the graphic to be used as the label for the selected object or item. This property is available only if Label Type or Item Label Type is "Graphic."

Item Label Type

Specifies the type of label (String or Graphic) for the selected item in the Items list. If Graphic is chosen, "Label" becomes "Graphic Filename."

Item State, Active

Specifies whether the selected item will be active when the compiled application is opened.

Items

Lists the labels that represent the items in the list. When an item is selected in the Items list, its label is displayed in the Label or Graphic Filename field.

Label (Object/Item)

Specifies the label for the selected object or item. "Label" becomes "Graphic Filename" if Graphic Label Type is chosen. Label is inactive in the Button property editor if Arrow Label Type is chosen.

Label Type

Specifies the type of label (String, Graphic, or Arrow) for the selected object. If Graphic is chosen, "Label" becomes "Graphic Filename." If you choose Arrow, the label in the Button property editor becomes an arrow and the Arrow Direction property becomes active.

Menu Title

Specifies the (optional) title of the pop-up menu, if any.

Popup, Pulldown Menu

A menu button and a text field for creating, attaching, de-attaching, or editing a pop-up or pull-down menu for the selected object. When the Menus button is clicked, a menu with four choices (None, Create New Menu, Menus, Edit Current) is displayed. Menus and Edit Current are inactive if no menus exist in the current project. If a menu is already attached to the selected object, the menu name will be displayed in the text field.

Position (Label)

Specifies the position (Left or Above) of the label in relation to the selected object. This Position option menu is next to the Label Type option menu.

Position [XY]

Indicates the X and Y location of the selected object in relation to its parent. The values are in pixels and are measured from the top-left corner of the parent object to the top-left corner of the child object.

Scrollbars

Specifies when scroll bars should be attached to the selected pane. The choices are Never and Always for a term pane or a text pane, and Never, When Needed, and Always for a draw area pane.

Size

Specifies the absolute W(idth) and H(eight) of the window or pane. These values change if you resize the window or pane manually in the interface. For a term pane or a text pane, there is an option menu for choosing Characters or Pixels as the unit value.

Size Policy

Specifies whether the selected object should retain a fixed size or if it should become bigger or smaller depending on the contents of the object. The choices are Size of Label and Fixed for buttons and labels, Fit Contents and Fixed for main windows and custom dialogs.


Note -

List item editing: once you have the appropriate number of items in the list, the easiest way to perform item editing in those property editors that have an item list* is to select the first item in the list, thus selecting it in the label text field. Type a new name for the item and click Return. The new name will be displayed in the item list and the next item in the list will be selected. Continue down the list with this select, type, Return sequence until all items are completed. * Property editors with item lists include the choice objects (Radio Box, Check Box, Option Menu), Combo Box, List, Menu, Menubar, and Spin Box.