XV_ERROR_PROC
The application’s XView error handler is called as a result of xv_error() being called.
Argument: int (*error_proc)()
Default: None
Procs: xv_init
Objects: N/A
Callback:
int
error_proc(object, avlist)
Xv_object object;
Attr_avlist avlist;
See Also: 24.2,
XV_X_ERROR_PROC
XV_FOCUS_ELEMENT
Set focus on the first (0) or last (-1) element in the pane.
Argument: int
Valid Values: {0, -1}
Procs: set
Objects: Xv_Window
XV_FONT
Specifies an object’s font. Use only with xv_create() if you are setting a panel’s font.
Argument: Xv_Font
Default: lucida medium
Procs: create, get, set
Only use create and get for a
FILE_CHOOSER.
Object: Generally, all
XV_HEIGHT
Specifies the height of an object in pixels.
Argument: int
Default: N/A
Defaults to a pre-determined number of rows and columns for a
FILE_CHOOSER object.
Should not be set at create time for a File Chooser.
Procs: create, get, set
Objects: All
See Also: 15.4
XV_HELP_DATA
Specifies the help string used by the help package to display on-line help. The text string has the form
file:keyword. The help package looks for the key keyword in the file $HELPPATH/file.info. In
the special case for a Textsw, set
XV_HELP_DATA on the Textsw’s view which you can get with the
following call:
xv_get(textsw, OPENWIN_NTH_VIEW, NULL);
Argument: char *
Default: No help available notice
Procs: create, get, set
Objects: All
See Also: 23.1
XView Attributes
XView Attributes 161
XV_INIT_ARGC_PTR_ARGV
Interprets command-line args. Strips generic toolkit command-line arguments out of argv and de-
crements argc accordingly.
Argument 1: int *
Argument 2: char **
Default: None
Procs: xv_init
Objects: N/A
Usage:
main(argc, argv
int argc;
char **argv;
{
server = xv_init (XV_INIT_ARGC_PTR_ARGV,
&argc, argv, NULL);
}
See Also: 2.6.1,
XV_INIT_ARGS
XV_INIT_ARGS
Interprets command-line arguments. Does not strip generic toolkit command-line arguments out of
argv.
Argument 1: int
Argument 2: char **
Default: None
Procs: xv_init
Objects:
N/A
Usage:
main(argc, argv
int argc;
char **argv;
{
server = xv_init (XV_INIT_ARGS, argc, argv, NULL);
}
See Also: 2.6.1,
XV_INIT_ARGC_PTR_ARGV
XV_INSTANCE_NAME
The attribute XV_INSTANCE_NAME is used to associate an instance name with an XView object. The
instance name is used to construct the resource name used by the resource manager to perform look-
ups. The resource name is constructed by concatenating the instance names of all objects in the cur-
rent object’s lineage, starting with the name of the application or whatever was passed in with the
-name command-line option, ending with the XView attribute name. The XView attribute name re-
mains in lowercase.
XV_INSTANCE_NAME is normally used with XV_USE_DB.
Argument: char *
Default:
NULL
Procs: create, set
162 XView Reference Manual
Usage:
Frame frame;
Panel panel;
frame = (Frame)xv_create(NULL, FRAME,
XV_INSTANCE_NAME, "base_frame",
NULL);
panel = (Panel)xv_create(frame, PANEL,
XV_INSTANCE_NAME, "panel",
XV_USE_DB,
XV_WIDTH, 100,
XV_HEIGHT, 200,
NULL,
NULL);
Above, assume the name of the application is app, the resource names constructed for
lookup of the width and height of the panel are:
app.base_frame.panel.xv_width
app.base_frame.panel.xv_height
Entries in the resource manager could look like:
app.base_frame.panel.xv_width:400
app.base_frame.panel.xv_height:500
If these entries were not present in the resource manager, the width and height of the
panel would take the default values of 100 and 200, respectively.
See Also: 22.3.2.3, 17.3,
XV_USE_DB
XV_KEY_DATA
Stores a 32-bit data value on an object. You may set multiple
XV_KEY_DATA values on objects by us-
ing different keys. The key specified should be a unique number (see xv_unique_key() in Sec-
tion 3, Procedures and Macros.)
Argument 1: int
Argument 2: XV_opaque
Default: None
Procs: create, get, set
Objects: All
Usage:
xv_create(panel, PANEL_BUTTON,
PANEL_BUTTON_LABEL, "Push Me"
XV_KEY_DATA, PANEL_ITEM_KEY, "text",
PANEL_NOTIFY_PROC, my_notify_proc
NULL);
See Also: 7.19.1
XV_KEY_DATA_REMOVE
Causes the data associated with the specified key to be removed. If an XV_KEY_DATA_
REMOVE_PROC is defined, it will be called.
Argument: int
Default: None
Procs: set
Objects: All
See Also: 7.19.1,
XV_KEY_DATA, XV_KEY_DATA_REMOVE_PROC
XView Attributes
XView Attributes 163
XV_KEY_DATA_REMOVE_PROC
Names the function that is called whenever the object that has key data attached to it is destroyed.
This function should free the data associated with the key.
Argument 1: int
Argument 2: void(*xv_key_data_remove_proc)()
Default: None
Procs: create, get, set
Objects All
Callback:
void
xv_key_data_remove_proc(object, key, data)
Xv_object object;
int key;
caddr_t data;
See Also: 7.19.1
XV_LABEL
Specifies a frame’s header label or an icon’s label or simply associates a name to an object. XView
copies the strings on set.
Argument: char *
Default:
NULL
For a
FILE_CHOOSER, defaults to the string “Open”, “Save” or “Save As”, depending on
the value of the FILE_CHOOSER_TYPE attribute. Note that the the proper format is
Application: Popupname.
Procs: create, get, set
Objects: All
See Also: 4.2.2
XV_LC_BASIC_LOCALE
Specifies the basic locale category, which sets the country of the user interface. This XView attribute
can only be used in xv_init(), but can be queried on any XView object which is a subclass of win-
dow or server class via xv_get(). The value that is set using these attributes must be a valid locale
name in the system. Use in situations where you want to force a program to operate in a certain lo-
cale. For example, if a program only works in French, then the locale attribute can be set so that it
cannot be switched to another language.
Warning: This attribute should only be used for localization operations.
Argument: char *
Default: “C”
Procs: xv_init(), get
Usage:
xv_init(...,
XV_LC_BASIC_LOCALE, "fr",
XV_LC_DISPLAY_LANG, "C",
NULL);
See Also: 22.1.4,
XV_LOCALE_DIR, Chapter 22, Internationalization, in XView Programming
Manual.
164 XView Reference Manual
XV_LC_DISPLAY_LANG
Specifies the display language locale category, which sets the language in which labels, messages,
menu items, and help text are displayed. This XView attribute can only be used in xv_init(), but
can be queried on any XView object which is a subclass of window or server class via xv_get().
The value that is set using these attributes must be a valid locale name in the system. Use in situations
where you want to force a program to operate in a certain locale. For example, if a program only
works in French, then the locale attribute can be set so that it cannot be switched to another language.
Warning: This attribute should only be used for localization operations.
Argument: char *
Default: “C”
Procs: xv_init(), get
See Also: 22.1.4,
XV_LOCALE_DIR, Chapter 22, Internationalization
XV_LC_INPUT_LANG
Specifies the input language locale category, which sets the language used for keyboard input. This
XView attribute can only be used in xv_init(), but can be queried on any XView object which is a
subclass of window or server class via xv_get(). The value that is set using these attributes must
be a valid locale name in the system. Use in situations where you want to force a program to operate
in a certain locale. For example, if a program only works in French, then the locale attribute can be
set so that it cannot be switched to another language.
Warning: This attribute should only be used for localization operations.
Argument: char *
Default: “C”
Procs: xv_init(), get
See Also: 22.1.4,
XV_LOCALE_DIR, Chapter 22, Internationalization
XV_LC_NUMERIC
Specifies the numeric locale category, which defines the language used to format numeric quantities.
This XView attribute can only be used in xv_init(), but can be queried on any XView object
which is a subclass of window or server class via xv_get(). The value that is set using these attri-
butes must be a valid locale name in the system. Use in situations where you want to force a program
to operate in a certain locale. For example, if a program only works in French, then the locale attri-
bute can be set so that it cannot be switched to another language.
Warning: This attribute should only be used for localization operations.
Argument: char *
Default: “C”
Procs: xv_init(), get
See Also: 22.1.4,
XV_LOCALE_DIR, Chapter 22, Internationalization
XV_LC_TIME_FORMAT
Specifies the time format locale category, which defines the language used to format time and date.
This XView attribute can only be used in xv_init(), but can be queried on any XView object
which is a subclass of window or server class via xv_get(). The value that is set using these attri-
butes must be a valid locale name in the system. Use in situations where you want to force a program
to operate in a certain locale. For example, if a program only works in French, then the locale attri-
bute can be set so that it cannot be switched to another language.
Warning: This attribute should only be used for localization operations.
Argument: char *
Default: “C”
Procs: xv_init(), get
See Also: 22.1.4,
XV_LOCALE_DIR, Chapter 22, Internationalization
XView Attributes
XView Attributes 165

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.