Volume 7B: XView Reference Manual

PANEL_DROP_SEL_REQ

Selection requestor object (SELECTION_REQUESTOR) associated with the panel drop target item. The

Selection_requestor object is used to receive a drop.

Argument: Selection_requestor

Procs: get

Objects: Panel_drop_target_item

See Also: 7.18.1.4

PANEL_DROP_SITE_DEFAULT

Specifies whether or not the panel drop target’s drop site is the default drop site. Only one panel drop

target in a frame may be the default drop target. See

DROP_SITE_DEFAULT attribute for more infor-

mation.

Argument: Bool

Default:

FALSE

Procs: create,get,set

Objects: Panel_drop_target_item

PANEL_DROP_WIDTH

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

Argument: int

Default: 12

Procs: create,get,set

Objects: Panel_drop_target_item

PANEL_EVENT_PROC

Event handler for panel items.

Argument: void (*panel_event_proc)()

Default: Panel_item specific.

Procs: create,get,set

Objects: Panel_item

Callback:

void

panel_event_proc(item, event)

Panel_item item

Event *event

Client-specified event-handling procedure for handling events on panel items. This pro-

cedure is installed using

PANEL_EVENT_PROC.

See Also: 7.19.7

PANEL_EXTRA_PAINT_HEIGHT

Defines the increment by which the panel grows in the y direction. It is used when

window_fit_height() is called.

Argument: int

Default: 1 pixel

Procs: create, get, set

Objects: Panel

See Also: 7.5

XView Attributes

XView Attributes 101

PANEL_EXTRA_PAINT_WIDTH

Defines the increment by which the panel grows in the x direction. It is used when

window_fit_width() is called.

Argument: int

Default: 1 pixel

Procs: create, get, set

Objects: Panel

See Also: 7.5

PANEL_FEEDBACK

Specifies feedback to give when an item is selected. If PANEL_DISPLAY_LEVEL is PANEL_ CUR-

RENT, the default value is PANEL_NONE; otherwise, it is PANEL_MARKED. PANEL_FEED_BACK is used

as part of the PANEL_CHECK_BOX macro. It is recommended that you use the macro instead of the at-

tribute.

Argument: Panel_setting

Default: See description

Procs: create, get, set

Objects: Panel_choice_item

PANEL_FIRST_ITEM

Gets the handle of the first item on a panel. The PANEL_EACH_ITEM macro (see Section 3, Proce-

dures and Macros) can be used to iterate over each item in a panel, starting with this first item.

Argument: Panel_item

Procs: get

Objects: Panel

See Also: 7.7

PANEL_FIRST_PAINT_WINDOW

Returns a pointer to the first Panel_paint_window struct, which defines the paint window and

view window associated with the first view in the scrollable panel.

Argument: Panel_paint_window *

Procs: get

Objects: Scrollable_panel

PANEL_FOCUS_PW

The paint window which currently has or last had the input focus. The has_input_focus

Panel_status flag indicates whether or not the scrollable panel currently has the input focus. Ini-

tially, the focus paint window is set to the first paint window created in the scrollable panel.

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

Argument: Xv_Window

Procs: get

Objects: Scrollable_panel

PANEL_GAUGE_WIDTH

Specifies the length of the panel gauge “thermometer” bar, in pixels, regardless of its horizontal or

vertical orientation.

Argument: int

Default: 100

Procs: create, get, set

Objects: Panel_gauge_item

See Also: 7.14

102 XView Reference Manual

PANEL_GINFO

The OLGX Graphics Information structure for the specified panel or panel item. This attribute is only

of interest to those panel item extensions that are calling OLGX functions or using OLGX macros.

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

Argument: Graphics_info *

Procs: get

Objects: Panel,Panel_item

PANEL_INACTIVE

If TRUE, panel item cannot be selected. Inactive items are displayed with gray-out pattern.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Panel_item

See Also: 7.9.1.1

PANEL_ITEM_CLASS

Gets the panel item type of the panel item specified.

Argument: Panel_item_type

Procs: get

Objects: Panel_item

PANEL_ITEM_COLOR

Specifies the colormap index to use for the item. A value of –1 implies the foreground color for the

