This manual page is for Mac OS X version 10.6.3

Reading manual pages

XpGetAttributes(3Xp)                          XPRINT FUNCTIONS                          XpGetAttributes(3Xp)



NAME
       XpGetAttributes - Gets an attribute pool from the specified print context.

SYNOPSIS
             cc [ flag... ] file... -lXp [ library... ]
             #include <X11/extensions/Print.h>

       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 spec-ified specified
       ified 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 of many name-value pairs (for example, "copy-count: "copycount:
       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 derived from  the  Posix  which  is  "a"-"z"  and
       "A"="Z" and"0"-"9" and "_" and "-". Valid characters for each value (right hand side) are all charac-ters characters
       ters except NULL and unescaped NEWLINE, though all predefined values in the X Print Service are  con-fined confined
       fined  to X Portable Character Set (XPCS) characters. Non XPCS values are typically limited to local-ized localized
       ized "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 <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 */


DIAGNOSTICS
       BadAlloc       Insufficient memory.

       BadValue       The value specified for type is not valid.

       XPBadContext   The specified print context-id is not valid.

FILES
       <X11/extensions/Print.h>
SEE ALSO
       XpCreateContext(3Xp)





X Version 11                                     libXp 1.0.0                            XpGetAttributes(3Xp)