Functional specification
40
CDE/Motif PST
CDEnext
RETURN VALUE
A
COMPOUND_TEXT
resource string
pool
, else
NULL
if any errors occured.
DESCRIPTION
XpGetAttributes
returns
pool
, a
COMPOUND_TEXT
resource string representing the attribute pool
specified by
type
. The caller is expected to free
pool
when it is no longer needed using
XFree(3)
.
The values for the typedef
XPAttributes
in
<X11/extensions/Print.h>
are:
#define XPJobAttr
1
/* get/set */
#define XPDocAttr
2
/* get/set */
#define XPPageAttr
3
/* get/set - subset of XPDocAttr */
#define XPPrinterAttr
4
/* get only (library) */
#define XPServerAttr
5
/* get only (library), no context needed */
The attribute pool (hence the resource string) consists of many name-value pairs (for example,
`copy-
count: 3'
). The syntax of an attribute pool is the same as an X resource file (see "Resource Manager
Functions, Section 15.1" in X Window System for X11R5 by Scheifler and Gettys).
Valid characters for each name (left hand side) are derived from the Posix Portable Filename Character Set
(PPFCS), which is
"a"-"z"
and
"A"-"Z"
and
"0"-"9"
and
"_"
and
"-"
. Valid characters for each
value (right hand side) are all characters except
NULL
and unescaped
NEWLINE
, though all predefined
values in the X Print Service 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 localized values.
ERRORS/WARNINGS
The function 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.
SEE ALSO
XpCreateContext
2.16
XpGetOneAttribute
SHORT DESCRIPTION
Get a single print attribute from the specified print context.