Volume 7B: XView Reference Manual

PATH_RELATIVE_TO

Specifies an absolute path that any relative path input will be appended to in order to complete the

path name. This means that if someone tries to validate the string bin, the PATH_NAME package will

append bin to this string to determine what the actual path name should be validated as.

Argument: char *

Default:

NULL

Procs: create, get, set

Objects: Path_name

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

PATH_USE_FRAME

Specifies if the PATH_NAME package is allowed to put error messages into its parent Frame’s footer.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Path_name

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

SCREEN_NUMBER

Specifies the number of the screen associated with object.

Argument: int

Default: 0

Procs: get

Objects: Screen

See Also: 15.2

SCREEN_SERVER

Specifies the server associated with this screen. By default, its value is the server created by opening

the display specified by the value of the

DISPLAY environment variable.

Return Type: Xv_Server

Procs: get

Objects: Screen

See Also: 15.3.3

SCROLLBAR_COMPUTE_SCROLL_PROC

Converts physical scrollbar info to client object info. The default_compute_scroll_proc can

be called to perform the functionality that the scrollbar package normally would. If a normalize pro-

cedure is not set, then the offset becomes the viewstart (after bounds checking) and the scrollbar pack-

age will scroll to this offset into the object.

Default: scrollbar_default_compute_scroll_proc

Procs: create, get, set

Objects: Scrollbar

126 XView Reference Manual

Callback:

void

scrollbar_default_compute_scroll_proc(

scroll_public, pos, available_cable,

motion, offset, object_length)

Scrollbar scroll_public

Scrollbar scroll_public

int pos;

int available_cable;

Scroll_motion motion;

unsigned long *offset;

unsigned long *object_length;

Computes default scrolling based on the scroll position. pos is the position from the start

of the cable event. length is the length of the cable. offset and object_

length are output parameters. The offset is given in client units to scroll by. The object

length is in client units.

SCROLLBAR_DIRECTION

Sets orientation of the scrollbar as SCROLLBAR_VERTICAL or SCROLLBAR_HORIZONTAL.

Argument: Scrollbar_setting

Valid Values: {

SCROLLBAR_VERTICAL, SCROLLBAR_HORIZONTAL}

Default: None

Procs: create, get

Objects: Scrollbar

SCROLLBAR_LAST_VIEW_START

Specifies the offset of the view into the object prior to the last scroll.

Argument: int

Default: 0

Procs: get

Objects: Scrollbar

SCROLLBAR_MENU

Specifies a pointer to the scrollbar’s menu. Clients can add items to the default menu but cannot re-

move items from it.

Argument: Menu

Default: Scrollbar creates a default menu

Procs: get

Objects: Scrollbar

SCROLLBAR_MOTION

Provides the scrolling motion that results in a scrollbar_request event.

Argument: enum

Procs: get

Return Values:

ABSOLUTE

POINT_TO_MIN (from here_to_top on menu)

PAGE_FORWARD

XView Attributes

XView Attributes 127

LINE_FORWARD

MIN_TO_POINT (from top_to_here on menu)

PAGE_BACKWARD

LINE_BACKWARD

TO_END

TO_START

PAGE_ALIGNED

SCROLLBAR_NORMALIZE_PROC

Specifies a procedure that does normalization (sets the viewable area of the object that the scrollbar

scrolls). This function should return vstart. It takes the offset given by the compute_proc and

adjusts it. The scrollbar package will then scroll to this offset into the object. The scrollbar package

will call the scrollbar_compute_scroll_proc and the scrollbar_normalize_proc in

that order whenever any scrolling is done.

Default:

NULL

Procs: create, get, set

Objects: Scrollbar

Callback:

scrollbar_normalize_proc(sb,voffset,motion,&vstart)

SCROLLBAR_NOTIFY_CLIENT

Used by the Notifier. Indicates the client that is notified when the scrollbar is scrolled. See Chapter

10, Scrollbars, in XView Programming Manual.

Argument: Xv_opaque

Default: Subwindow scrollbar is attached to contents

Procs: create, get, set

Objects: Scrollbar

See Also: 10.4.1

SCROLLBAR_OBJECT_LENGTH

Specifies the length of the scrollable object in scrollbar units. Value must be greater than or equal to

zero.

Argument: int

Default: 0

Procs: create, get, set

Objects: Scrollbar

See Also: 10.2

SCROLLBAR_PAGE_LENGTH

Specifies the length of a page in scrollbar units for page-scrolling purposes.

Argument: int

Default: 0

Procs: create, get, set

Objects: Scrollbar

See Also: 10.2

128 XView Reference Manual

SCROLLBAR_PIXELS_PER_UNIT

Specifies the number of pixels constituting a scrollbar unit. For example, when scrolling a list of

icons, each unit might be 64 pixels.

Argument: int

Default: 1

Procs: create, get, set

Objects: Scrollbar

See Also: 10.2

SCROLLBAR_SPLITTABLE

Indicates whether the object that contains the scrollbar is splittable.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Scrollbar

See Also: 5.6.1

SCROLLBAR_VIEW_LENGTH

Specifies the length of the viewing window in scrollbar units.

Argument: int

Default: 0

Procs: create, get, set

Objects: Scrollbar

See Also: 10.2

SCROLLBAR_VIEW_START

Specifies the current offset into the scrollbar object in scrollbar units. The value must be greater than

or equal to zero.

Argument: int

Default: 0

Procs: create, get,set

Objects: Scrollbar

See Also: 10.2

SEL_APPEND_TYPE_NAMES

Same as SEL_TYPE_NAMES except that the new list is appended to the previously set type list.

Argument: List of string (

STRING, NULL)

Default: N/A

Procs: create, set

Objects: Selection_requestor

Usage:

Selection_requestor sel;

sel = xv_create(panel, SELECTION_REQUESTOR,

SEL_REPLY_PROC, SelectionReplyProc,

NULL);

xv_set(sel, SEL_APPEND_TYPE_NAMES, "TARGETS", NULL,

NULL);

See Also: 18.2.3.1,

SEL_TYPE_NAMES

XView Attributes

XView Attributes 129

SEL_APPEND_TYPES

Same as SEL_TYPES except that the new list is appended to the previously set type list.

Argument: List of Atoms (

XA_STRING, NULL)

Default: N/A

Procs: create,set

Objects: Selection_requestor

Usage:

Selection_requestor sel;

sel = xv_create(panel, SELECTION_REQUESTOR,

SEL_REPLY_PROC, SelectionReplyProc,

NULL);

xv_set(sel, SEL_APPEND_TYPES, XA_STRING, NULL, NULL);

See Also: 18.2.3.1,

SEL_TYPES

SEL_CONVERT_PROC

Specifies the procedure that is to be called whenever a client requests the current value of the selec-

tion.

Argument: int (*convert_proc) ()

Default: sel_convert_proc

Procs: create,get,set

Objects: Selection_owner

Callback:

int

convert_proc( sel, replyType, replyBuff, length, format )

Selection_owner sel;

Atom *replyType;

Xv_opaque *replyBuff;

unsigned long *length;

int *format;

sel specifies the selection owner.

replyType specifies the type of the selection that has been requested. It should be

explicitly set to an atom which describes the converted type of the selection (for ex-

ample,

TEXT

might have the type

XA_STRING).

replyBuff is a pointer to a buffer address which contains the converted data.

length specifies a pointer to the number of elements in replyBuff. The size of an

element is defined by format. The convert procedure is called with length set to

the maximum allowed buffer size.

format specifies a pointer to the data format. Valid values are 8, 12, or 32 for 8-bit,

16-bit, or 32-bit quantities, respectively.

See Also: 18.2.4

SEL_COPY

SEL_COPY

indicates whether or not to make a copy of the SEL_DATA data. If set to FALSE it is up to

the client to maintain the data.

Argument: Bool

Default:

TRUE

Procs: create,set,get

Objects: Selection_item

See Also: 18.3.1

130 XView Reference Manual