Volume 7B: XView Reference Manual

WIN_MESSAGE_FORMAT

Used to access the format portion of a window’s client message.

Return Type: unsigned char

Procs: get

Objects: Xv_Window

See Also: 6.7.1,

WIN_MESSAGE_DATA, WIN_MESSAGE_TYPE

WIN_MESSAGE_TYPE

Used to access the type portion of a window’s client message.

Return Type: Atom

Procs: get

Objects: Xv_Window

See Also: 6.7.1,

WIN_MESSAGE_FORMAT, WIN_MESSAGE_DATA

WIN_MOUSE_XY

Warps the mouse pointer to the specified position. Returns a static Rect * on xv_get.

Argument: int, int

Default: N/A

Procs: create, get, set

Objects: Xv_Window

See Also: 13.3

WIN_NO_CLIPPING

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

SunView Applications.

WIN_PARENT

Specifies the window’s parent in the window tree. This attribute effectively reparents a window on

set.

Argument: Xv_Window

Default: None

Procs: create, get, set

Objects: Xv_Window

WIN_PERCENT_HEIGHT

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

SunView Applications.

WIN_PERCENT_WIDTH

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

SunView Applications.

WIN_RECT

Specifies the bounding box of a window. Returns a static Rect on xv_get.

Argument: Rect *

Default:

NULL

Procs: create, get, set

Objects: Xv_Window

156 XView Reference Manual

WIN_RETAINED

Hint to the server to maintain backing store for this window. The server may not honor this request.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Xv_Window

See Also: 5.5

WIN_RIGHT_OF

Causes a sibling window to be laid out just to the right of the window given as the value. Restricted to

windows that share the same immediate parent. Does not set

XV_Y.

Argument: Xv_Window

Default: Arbitrary

Procs: create,set

Objects: Xv_Window

See Also:

WIN_BELOW

WIN_ROW_GAP

Specifies the gap between rows in the window.

Argument: int

Default: 0

Procs: create, get, set

Objects: Xv_Window

WIN_ROW_HEIGHT

Specifies the height of a row in the window.

Argument: int

Default: Font’s default height

Procs: create, get, set

Objects: Xv_Window

WIN_ROWS

Specifies the window’s height (including top and bottom margins) in rows. WIN_ROWS is not a valid

xv_create() attribute for a Textsw. Issue a separate xv_set() call after the xv_create() in

order to set this attribute on a Textsw.

Argument: int

Default: 34

Procs: create, get, set

Objects: Xv_Window

WIN_SAVE_UNDER

Provides a hint to the server about whether or not the screen area beneath a window should be saved

while the window, such as a pop-up menu, is mapped. This is not the same as

WIN_RETAINED.

Argument: Bool

Default:

FALSE

Procs: set

Objects: Xv_Window

XView Attributes

XView Attributes 157

WIN_SCREEN_RECT

Returns the bounding box of the screen containing the window. Data points to per-process static stor-

age.

Argument: Rect *

Default: Screen dependent

Procs: get

Objects: Xv_Window

WIN_SET_FOCUS

Sets the input focus to this window, if possible. The X protocol restricts unmapped windows from

holding the input focus. The window must select for

KBD_USE and KBD_DONE events.

Argument: No value

Default: None

Procs: create,set

Objects: Xv_Window

WIN_SOFT_FNKEY_LABELS

Assigns labels for the soft function keys. The value for the WIN_SOFT_FNKEY_LABELS is a string of

12 labels separated by newline characters “\n”.

Argument: char *

Procs: get,set

Usage:

canvas = (Canvas) xv_create (frame,CANVAS,

CANVAS_X_PAINT_WINDOW,TRUE,

NULL);

xv_set(canvas_paint_window(canvas),

WIN_SOFT_FNKEY_LABELS,"Red0reen0lue0aroon

Orchid0iolet0agenta0oral0urquoise

Yellow0rick0lack0,

WIN_EVENT_PROC, my_Event_proc,

NULL);

In the above example, whenever the canvas gets the input focus, the soft function key la-

bels will be updated to “Red Green Blue . . . ”. To display the soft function key panel, se-

lect the Function Keys item from the Workspace Utilities menu.

See Also: 6.12.1

WIN_TOP_LEVEL

Returns whether the window is the child of another window or is a frame.

Return Type: Bool

Default: N/A

Procs: get

Objects: Xv_Window

158 XView Reference Manual

WIN_TOP_LEVEL_NO_DECOR

Controls whether this window is or is not controlled by the window manager. (This controls the

OverrideRedirect flag.)

Argument: Bool

Default:

FALSE

Procs: create,get,set

Objects: Xv_Window

See Also: 4.10

WIN_TRANSPARENT

Specifies that the window’s background pixmap should be be transparent (set to none). For more in-

formation, on the background pixmap refer to Chapter 4, Frames, of the XView Programming

Manual.

Argument: No value

Default: Not transparent

Procs: create

Objects: Xv_Window

WIN_VERTICAL_SCROLLBAR

This attribute is obsolete. Use OPENWIN_VERTICAL_SCROLLBAR instead. Specifies that scrollbar ori-

entation is vertical.

Argument: Scrollbar

Default: None

Procs: create, get, set

Objects: Xv_Window

WIN_WINDOW_GRAVITY

Defines how the window should be repositioned if its parent is resized. See <X11/X.h> for legal

values.

Argument: int

Default: NorthWestGravity

Procs: create, get, set

Objects: Xv_Window

See Also: 5.3,

WIN_BIT_GRAVITY

WIN_X_COLOR_INDICES

Translates the logical indices of the window’s colormap segment (from 0 to size-1) into the actual

indices into the colormap used by the window.

Argument: unsigned long *

Procs: get

Objects: Xv_Window

See Also: 21.3.0.1

WIN_X_EVENT_MASK

Expects an X event mask. Acts in the same manner as

WIN_CONSUME_X_EVENT_MASK; but instead of

appending to the current input mask, replaces it with a new mask.

Argument: unsigned long

Default: Varies from package to package

Procs: create, get, set

See Also:

WIN_CONSUME_EVENTS, WIN_CONSUME_X_EVENT_MASK

XView Attributes

XView Attributes 159

XV_APP_NAME

Sets the string to be used by XView as the application’s name. (Currently this is only for the help

package). This also allows for more than one help file while still displaying the same name in the spot

help header window.

Argument: char *

Default: argv[0]

Procs: set, get

Objects: Server

Usage:

server = xv_init(XV_INIT_ARGS, argc, argv, 0);

xv_set(server,

XV_APP_NAME,mailtool, NULL);

/* or (for localized app name) */

xv_set(server,

XV_APP_NAME,gettext(mailtool), NULL);

XV_AUTO_CREATE

Specifies whether to create an object not found by xv_find().

Argument: Bool

Default:

TRUE

Procs: find

Objects: Cms, Font, Menu_item

See Also: 25.9.2

XV_BOTTOM_MARGIN

Specifies the margin at the bottom of an object.

Argument: int

Default: Varies with object

Procs: create, get, set

XV_DEPTH

Specifies the pixel depth of the object.

Argument: int

Default: Function of the screen

Procs: create, get

Objects: Xv_Window

XV_DISPLAY

Returns the X Display data structure. The structure returned is maintained by the toolkit and should

not be freed.

Argument: Display *

Default: Display structure for specified object

Procs: get

Objects: All Drawable objects and its subcalsses

See Also: 15.1

160 XView Reference Manual