Generic Panel Item Arguments

Some panel items are composed of two parts: a label and a value. The position of an item also determines the label position. The value part follows the label and is either to the right or below the label. Message and button items have only the label part.

W_PANEL_X

Sets or gets the X coordinate (pixels) of the upper left corner of a panel item.

W_PANEL_Y

Sets or gets the Y coordinate (pixels) of the upper left corner of a panel item.

W_PANEL_ROW

Sets the Y coordinate (measured in text rows) of the upper left corner. The height of a row is determined by the font size. Margins are also counted to determine the final position.

W_PANEL_COL

Sets the X coordinate (measured in text columns) of the upper left corner. The width of a column is determined by the font size. Margins are also taken into account.

W_PANEL_FONT

Set the id number of the font that is used for the value part. It should not be necessary to control fonts with this setting. Instead you should use defaults and the X resource database.

W_PANEL_LAYOUT

Set the layout style for a label. The value is either W_LAYOUT_HORIZONTAL (default) or W_LAYOUT_VERTICAL. Value W_LAYOUT_CENTER can be used to center items in a horizontal zone. The position of items relative to each other is not changed but the whole zone is centered with respect to the panel. This is useful to get a row of buttons centered.

W_PANEL_LABEL

Sets or gets the label string. For buttons use W_PANEL_BUTTONIMAGE to convert label string to image.

W_PANEL_LABELFONT

Sets the id number of the font that is used for the label part. It is rarely necessary to control fonts from the layout commands. Instead you should use defaults and the X resource database.

W_PANEL_FONTBBOX

The panel argument W_PANEL_FONTBBOX can be used to get the dimensions of maximum bounds of a font used in a panel item. Value received is: width*1024 + height. This finds use especially if the application wants to place message items so that they do not "waste" too much vertical space. Using positioning by rows is very "spacious" especially for message items. Example of use can be found in the script %PMS_HOME%/dm/macro/ChooseAction.mac

W_PANEL_LABELIMAGE

Searches a bitmap file from directories given in the bitmap path, and uses the resulting bitmap as a label icon.

W_PANEL_CALLBACK

Sets the flag that enables an item to report events. By default this flag is not set.

W_PANEL_SHOW

Sets or gets the visibility status. Value 1 makes an item visible and 0 makes it invisible.

W_PANEL_SENSITIVITY

Sets the sensitivity of buttons, choices, or toggles. Value 1 makes an item selectable; 0 means ignores button presses. A button in the insensitive state is grayed out to show the user that he cannot interact with the item.

W_PANEL_VALUE

Sets or gets the value of a W_PANEL_FILL or W_PANEL_TOGGLE type panel item. For choices can only be used to get the string of the currently selected choice item. Ignored for other items. For toggles this is a string of digits (one per toggle) where '1' marks the corresponding item as selected; '0' as not selected.

W_PANEL_KBDFOCUS

Sets the keyboard focus to a panel item. You can use any value for this argument.

W_PANEL_TIP

Sets the ToolTip text for a panel item.