xpgetoneattribute(3xp) [suse man page]

XpGetOneAttribute(3Xp)						 XPRINT FUNCTIONS					    XpGetOneAttribute(3Xp)

NAME

       XpGetOneAttribute -  Gets a single print attribute from the specified print context.

SYNOPSIS

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

       char *XpGetOneAttribute ( display, context, type, attribute_name )
	     Display *display;
	     XPContext context;
	     XPAttributes type;
	     char *attribute_name;

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.

       attribute_name
	      The name of the attribute to be returned.

DESCRIPTION

       This  request  returns a COMPOUND_TEXT string attribute_value, else NULL if any errors occurred.  XpGetOneAttribute is a variation of XpGe-
       tAttributes 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.

DIAGNOSTICS

       BadAlloc       Insufficient memory.

       BadValue       The value specified for type is not valid.

       XPBadContext   The specified print context-id is not valid.

SEE ALSO

       XpGetAttributes(3Xp)

X Version 11							    libXp 1.0.0 					    XpGetOneAttribute(3Xp)

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