NAME
XOpenOM, XCloseOM, XSetOMValues, XGetOMValues, XDisplayOfOM, XLocaleOfOM - open
output methods
SYNTAX
XOM
XOpenOM(Display * display, XrmDatabase db, char *
res_name, char * res_class);
Status
XCloseOM(XOM om);
char
*XSetOMValues(XOM om);
char
*XGetOMValues(XOM om);
Display
*XDisplayOfOM(XOM om);
char
*XLocaleOfOM(XOM om);
ARGUMENTS
- display
- Specifies the connection to the X server.
- db
- Specifies a pointer to the resource database.
- res_name
- Specifies the full resource name of the application.
- res_class
- Specifies the full class name of the application.
- om
- Specifies the output method.
- ...
- Specifies the variable length argument list to set or
get XOM values.
DESCRIPTION
The
XOpenOM function opens an output method matching the current locale
and modifiers specification. The current locale and modifiers are bound to the
output method when
XOpenOM is called. The locale associated with an
output method cannot be changed.
The specific output method to which this call will be routed is identified on
the basis of the current locale and modifiers.
XOpenOM will identify a
default output method corresponding to the current locale. That default can be
modified using
XSetLocaleModifiers to set the output method modifier.
The db argument is the resource database to be used by the output method for
looking up resources that are private to the output method. It is not intended
that this database be used to look up values that can be set as OC values in
an output context. If db is NULL, no database is passed to the output method.
The res_name and res_class arguments specify the resource name and class of the
application. They are intended to be used as prefixes by the output method
when looking up resources that are common to all output contexts that may be
created for this output method. The characters used for resource names and
classes must be in the X Portable Character Set. The resources looked up are
not fully specified if res_name or res_class is NULL.
The res_name and res_class arguments are not assumed to exist beyond the call to
XOpenOM. The specified resource database is assumed to exist for the
lifetime of the output method.
XOpenOM returns NULL if no output method could be opened.
The
XCloseOM function closes the specified output method.
The
XSetOMValues function presents a variable argument list programming
interface for setting properties or features of the specified output method.
This function returns NULL if it succeeds; otherwise, it returns the name of
the first argument that could not be set. Xlib does not attempt to set
arguments from the supplied list that follow the failed argument; all
arguments in the list preceding the failed argument have been set correctly.
No standard arguments are currently defined by Xlib.
The
XGetOMValues function presents a variable argument list programming
interface for querying properties or features of the specified output method.
This function returns NULL if it succeeds; otherwise, it returns the name of
the first argument that could not be obtained.
The
XDisplayOfOM function returns the display associated with the
specified output method.
The
XLocaleOfOM returns the locale associated with the specified output
method.
SEE ALSO
XCreateOC(3), XCreateFontSet(3)
Xlib - C Language X Interface