diff options
Diffstat (limited to 'man/XpGetAttributes.man')
-rw-r--r-- | man/XpGetAttributes.man | 118 |
1 files changed, 118 insertions, 0 deletions
diff --git a/man/XpGetAttributes.man b/man/XpGetAttributes.man new file mode 100644 index 0000000..6c84b09 --- /dev/null +++ b/man/XpGetAttributes.man @@ -0,0 +1,118 @@ +.\" $XdotOrg: $ +.\" +.\" Copyright 1996 Hewlett-Packard Company +.\" Copyright 1996 International Business Machines Corp. +.\" Copyright 1996, 1999, 2004 Sun Microsystems, Inc. +.\" Copyright 1996 Novell, Inc. +.\" Copyright 1996 Digital Equipment Corp. +.\" Copyright 1996 Fujitsu Limited +.\" Copyright 1996 Hitachi, Ltd. +.\" Copyright 1996 X Consortium, Inc. +.\" +.\" Permission is hereby granted, free of charge, to any person obtaining a +.\" copy of this software and associated documentation files (the "Software"), +.\" to deal in the Software without restriction, including without limitation +.\" the rights to use, copy, modify, merge, publish, distribute, +.\" sublicense, and/or sell copies of the Software, and to permit persons +.\" to whom the Software is furnished to do so, subject to the following +.\" conditions: +.\" +.\" The above copyright notice and this permission notice shall be +.\" included in all copies or substantial portions of the Software. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +.\" EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +.\" IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, +.\" DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR +.\" OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR +.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE. +.\" +.\" Except as contained in this notice, the names of the copyright holders +.\" shall not be used in advertising or otherwise to promote the sale, use +.\" or other dealings in this Software without prior written authorization +.\" from said copyright holders. +.\" +.TH XpGetAttributes 3Xp __xorgversion__ "XPRINT FUNCTIONS" +.SH NAME +XpGetAttributes \- Gets an attribute pool from the specified print context. +.SH SYNOPSIS +.br + cc [ flag... ] file... -lXp [ library... ] +.br + #include <X11/extensions/Print.h> +.LP +.B char *XpGetAttributes +( +.I display, +.I context, +.I type +) +.br + Display *\fIdisplay\fP\^; +.br + XPContext \fIcontext\fP\^; +.br + XPAttributes \fItype\fP\^; +.if n .ti +5n +.if t .ti +.5i +.SH ARGUMENTS +.TP +.I display +Specifies a pointer to the Display structure; returned from XOpenDisplay. +.TP +.I context +The print context from which the attribute pool is to be retrieved. +.TP +.I type +Specifies the attribute pool. +.SH DESCRIPTION +.LP +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, +.I XpGetAttributes +returns NULL. +.SH STRUCTURES +The values for the typedef XPAttributes in <X11/extensions/Print.h> are: +.nf + #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 */ +.LP +.fi +.SH DIAGNOSTICS +.TP 15 +.SM BadAlloc +Insufficient memory. +.TP 15 +.SM BadValue +The value specified for type is not valid. +.TP 15 +.SM XPBadContext +The specified print context-id is not valid. +.SH FILES +.PD 0 +.TP 20 +.B <X11/extensions/Print.h> +.SH "SEE ALSO" +.BR XpCreateContext (3Xp) + + |