2 Attributes (14/29) - Volume 7B: XView Reference Manual [Book]

Skip to main content

Get full access to Volume 7B: XView Reference Manual and 60K+ other titles, with a free 10-day trial of O'Reilly.

There are also live events, courses curated by job role, and more.

Start your free trial

PANEL_BUSY

Sets a button’s or a drop target item’s busy state. While a button or drop target is busy, it will not ac-

cept further input (e.g., SELECT-down). By default, a button or Drop Target Item will be in the busy

state while in its notify procedure and be cleared upon exiting. The busy state can be maintained after

exiting the notify procedure by setting PANEL_BUSY to TRUE from within the notify procedure. Set-

ting PANEL_BUSY back to FALSE, at a later time, clears the button’s busy state. This attribute can also

be used for similar functionality in panel item extensions.

Argument: Bool

Default: Set to

FALSE prior to entering button’s or drop target’s notify procedure

Procs: get,set

Objects: Panel_button_item, Panel_item, Panel_drop_target_item

See Also: 7.9.1

PANEL_CARET_ITEM

Specifies the panel item that currently has the input focus.

Argument: Panel_item

Default: First item that can accept keyboard input

Procs: create, get, set

Objects: Panel

See Also: 7.15.1

PANEL_CHILD_CARET_ITEM

Specifies what embedded (child) panel item to set the keyboard focus to when the application sets

PANEL_CARET_ITEM

to the parent panel item. PANEL_CHILD_CARET_ITEM should be NULL, if there

are no embedded (child) panel items, or if the parent panel item itself can take the keyboard focus.

Argument: Panel_item

Default:

NULL

Procs: create, get, set

Objects: Panel_item with an embedded (child) panel item.

PANEL_CHOICE_COLOR

Specifies the foreground color index (argument 2) for the specified choice (argument 1).

Argument 1: int (choice index)

Argument 2: int (color_index)

Default: Panel foreground color

Procs: create,get,set

Objects: Panel_choice_item

Usage:

xv_set(pchoice, PANEL_CHOICE_COLOR, 1, RED, NULL);

See Also: 7.10.6, 21.5

PANEL_CHOICE_FONT

This attribute is for SunView compatibility. For more information, refer to the manual Converting

SunView Applications.

PANEL_CHOICE_FONTS

This attribute is for SunView compatibility. For more information, refer to the manual Converting

SunView Applications.

96 XView Reference Manual

PANEL_CHOICE_IMAGE

Specifies the image (argument 2) for the specified choice (argument 1).

Argument 1: int

Argument 2: server_image

Default: None

Procs: create, get, set

Objects: Panel_choice_item

See Also: 7.10.2

PANEL_CHOICE_IMAGES

Specifies the image for each of several choices.

Argument:

NULL-terminated list of Server_images

Default: NULL

Procs: create, set

Objects: Panel_choice_item

See Also: 7.10

PANEL_CHOICE_NCOLS

Specifies the number of columns to use in the layout of panel choices.

Argument: int

Default: 1 for vertical layout (

PANEL_LAYOUT)

Procs: create, get, set

Objects: Panel_choice_item

See Also: 7.10.1

PANEL_CHOICE_NROWS

Specifies the number of rows to use in the layout of panel choices.

Argument: int

Default: 1 for horizontal layout (

PANEL_LAYOUT)

Procs: create, get, set

Objects: Panel_choice_item

See Also: 7.10.1

PANEL_CHOICE_RECT

The rectangle that encloses the specified choice. The first argument is the index of the choice (0 =

first choice). This attribute is not valid for

PANEL_CHOICE_STACK objects.

Argument: int

Return Type: Rect *

Procs: get

Objects: Panel_choice_item

See Also: 7.10.7

PANEL_CHOICE_STRING

Specifies the string (argument 2) for the specified choice (argument 1). The string is copied when this

attribute is set.

Argument 1: int

Argument 2: char *

Default:

NULL

Procs: create, get, set

Objects: Panel_choice_item

See Also: 7.10

XView Attributes

XView Attributes 97

PANEL_CHOICE_STRINGS

Specifies the string for each choice. You must specify at least one choice. The least you can specify

is a single NULL-terminated string. The strings are copied when this attribute is set.

Argument:

NULL-terminated list of char *

Default: NULL

Procs: create, set

Objects: Panel_choice_item

See Also: 7.10, 25.2.1

PANEL_CHOICE_X

This attribute is for SunView compatibility. For more information, refer to the manual Converting

SunView Applications.

PANEL_CHOICE_XS

This attribute is for SunView compatibility. For more information, refer to the manual Converting

SunView Applications.

PANEL_CHOICE_Y

This attribute is for SunView compatibility. For more information, refer to the manual Converting

SunView Applications.

PANEL_CHOICE_YS

This attribute is for SunView compatibility. For more information, refer to the manual Converting

SunView Applications.

PANEL_CHOOSE_NONE

Allows scrolling lists or choice items to have no currently selected item. Not applicable if

PANEL_CHOOSE_ONE is FALSE.

Argument: Bool

Default:

