Volume 7B: XView Reference Manual

SEL_TYPE_NAME

Same as SEL_TYPE except that the argument is the name of the requested selection type instead of

an atom. The package will intern the requested atom name. For a selection item, specifies the type

name that the package will convert to.

Argument: *char

Default: "STRING"

Procs: create,get,set

Objects: Selection_requestor Selection_item

See Also: 18.2.3.1

SEL_TYPE_NAMES

Specifies a NULL-terminated list of atom type names that the client is requesting.

Argument: List of string

Default: “

STRING, NULL”

Procs: create,get,set

Objects: Selection_requestor

See Also: 18.2.3.1

SEL_TYPES

Specifies a NULL-terminated list of atom types that the client is requesting. The effect will be as if a

sequence of SelectionRequest events is delivered to the selection owner, one for each atom. This at-

tribute will initiate a

MULTIPLE request.

Argument: List of Atoms

Default:

XA_STRING,NULL

Procs: create,get,set

Objects: Selection_requestor

See Also: 18.2.3.1

SELN_

*

Appendix A presents all of the SELN_ attributes.

SERVER_ATOM

SERVER_ATOM

is equivalent to XInternAtom() (with the only_if_exists flag set to FALSE)

except that it caches the results on the server object so that subsequent requests for the same atom will

not require a round-trip to the X server.

Return Type: Atom

Procs: get

Usage:

Atom atom;

atom = (Atom) xv_get(server_object,

SERVER_ATOM, "TIMESTAMP");

See Also: 15.3.3,

SERVER_ATOM_NAME

136 XView Reference Manual

SERVER_ATOM_NAME

SERVER_ATOM_NAME is equivalent to XGetAtomName() except that it caches the results on the

server object so that subsequent requests will not require a roundtrip to the X server. The returned

string is maintained by XView and should not be modified or freed. XView will free up all strings as-

sociated with atoms on that server when the server object is destroyed.

Return Type: char *

Procs: get

Usage:

char *atom_name;

atom_name (char *)xv_get(server_object, atom);

See Also: 15.3.3,

SERVER_ATOM

SERVER_EXTENSION_PROC

Specifies the procedure used to handle server extension events.

Argument: void (*extension_proc)()

Default:

NULL

Procs: create, get, set

Objects: Server

Callback:

void

extension_proc(display, xevent, window)

Display *display;

Event *xevent;

Xv_window window;

See Also: 6.10

SERVER_EXTERNAL_XEVENT_MASK

This attribute, together with

SERVER_EXTERNAL_XEVENT_PROC, allows a client to receive notification

for X events destined for X windows which are not local to a client. For each non-local X window,

the client can specify a different set of X events for which it needs notification. Additionally, an

XView object handle is provided as an argument which is returned as a parameter during callback.

For xv_create and xv_set this attribute takes these three arguments: an XID of a window, an

event mask (see <X11/X.h> for details), and an XView object handle. SERVER_

EXTERNAL_XEVENT_MASK for xv_get takes two arguments: an XID of a window, and an XView

object handle and returns a mask.

Argument 1: unsigned long

Argument 2: unsigned long

Argument 3: Xv_opaque

Default: None

Procs: create,get,set

Objects: Server

Usage:

xv_set (server, SERVER_EXTERNAL_XEVENT_MASK,

RootWindow(dpy, 0),

ButtonPressMask | PropertyChangeMask,

frame,

SERVER_EXTERNAL_XEVENT_PROC,

root_event_proc, frame,

NULL);

See Also: 6.11,

SERVER_EXTERNAL_XEVENT_PROC

XView Attributes

XView Attributes 137

SERVER_EXTERNAL_XEVENT_PROC

This attribute, together with attribute SERVER_EXTERNAL_XEVENT_MASK allows a client to receive

notification for X events destined for X windows which are not local to the client. A client can regis-

ter a separate callback procedure for each XView object handle. For xv_create and xv_set this

attribute takes two arguments. For xv_get it takes one argument: an XView object handle and re-

turns a function name. A NULL first argument temporarily disables callbacks.

Argument 1: void (*callback_proc)()

