Volume 7B: XView Reference Manual

NOTICE_STATUS

Specifies the address of the return code of the notice when it pops-down. If not specified, the notice

return code is stored in the notice object and can be obtained by doing (int)xv_get(notice NO-

TICE_STATUS). In xv_set() we pass in an (int *), and the xv_get() returns an (int).

Return Type: (int)

Argument: (int *)

Default: See description

Procs: create,get,set

Objects: Xv_Notice

See Also: 12.1.1

NOTICE_TRIGGER

Specifies an XView event ID or type, other than clicking on mouse buttons, that will cause the notice

to pop down. The notice pops down and the thread of execution continues. This applies to a notice

object only when

NOTICE_LOCK_SCREEN is TRUE. When this event occurs, the value returned is NO-

TICE_TRIGGERED. The event parameter to notice_prompt contains specifics about the event

that triggered it.

Argument: int (for example,

MS_LEFT)

Default: N/A

Procs: create,set,notice_prompt()

Objects: Xv_Notice

See Also: 12.2.2.1,

NOTICE_TRIGGER_EVENT

NOTICE_TRIGGER_EVENT

Specifies the address of the XView Event structure that caused the notice to pop down, the thread of

execution continues. This is used with the

NOTICE_TRIGGER attribute and applies only when

NOTICE_LOCK_SCREEN is TRUE.

Argument: (Event *)

Default: N/A

Procs: create,set

Objects: Xv_Notice

See Also: 12.2.2.1,

NOTICE_TRIGGER

OPENWIN_ADJUST_FOR_HORIZONTAL_SCROLLBAR

Reserves space in openwin-class objects (e.g., canvas) for a horizontal scrollbar. On xv_set, adjusts

(extends) the height of a subwindow that does not have a horizontal scrollbar to align properly with

one that does.

Argument: Bool

Default:

TRUE

Procs: create, get, set

Objects: Openwin

OPENWIN_ADJUST_FOR_VERTICAL_SCROLLBAR

Reserves space in openwin-class objects (e.g., canvas) for a vertical scrollbar. On xv_set, adjusts

(extends) the width of a subwindow that does not have a vertical scrollbar to align properly with one

that does.

Argument: Bool

Default:

TRUE

Procs: create, get, set

Objects: Openwin

XView Attributes

XView Attributes 91

OPENWIN_AUTO_CLEAR

If TRUE, exposed areas of windows are cleared (i.e., painted the background color) before the repaint

procedure is called.

Argument: Bool

Default:

TRUE unless subwindow’s canvas is retained

Procs: create, get, set

Objects: Openwin

See Also: 5.3

OPENWIN_HORIZONTAL_SCROLLBAR

Returns the handle of the horizontal scrollbar associated with the specified view.

Return Type: Scrollbar

Argument: Xv_Window

Procs: create,get,set

Objects: Openwin

Usage:

Scrollbar sb;

Xv_Window view;

Openwin openwin;

sb = (Scrollbar)xv_get(openwin,

OPENWIN_HORIZONTAL_SCROLLBAR, view);

See Also:

OPENWIN_VERTICAL_SCROLLBAR

OPENWIN_NO_MARGIN

If

TRUE, the view window’s two pixel bottom and right margins are turned off.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Openwin

OPENWIN_NTH_VIEW

Gets the handle of a specified openwin view window. Openwin view windows are numbered from

zero.

Return Type: Xv_window

Argument: int

Procs: get

Objects: Openwin

See Also: 5.6.3.2

OPENWIN_NVIEWS

Gets the number of views contained in the open window.

Return Type: int

Default: 1

Procs: get

Objects: Openwin

92 XView Reference Manual

OPENWIN_SHOW_BORDERS

Displays openwin borders. This must remain on for openwin objects to have scrollbars attached to

them.

Argument: Bool

Default:

TRUE (FALSE for scrollable panels)

Procs: create, get

Objects: Openwin

OPENWIN_SPLIT

Takes as its value a list of attribute-value pairs beginning with OPENWIN_SPLIT_.

Argument: A-V list

Procs: create, set

Objects: Openwin

Callback:

void

openwin_split_destroy_proc(openwin)

Openwin openwin;

OPENWIN_SPLIT_ used to install this procedure. This function is called when the user

joins two views.

See Also: 5.6.2

OPENWIN_SPLIT_DESTROY_PROC

Names a procedure to call when a split openwin is joined. This attribute can only be set in an

OPENWIN_SPLIT attribute-value list.

Argument void (*openwin_split_destroy_proc)()

Default:

NULL

Procs: create, get, set

Objects: Openwin

See Also: 5.6.3.1,

OPENWIN_SPLIT

OPENWIN_SPLIT_DIRECTION

Sets the direction of the split either horizontally or vertically. This attribute can only be set in an

OPENWIN_SPLIT attribute-value list.

Argument: Openwin_split_direction

Default:

OPENWIN_SPLIT_HORIZONTAL

Procs: create, set

Objects: Openwin

See Also:

OPENWIN_SPLIT

OPENWIN_SPLIT_INIT_PROC

Names a procedure to call when a split window is created. This attribute can only be set in an

OPENWIN_SPLIT attribute-value list.

Argument void (*openwin_split_init_proc)()

Default:

NULL

Procs: create, get, set

Objects: Openwin

See Also: 5.6.3.1,

OPENWIN_SPLIT

XView Attributes

XView Attributes 93

OPENWIN_SPLIT_POSITION

Sets the position (in pixels) of the view. This attribute can only be set in an OPENWIN_SPLIT attri-

bute-value list.

Argument: int

Default: None

Procs: create,set

Objects: Openwin

See Also:

OPENWIN_SPLIT

OPENWIN_SPLIT_VIEW

Specifies which view to split. Its value is the handle of the view you want to split. This attribute can

only be set in an OPENWIN_SPLIT attribute-value list.

Argument: Xv_window

Procs: set

Objects: Openwin

See Also:

OPENWIN_SPLIT

OPENWIN_SPLIT_VIEW_START

Specifies which part of the data (measured in scrollbar-units) is displayed at the start of the view (top

for vertical; left for horizontal). This attribute can only be set in an OPENWIN_SPLIT attribute-value

list.

Argument: int

Default: Continue from previous view

Procs: create,get,set

Objects: Openwin

See Also:

OPENWIN_SPLIT

OPENWIN_VERTICAL_SCROLLBAR

Returns the handle of the vertical scrollbar associated with the specified view.

Return Type: Scrollbar

Argument: Xv_Window

Procs: create,get,set

Objects: Openwin

Usage:

Scrollbar sb;

Xv_Window view;

Openwin openwin;

sb = (Scrollbar)xv_get(openwin,

OPENWIN_VERTICAL_SCROLLBAR, view);

See Also:

OPENWIN_HORIZONTAL_SCROLLBAR

OPENWIN_VIEW_ATTRS

Distributes modifications across all views in a given openwin. Note that this does not affect canvas

paint windows.

Argument: A-V list

Procs: create, set

Objects: Openwin

See Also:

CANVAS_PAINTWINDOW_ATTRS

94 XView Reference Manual

PANEL_ACCEPT_KEYSTROKE

Specifies whether the panel background or panel item should consume keyboard events. When an

item wants keystrokes, set PANEL_ACCEPT_KEYSTROKE to TRUE on the panel item in the item’s init

routine. Setting PANEL_ACCEPT_KEYSTROKE to TRUE on the panel background is not recommended,

since this is not supported by OPEN LOOK. This mode is maintained for SunView1 compatibility.

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

Argument: Bool

Default:

FALSE for panel background. Default for panel items depends on the state of OpenWin-

dows.KeyboardCommands. If it is SunView1 or Basic, then only

PANEL_TEXT,

PANEL_NUMERIC_TEXT, and PANEL_MULTILINE_TEXT accept keyboard input focus. If

it is Full, then all panel items accept keyboard input focus.

Procs: create, get, set

Objects: Panel, Panel_item

See Also: 7.19.6

PANEL_BACKGROUND_PROC

Names an event-handling procedure called when an event falls on the background of the panel.

Argument: void (*panel_background_proc)()

Default: panel_default_handle_event

Procs: create, get, set

Objects: Panel

Callback:

void

panel_background_proc(panel, event)

Panel panel

Event *event

Event-handling procedure called when an event falls on the background of the panel

(e.g., not on any panel items).

See Also: 7.19.6

PANEL_BORDER

Adds a border around the panel. In a 3D implementation, this border is two pixels wide and presents

a “chiseled” appearance. In 2D, the border is one pixel wide. Since the border is rendered directly on

the Panel, it is the job of the application to make sure that no Panel_item’s overlap the border.

Argument: Bool

Default:

FALSE

Procs: create, get set

Objects: Panel

See Also: 7.3.2

PANEL_BLINK_CARET

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

SunView Applications.

XView Attributes

XView Attributes 95