1.41.2 Instance variables

dialog_item <- above: graphical*

Dialog-item immediately above me.

Defaults: @nil (no item is above me)

See also

dialog->layout

graphical <- active: bool

Determines whether the item is sensitive for user-events. If @off, the item's image is greyed-out by anding it with a grey pattern.

Defaults: @on (active).

dialog_item <-> alignment: {column,left,center,right}

Determines how the dialog is fitted in the two-dimensional space of the dialog window by dialog->layout. The values are:

column

Align the item below the upper-neighbour

left

Place the item immediately right of its left-neighbour. (left means flush-left).

center

Place centered items adjacent and centered in the available horizontal space.

right

Flush the item to the right of the available horizontal space.

For example, button objects in OpenWindow dialog windows should be centered. Setting button.alignment to center will properly align buttons for OpenWindow look-and-feel.

dialog_item <-> auto_label_align: bool

Align the width of the label automatically with the labels of the items in the same column.

Defaults: @on (align labels in the same row).

See also

- dialog_item-label_width
- dialog->layout

dialog_item <-> auto_value_align: bool

Automatically align the width of the values. Currently applicable to menu's only, where it refers to the width of the entries in the menu.

Defaults: @on (do align values)

See also

- menu-value_width
- class menu
- dialog->layout

dialog_item <- below: graphical*

Dialog item immediately below me.

See also

dialog->layout

dialog_item <- label: char_array|image*

Label of the item. For most items, the label is displayed in the label_font and indicates the function of the item.

Defaults: The provided name (first initialisation argument) is capitalised to provide the initial label.

See also

menu->initialise

dialog_item <- label_format: {left,center,right}

Determines how labels of dialog objects aligned in a vertical column are aligned by dialog->layout. dialog->layout first determines the widest label, after which it requests all dialog items to make their label equally wide. This parameter determines how a small label is aligned in a wider box.

See also dialog_item.label_suffix.

dialog_item-label_width: [int]

The width of the area in which the label is displayed. Used to implement automatic alignment of labels of items displayed in a vertical row. See also dialog->layout.

See also

- dialog_item-auto_label_align
- dialog->layout

dialog_item <- left: graphical*

Item immediately to the left.

See also

dialog->layout

dialog_item <- look: {open_look,motif,win,gtk}

General look-and-feel switch. The interpretation is left to the subclasses. See also scroll_bar<->look.

XPCE is shipped with Defaults both to generate OpenLook style (Unix/X11) or Windows-95 style (Win32).

dialog_item <-> message: [code]*

Message executed when the item is executed. The conditions on which the execution takes place as well as the arguments forwarded are determined by the specific type of item.

See also

- menu->initialise
- dialog_item-execute_event

dialog_item <-> popup: popup*

Popup menu associated with the item.

See also

class popup

dialog_item -> reference: [point]

Reference point for alignment in two-dimensional grid. When to items are aligned horizontally or vertically, dialog->layout aligns the graphical<-x or graphical<-y component of their reference points.

The get-method returns the value of the variable when filled and fails otherwise. This method is redefined by most dialog-item subclasses (button<-reference, text_item<-reference, etc.).

Invoking dialog_item->reference: @default will make the item return its class-defined default. Invoking this method with an instance of class point will explicitly set the reference-point.

dialog_item <- right: graphical*

Item immediately to the right.

dialog_item <- status: {inactive,active,preview,execute}

The status variable describes the current status with regard to processing user-events. The values are:

inactive

Default initial value

active

In focus of events; the item may indicate so.

preview

Indicates releasing the button now will start execution

execute

Indicates the dialog_item<->message is currently executing

Defaults: inactive

See also

- dialog_item-execute_event
- dialog_item-cancel_event
- dialog_item-release_event_focus
- dialog_item-preview_event
- dialog_item-obtain_event_focus