TRUE

Procs: create, get, set

Objects: Panel_choice_item, Panel_list_item

See Also: 7.10.2

PANEL_CHOOSE_ONE

If

TRUE, creates an exclusive scrolling list or choice. If FALSE, creates a non-exclusive scrolling list

or choice.

PANEL_CHOOSE_ONE

is used as part of the PANEL_TOGGLE macro. When creating a

toggle, it is recommended that you use the macro instead of the attribute.

Argument: Bool

Default:

TRUE

Procs: create, get

Objects: Panel_choice_item, Panel_list_item

See Also: 7.11.3

PANEL_CLIENT_DATA

Specifies an arbitrary value to be attached to a panel or to individual panel items.

Argument: caddr_t

Default: None

Procs: create, get, set

Objects: Panel, Panel_item

See Also: 7.19.1

98 XView Reference Manual

PANEL_CURRENT_ITEM

Returns the handle of the currently active panel item. An item is considered current when there is a

mouse button down event pending on that item (for example, after a SELECT-down over a text scrol-

ling button, but before the corresponding SELECT-up). NULL implies no panel item is currently

active.

Argument: Panel_item

Procs: get

Objects: Panel

PANEL_DEFAULT_ITEM

Sets the default panel item in the panel or gets the handle of the default panel item. Only buttons are

valid as default items. Application programmers use this attribute to indicate the default button in a

popup frame. Then, using the DefaultAction key, usually RETURN, causes the default button to

be activated.

Argument: Panel_item

Default:

NULL

Procs: create, get, set

Objects: Panel

PANEL_DEFAULT_VALUE

Identifies the default choice in PANEL_CHOICE_STACK items.

Argument: int or unsigned

Default: First choice

Procs: create, get, set

Objects: Panel_choice_item

PANEL_DIRECTION

Identifies the horizontal or vertical orientation of a slider or gauge.

Argument: Panel_setting

Valid Values: {

PANEL_HORIZONTAL, PANEL_VERTICAL}

Default:

PANEL_HORIZONTAL

Procs: create, get, set

Objects: Panel_slider_item, Panel_gauge_item

See Also: 7.13

PANEL_DISPLAY_LEVEL

Specifies the number of choices to display. Values are one of

PANEL_ALL, PANEL_CURRENT, or

PANEL_NONE. PANEL_DISPLAY_LEVEL is used as part of the PANEL_CHOICE_STACK macro; it is

recommended that you use the macro instead of the attribute.

Argument: Panel_setting

Valid Values: {

PANEL_ALL, PANEL_CURRENT, PANEL_NONE}

Default: PANEL_ALL

Procs: create, get

Objects: Panel_choice_item

See Also: 7.10.1

XView Attributes

XView Attributes 99

PANEL_DISPLAY_ROWS

Number of rows to display in the multiline text field.

Argument: int

Default: 5

Procs: create,get,set

Objects: Panel_multiline_text_item

See Also: 7.17

PANEL_DROP_BUSY_GLYPH

Busy drop target glyph, as defined by drag and drop specification.

Argument: Server_image

Default: Use normal drop target glyph

Procs: create,get,set

Objects: Panel_drop_target_item

See Also: 7.18.1.2

PANEL_DROP_DND

Drag and drop object (DRAGDROP) associated with panel drop target item. The DRAGDROP object is

used to initiate a drag and drop operation. If no

PANEL_DROP_DND exists, then the panel Drop Target

Item does not support drags, and is termed an “empty” drop target (PANEL_DROP_FULL = FALSE).

Argument: Drag_drop

Default:

NULL

Procs: create,get,set

Objects: Panel_drop_target_item

See Also: 7.18.1.3

PANEL_DROP_FULL

If

TRUE

, then the drop target item has draggable data set on the PANEL_DROP_DND object’s selection

items. The normal glyph is displayed. Setting PANEL_DROP_FULL to TRUE when no

PANEL_DROP_DND is defined is not valid;

PANEL_DROP_FULL will remain FALSE. If FALSE, then no

draggable data is available (i.e., the drop target is empty). No glyph is displayed.

Argument: Bool

Default:

FALSE

Procs: create,get,set

Objects: Panel_drop_target_item

See Also: 7.18.1.3

PANEL_DROP_GLYPH

Normal drop target glyph, as defined by drag and drop package.

Argument: Server_image

Default: None

Procs: create,get,set

Objects: Panel_drop_target_item

See Also: 7.18.1.2

PANEL_DROP_HEIGHT

Dimensions of drag target box, in pixels, excluding border and margin.

Argument: int

Default: 16

Procs: create,get,set

Objects: Panel_drop_target_item

100 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.

Start your free trial

Don’t leave empty-handed

Get Mark Richards’s Software Architecture Patterns ebook to better understand how to design components—and how they should interact.

It’s yours, free.

Get it now

Cover of Software Architecture Patterns

Check it out now on O’Reilly

Dive in for free with a 10-day trial of the O’Reilly learning platform—then explore all the other resources our members count on to build skills and solve problems every day.

Start your free trial Become a member now