DragonFly On-Line Manual Pages

Search: Section:  

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 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 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 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 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.

       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.3             XpGetAttributes(3Xp)

Search: Section: