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

Get Volume 7B: XView Reference Manual now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.