XPRINT FUNCTIONS XpGetAttributes(3Xp)
NAME
XpGetAttributes - Gets an attribute pool from the specified
print context.SYNOPSIS
cc [ flag... ] file... -lXp [ library... ]
cc [ flag... ] file... -lXp [ library... ]
#include
char *XpGetAttributes ( display, context, type )
Display *display; XPContext context; XPAttributes type; ARGUMENTS 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.DESCRIPTION
XpGetAttributes returns a 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. The attribute pool (hence the resource string) consists ofmany name-value pairs (for example, "copy-count: 3"). The
syntax of an attribute pool is the same as an X resource file (see "Resource File Syntax" in the Xlib specification). Valid characters for each name (left hand side) are derivedfrom the Posix 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 con-
fined 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.If any errors occur, XpGetAttributes returns NULL.
STRUCTURES The values for the typedef XPAttributes in
are: #define XPJobAttr 1 /* get/set */
X Version 11 Last change: libXp 1.0.0 1XPRINT FUNCTIONS XpGetAttributes(3Xp)
#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 */
DIAGNOSTICS BadAlloc Insufficient memory. BadValue The value specified for type is not valid.XPBadContext The specified print context-id is not valid.
FILES
SEE ALSO
XpCreateContext(3Xp)ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | x11/library/libxp ||_____________________________|_____________________________|
| Interface Stability | Committed ||_____________________________|_____________________________|
| MT-Level | See XInitThreads(3X11) |
|_____________________________|_____________________________|
X Version 11 Last change: libXp 1.0.0 2