Volume 7B: XView Reference Manual

PANEL_ITEM_X_POSITION

The default x coordinate of the panel item.

Warning: This attribute should only be used from within a panel item extension.

Argument: int

Procs: get,set

Objects: Panel

PANEL_ITEM_Y

Specifies the y position (in pixels) where the last panel item was created. If no item was created, then

it specifies the y position where the first item will be created.

Argument: int

Default: None

Procs: get

Objects: Panel

See Also: 7.4.2

PANEL_ITEM_Y_GAP

When set on a panel, this is the vertical space, in pixels, between the last panel item created and the

next panel item when set on a panel item,

PANEL_ITEM_Y_GAP is the vertical space, in pixels, be-

tween the last panel item created and this panel item. This attribute allows applications to more easily

use relative item positioning instead of absolute positioning. Relative item positioning is the recom-

mended method of positioning panel items, since the size of items may change between invocations

(e.g., different scales) or versions of the toolkit.

Argument: int

Default: 13 for panel, the panel’s

PANEL_ITEM_Y_GAP for panel item

Procs: create,get,set for panel; create,get for panel item

Objects: Panel, Panel_item

See Also: 7.3.1

PANEL_ITEM_Y_POSITION

The default y coordinate of the panel item.

Warning: This attribute should only be used from within a panel item extension.

Argument: int

Procs: get,set

Objects: Panel

PANEL_JUMP_DELTA

Specifies the number of client units to adjust the value when a JumpLeft or JumpRight keyboard

command is issued for a horizontal slider. Also specifies the number of client units to adjust the value

when a JumpUp or JumpDown keyboard command is issued for a vertical slider or numeric text item.

Used in conjunction with the OPEN LOOK Mouseless Model.

Argument: int

Default: 10

Procs: create,get,set

Objects: Panel_slider_item,Panel_numeric_text_item

106 XView Reference Manual

PANEL_LABEL_BOLD

If TRUE, PANEL_MESSAGE_ITEM’s label is rendered in bold.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Panel_message_item

See Also: 7.12

PANEL_LABEL_FONT

Defines the font to use in the label portion of a panel item.

Warning: Use of this attribute may cause your application to violate the OPENLOOK Graphical User

Interface Functional Specification.

Argument: Xv_Font

Default: Panel font

Procs: create,get,set

Objects: Panel_item

PANEL_LABEL_IMAGE

Specifies the image for an item’s label.

Argument: Server_image

Default:

NULL

Procs: create, get, set

Objects: Panel_item

See Also: 15.4.1

PANEL_LABEL_STRING

Specifies the string for the item’s label. The string is copied when this attribute is set. By using \n,

newlines can be placed into the strings to generate multi-line labels.

Argument: char *

Default: ""

Procs: create, get, set

Objects: Panel_item

Usage:

xv_create(panel, PANEL_TEXT,

PANEL_LABEL_STRING, "Multi\nLine\nLabel:",

NULL);

See Also: 7.9, 7.3.2

PANEL_LABEL_WIDTH

Specifies the width of the panel item label in pixels. For buttons, PANEL_LABEL_WIDTH does not in-

clude endcaps and menu marks (if any are present).

PANEL_LABEL_WIDTH has no effect on a panel

button until the panel button’s

PANEL_LABEL_STRING or PANEL_LABEL_IMAGE is set.

Argument: int

Default: Width of text string or server image

Procs: create, get, set

Objects: Panel_item

See Also: 7.9.3

XView Attributes

XView Attributes 107

PANEL_LABEL_X

Specifies the x coordinate of the label portion of panel items that have values associated with them

(e.g., text items). Intended to be used when PANEL_VALUE_X is specified.

Argument: int (in pixels)

Default:

PANEL_ITEM_X from parent panel

Procs: create, get, set

Objects: Panel_item

See Also: PANEL_VALUE_X

PANEL_LABEL_Y

Specifies the y coordinate of the label portion of panel items that have values associated with them

(e.g., text items). Intended to be used only if PANEL_VALUE_Y is specified.

Argument: int (in pixels)

Default:

PANEL_ITEM_Y from parent panel

Procs: create, get, set

Objects: Panel_item

See Also:

PANEL_VALUE_Y

PANEL_LAYOUT

In a PANEL create call, this attribute controls the layout of panel items. When used in a create panel

item call, this attribute controls the direction in which the item’s components are laid out.

Argument: Panel_setting

Default:

PANEL_HORIZONTAL

Procs: create, get, set

Objects: Panel, Panel_item

See Also: 7.3.1