Argument 2: Xv_opaque

Default: None

Procs: create,get,set

Objects Server

Usage:

xv_set (server,

SERVER_EXTERNAL_XEVENT_MASK,

RootWindow(dpy, 0),

ButtonPressMask | PropertyChangeMask,

frame,

SERVER_EXTERNAL_XEVENT_PROC,

root_event_proc, frame,

NULL);

Callback:

void

callback_proc (server, display, xevent, handle)

Xv_server server;

Display *display;

XEvent *xevent;

Xv_opaque handle;

See Also: 6.11,

SERVER_EXTERNAL_XEVENT_MASK

SERVER_IMAGE_BITMAP_FILE

Specifies a file containing the X11 bitmap from which the server image is created.

Argument: char *

Default: None

Procs: create

Objects: Server

See Also: 15.4.1

SERVER_IMAGE_BITS

Specifies the SunView pixrect image bits for the server image. Use

SERVER_IMAGE_X_BITS for

standard X11 bitmaps.

Argument: short *

Default: Uninitialized

Procs: create, get, set

Objects: Server_image

See Also: 15.4.1

138 XView Reference Manual

SERVER_IMAGE_CMS

Specifies the colormap segment to be used in converting the server image data (which are logical

colormap indices) into pixel values in the pixmap used to draw the server image.

Argument: cms

Default: The default cms for the application

Procs: create,get

Usage:

Server_image image;

image = (Server_image)xv_create(NULL,

SERVER_IMAGE,

...

SERVER_IMAGE_CMS, cms,

...

NULL);

See Also: 15.4.1

SERVER_IMAGE_COLORMAP

Specifies the name of the colormap segment to be used in converting the server image data (which are

logical colormap indices) into pixel values in the pixmap used to draw the server image.

This is basically a backwards compatibility attribute, and where possible,

SERVER_IMAGE_CMS should

be used instead.

Argument: char *

Default: “xv_default_cms”

Procs: get, create

Usage:

Cms cms;

Server_image image;

cms = (Cms)xv_create(NULL, CMS,

...

CMS_NAME, "palette",

...

NULL);

image = (Server_image)xv_create(NULL, SERVER_IMAGE,

...

SERVER_IMAGE_COLORMAP, "palette",

...

NULL);

SERVER_IMAGE_DEPTH

Specifies the bit plane depth of the server image.

Argument: int

Default: 1

Procs: create, get, set

Objects: Server_image

See Also: 15.4.1

XView Attributes

XView Attributes 139

SERVER_IMAGE_PIXMAP

Allows an existing pixmap to be associated with a server image. An xv_get using this attribute is

equivalent to an xv_get of the XV_XID of the server image.

Argument: Pixmap

Default: None

Procs: create, get, set

Objects: Server_image

See Also: 15.4.1

SERVER_IMAGE_SAVE_PIXMAP

Allows the application to specify that the old pixmap must not be destroyed if a new pixmap is created

as the result of changing any server image attributes or assigning a new pixmap directly. You should

retain a handle to the old pixmap first.

Argument: Bool

Default:

FALSE

Procs: create,get,set

Objects: Server_image

See Also: 15.4.1

SERVER_IMAGE_X_BITS

Specifies the bits to use in a server image. Bits are stored in an array of char.

Argument: char *

Default: None

Procs: create, set

Objects: Server_image

See Also: 15.4.1

SERVER_NTH_SCREEN

Specifies the screen with given number. Returns

NULL if screen does not exist.

Argument 1: int

Argument 2: Screen

Default: N/A

Procs: create, get, set

Objects: Server

See Also: 15.2.1

SERVER_SYNC

Flushes the request buffer and waits for all events and errors to be processed by the server. If the ar-

gument is

TRUE, then SERVER_SYNC discards all events on the input queue.

Argument: Bool

Default: N/A

Procs: set

Objects: Server

SERVER_SYNC_AND_PROCESS_EVENTS

Same as SERVER_SYNC, but this processes any events that arrive as a result of the XSync().

Argument: No value

Default: None

Procs: create, set

Objects: Server

See Also: 15.3.3

140 XView Reference Manual