XOpenOM
Section: XLIB FUNCTIONS (3)
Updated: libX11 1.6.4
Index
Return to Main Contents
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
Index
- NAME
-
- SYNTAX
-
- ARGUMENTS
-
- DESCRIPTION
-
- SEE ALSO
-