X Version 11
Release 6.4
X Print Service Extension Library
21
vice are confined to X Portable Character Set (XPCS) characters. Non XPCS values are typically limited to
localized "description" strings. See
XpCreateContext regarding the locale hint for more information on local-
ized values.
XpGetAttributes can generate of one of the following errors:
XPBadContext
The specified print context-id is not valid.
BadValue
The value specified for type is not valid.
BadAlloc
Insufficient memory.
If any errors occur,
XpGetAttributes returns NULL.
Use
XpGetOneAttribute to get a single print attribute from the specified print context.
char *XpGetOneAttribute (display, context, type, attribute_name)
Display *display;
XPContext context;
XPAttributes type;
char *attribute_name;
display
Specifies a pointer to the Display structure; returned from XOpenDisplay.
context
The print context from which the attribute pool is to be retrieved.
type
Specifies the attribute pool.
attribute_name
The name of the attribute to be returned.
This request returns a COMPOUND_TEXT string attribute_value, else
NULL if any errors occurred.
XpGetOneAttribute is a variation of XpGetAttributes to get a single attribute value from an attribute pool. Unlike
XpGetAttributes, where the reply contains an entire attribute pool, XpGetOneAttribute returns just one
attribute_value.
attribute_name should not include a colon. The caller is expected to free the attribute value returned using
XFree.
XpGetOneAttribute can generate of one of the following errors:
XPBadContext
The specified print context-id is not valid.
BadValue
The value specified for type is not valid.
BadAlloc
Insufficient memory.
Use
XpSetAttributes to set or update an attribute pool in the specified print context.
void XpSetAttributes (display, context, type, pool, replacement_rule)
Display *display;
XPContext context;
XPAttributes type;
char *pool;
XPAttrReplacement replacement_rule;
display
Specifies a pointer to the Display structure; returned from XOpenDisplay.
context
The print context whose attribute pool is to be modified.
type
Specifies the attribute pool to be modified.
pool
An attribute pool represented as a resource string. Encoded in COMPOUND_TEXT.
replacement_rule Either XPAttrReplace orXPAttrMerge.