XpSetAttributes

XpSetAttributes

NAME
SYNOPSIS
ARGUMENTS
DESCRIPTION
STRUCTURES
DIAGNOSTICS
FILES
SEE ALSO

---

NAME

XpSetAttributes − Sets or updates an attribute pool in the specified print context.

SYNOPSIS

cc [ flag... ] file... -lXp [ library... ]

#include <X11/extensions/Print.h>

void XpSetAttributes ( display, context, type, pool, replacement_rule )
Display *display;
XPContext context;
XPAttributes type;
char *pool;
XPAttrReplacement replacement_rule;

ARGUMENTS

display

Specifies a pointer to the Display structure; returned from XOpenDisplay.

context

The print context whose attribute pool is to be modified.

	type		Specifies the attribute pool.
	pool		An attribute pool represented as a resource string. Encoded in COMPOUND_TEXT.

replacement_rule

Either XPAttrReplace orXPAttrMerge.

DESCRIPTION

XpSetAttributes accepts pool, a COMPOUND_TEXT resource string representing new name-value pairs for the attribute pool specified by type. The attribute pool is modified by the new name-value pairs according to replacement_rule. For XPAttrReplace, the existing attribute pool is discarded and replaced with pool. For XPAttrMerge, pool is merged into the existing attribute pool; pre-existing name-value pairs are replaced, and non-existing name-value pairs are added. The contents of pool is not affected by this call, and can be freed by the caller afterwards.

When setting supported attribute names, the X Print Server and associated driver will validate the new values and ignore those that are invalid; previous values remain unchanged. When setting unsupported (that is, unknown) attribute names, no validation is done, and the name-value pairs will be set, even though they will not be used. When deleting (that is, failing to reset with XPAttrReplace) a supported attribute name, the X Print Server explicitly or implicitly resets the attribute to a default value.

When setting certain supported attributes, the X Print Server may modify other associated attributes. For example, considering the XPPrinterAttr attribute document-formats-supported, setting the XPDocAttr attribute document-format may cause a number of other attributes to change.

For attribute pools that are read-only (see "get only" in XPAttributes definition), attempting to use XpSetAttributes generates a BadMatch. For attribute pools that are writable, lists of the supported attributes can be found in the XPPrinterAttr pool.

The lifetime of all attribute pools are bounded by the lifetime of the print context they are contained in. When set, all attribute values will be retained across all Xp operations, until changed by the user directly, the X Print Server directly, or changed because of a side effect when either the user or X Print Server changed another attribute value.

Refer to a complete description of all print attributes, the precedence between print attributes, and the side effects of setting certain print attributes on other print attributes, etc.

To monitor changes to the attribute pools, see XpSelectInput and the event XPAttributeNotify. Since a print context can be shared among clients, changes made by one client will be seen by all others, and if selected for, the event XPAttributeNotify will be sent to all clients referencing the print context when changes do occur. It is the responsibility of the clients sharing a print context to coordinate their operations.

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 */

The values for the typedef XPAttrReplacement in <X11/extensions/Print.h> are:

#define XPAttrReplace					1 #define XPAttrMerge
					2

DIAGNOSTICS

	BadAlloc		Insufficient memory.
	BadMatch		The attribute pool specified by pool cannot be set.
	BadValue		The value specified for type is not valid.
	XPBadContext		The specified print context-id is not valid.
	XPBadSequence		A request to set an attribute pool occurred at a time when the attribute pool could not be modified (for example, modifying XPJobAttr immediately after calling XpStartJob).

FILES

<X11/extensions/Print.h>

SEE ALSO

XpSelectInput(3Xp), XpStartJob(3Xp)

---

---

Opportunity

Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.

---

---

Free Software

Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

---

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.

---

---

Free Books

The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

---

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.

---

---

Education

Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

---

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.

---