![](/api/v2/epubs/9780937175880/files/bg60.png)
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
![](/api/v2/epubs/9780937175880/files/bg91.png)
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
![](/api/v2/epubs/9780937175880/files/bg60.png)
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
![](/api/v2/epubs/9780937175880/files/bg91.png)
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
![](/api/v2/epubs/9780937175880/files/bg60.png)
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
Get Volume 7B: XView Reference Manual now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.