panel window.

Argument: int

Default: -1

Procs: create, get, set

Objects: Panel_item

See Also: 21.5.1

PANEL_ITEM_CREATED

The Panel_item has finished processing the

XV_END_CREATE phase of the generic panel item

package (i.e. xv_panel_item_pkg). All Panel_items are subclassed from xv_

panel_item_pkg.

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

Argument: Bool

Procs: get

Objects: Panel_item

PANEL_ITEM_DEAF

The item does not want any events. This is used for items that contain one or more windows that are

located within the item’s rectangle. These windows are interposed on in order to process their events

and maintain the panel’s internal variables. An example of this is PANEL_MULTILINE_TEXT.

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

Argument: Bool

Procs: get,set

Objects: Panel_item

XView Attributes

XView Attributes 103

PANEL_ITEM_LABEL_RECT

The rectangle describing the label portion of an item.

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

Argument: Rect *

Procs: get,set

Objects: Panel_item

PANEL_ITEM_MENU

Specifies the menu associated with the panel item.

Argument: Menu

Default:

NULL

Procs: create, get, set

Objects: Panel_item

PANEL_ITEM_NTH_WINDOW

Returns the nth embedded window that receives events in the specified panel item. The first embed-

ded window has index 0. This attribute functions exactly like

OPENWIN_NTH_VIEW. This attribute is

an “advanced” attribute; the general application programmer will not need to use this attribute.

Return Type: Xv_Window

Argument: int

Procs: get

Objects: Panel_item

Usage:

textsw_view = xv_get(mltxt_item,

PANEL_ITEM_NTH_WINDOW,0, NULL);

See Also:

OPENWIN_NTH_VIEW

PANEL_ITEM_NWINDOWS

Returns the number of embedded windows in the specified panel item that receives events. Zero indi-

cates that there are no embedded windows. This attribute functions exactly like

OPENWIN_NVIEWS.

This attribute is an “advanced” attribute; the general application programmer will not need to use this

attribute.

Return Type: int

Procs: get

Objects: Panel_item

See Also:

OPENWIN_NVIEWS

PANEL_ITEM_OWNER

Allows the client to obtain the parent object given the child. In essence, if

PANEL_ITEM_OWNER ever

returns a value (non-NULL), then the client should assume this is the proper handle.

Values retrieved or set on the child handle are not guaranteed to be forward compatible if those values

are not handled through the parent object’s API.

Argument: XV_object

Procs: get

Objects: Panel_item

104 XView Reference Manual

PANEL_ITEM_RECT

Gets the rectangle surrounding the panel item.

Argument: Rect *

Procs: get

Objects: Panel_item

PANEL_ITEM_VALUE_RECT

The rectangle describing the value portion of an item.

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

Argument: Rect *

Procs: get,set

Objects: Panel_item

PANEL_ITEM_WANTS_ADJUST

The panel item wants

ACTION_ADJUST events.

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

Argument: Bool

Procs: get,set

Objects: Panel_item

PANEL_ITEM_WANTS_ISO

This flag indicates that the panel item wants all ISO characters. Unmodified

ASCII characters are not

to be interpreted as mouseless keyboard commands. Currently, PANEL_MULTILINE_TEXT and

PANEL_TEXT

items have this flag set.

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

Argument: Bool

Default:

FALSE

Procs: get,set

Objects: Panel_item

PANEL_ITEM_X

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

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

Argument: int

Procs: get

Objects: Panel

See Also: 7.4.2

PANEL_ITEM_X_GAP

When set on a panel, the horizontal space, in pixels, between the last panel item created and the next

panel item; when set on a panel item it is the horizontal space, in pixels, between the last panel item

created and this panel item. This attribute allows applications to more easily use relative item posi-

tioning instead of absolute positioning. Relative item positioning is the recommended method of po-

sitioning panel items, since the size of items may change between invocations (e.g., different scales)

or versions of the toolkit.

Argument: int

Default: 10, for Panel; the panel’s

PANEL_ITEM_X_GAP, for panel item

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

Objects: Panel, Panel_item

See Also: 7.3.1

XView Attributes

XView Attributes 105