PANEL_LINE_BREAK_ACTION

At the end of each line, wrap to the next line at either the character (

PANEL_WRAP_AT_CHAR) or word

(PANEL_WRAP_AT_WORD) level.

Argument: Panel_setting

Valid values: {

PANEL_WRAP_AT_CHAR, PANEL_WRAP_AT_WORD}

Default: value of “text.lineBreak” default, or PANEL_WRAP_AT_WORD

Procs: create,get,set

Objects: Panel_multiline_text_item

See Also: 7.17

PANEL_LIST_CLIENT_DATA

Sets or gets up to 32 bits of user-entered data (argument 2) from a row number (argument 1) on the

list.

Argument 1: int

Argument 2: Xv_opaque

Default:

NULL

Procs: create, get, set

Objects: Panel_list_item

See Also: 7.11.4.1

108 XView Reference Manual

PANEL_LIST_CLIENT_DATAS

Works much like its companion attribute, PANEL_LIST_CLIENT_DATA, except that it takes a NULL-

terminated value list of client data as its value. Position in the value list determines the row to which

the data will be associated.

Argument:

NULL-terminated list of Xv_opaque

Default: NULL

Procs: create, set

Objects: Panel_list_item

See Also: 7.11.4.1

PANEL_LIST_DELETE

Deletes a row from the scrolling list. The list is adjusted automatically after the deletion.

Argument: int (row number)

Default: None

Procs: create, set

Objects: Panel_list_item

See Also: 7.11.2

PANEL_LIST_DELETE_INACTIVE_ROWS

Deletes all inactive rows from the list. Similar to the PANEL_LIST_DELETE_SELECTED_ROWS attri-

bute.

Argument: No argument

Procs: set

Objects: Panel_list_item

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

PANEL_LIST_DELETE_ROWS

Deletes the specified number of rows, starting at the specified row. The first argument is the row

number, and the second argument is the number of rows to delete.

Argument 1: int

Argument 2: int

Procs: create,set

Objects: Panel_list_item

See Also: 7.11.2

PANEL_LIST_DELETE_SELECTED_ROWS

Deletes all selected rows. Not valid in edit mode.

Argument: No value

Procs: set

Objects: Panel_list_item

See Also: 7.11.2

PANEL_LIST_DISPLAY_ROWS

Sets the number of rows in a list that will be displayed. This may not be set to less than three for a

FILE_LIST

.

Argument: int

Default: The number of items in the xv_create() call, up to a maximum of 5.

For a

FILE_LIST

the default is 10.

Procs: create, get, set

Objects: Panel_list_item, File_list

See Also: 7.11.1

XView Attributes

XView Attributes 109

PANEL_LIST_DO_DBL_CLICK

Tells PANEL_LIST to interpret two select events that occur within the timeout value as a double-click

instead of as a second select or a deselect (depending on the current mode of the list). The timeout

value is specified with OpenWindows.MulticlickTimeout. If true, the PANEL_LIST will deliv-

er a new op called PANEL_LIST_OP_DBL_CLICK instead of the normal PANEL_LIST_

OP_SELECT or PANEL_LIST_OP_DESELECT.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Panel_list_item

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

PANEL_LIST_EXTENSION_DATA

Same as PANEL_LIST_CLIENT_DATA, except that it is reserved for package implementors. This is

used by the

FILE_LIST package.

PANEL_LIST_EXTENSION_DATAS

Same as PANEL_LIST_CLIENT_DATAS, except that it is reserved for package implementors. This is

used by the

FILE_LIST package.

PANEL_LIST_FIRST_SELECTED

Returns the row number of the first selected row. If no row is selected, it returns -1.

Return Type: int

Argument: No argument

Procs: get

Objects: Panel_list_item

See Also: 7.11.3

PANEL_LIST_FONT

Set the specified row (argument 1) to the specified font (argument 2). Note that the font specification

using

PANEL_LIST_FONT should follow the creation of the row (using PANEL_LIST_STRINGS).

Argument 1: int (row number)

Argument 2: Xv_Font

Default: Use panel font

Procs: create,get,set

Objects: Panel_list_item

See Also: 7.11.1

PANEL_LIST_FONTS

Set the first n rows to the specified fonts. Note that fonts specified using

PANEL_LIST_FONT should

follow the creation of the rows (using

PANEL_LIST_STRINGS).

Argument:

NULL-terminated list of Xv_Font

Default: Use panel font

Procs: create,set

Objects: Panel_list_item

See Also: 7.11.1

110 XView Reference Manual