X Version 11 (Release 6.1)
XSetState(X3xlib)
XSetState --
GC convenience routines
Synopsis
XSetState(display, gc, foreground, background, function, plane_mask)
Display *display;
GC gc;
unsigned long foreground, background;
int function;
unsigned long plane_mask;
XSetFunction(display, gc, function)
Display *display;
GC gc;
int function;
XSetPlaneMask(display, gc, plane_mask)
Display *display;
GC gc;
unsigned long plane_mask;
XSetForeground(display, gc, foreground)
Display *display;
GC gc;
unsigned long foreground;
XSetBackground(display, gc, background)
Display *display;
GC gc;
unsigned long background;
Arguments
background-
Specifies the background you want to set for the specified GC.
display-
Specifies the connection to the X server.
foreground-
Specifies the foreground you want to set for the specified GC.
function-
Specifies the function you want to set for the specified GC.
gc-
Specifies the GC.
plane_mask-
Specifies the plane mask.
Description
The XSetState function sets the foreground,
background, plane mask, and function components
for the specified GC.
XSetState can generate ``BadAlloc'',
``BadGC'', and ``BadValue'' errors.
XSetFunction
sets a specified value in the specified GC.
XSetFunction can generate ``BadAlloc'',
``BadGC'', and ``BadValue'' errors.
The XSetPlaneMask
function sets the plane mask in the specified GC.
XSetPlaneMask can generate ``BadAlloc''
and ``BadGC'' errors.
The XSetForeground
function sets the foreground in the specified GC.
XSetForeground can generate ``BadAlloc''
and ``BadGC'' errors.
The XSetBackground
function sets the background in the specified GC.
XSetBackground can generate ``BadAlloc''
and ``BadGC'' errors.
Diagnostics
``BadAlloc''-
The server failed to allocate the requested resource or server memory.
``BadGC''-
A value for a GContext argument does not name a defined GContext.
``BadValue''-
Some numeric value falls outside the range of values accepted by the request.
Unless a specific range is specified for an argument, the full range defined
by the argument's type is accepted. Any argument defined as a set of
alternatives can generate this error.
References
XCreateGC(X3xlib),
XQueryBestSize(X3xlib),
XSetArcMode(X3xlib),
XSetClipOrigin(X3xlib),
XSetFillStyle(X3xlib),
XSetFont(X3xlib),
XSetLineAttributes(X3xlib),
XSetTile(X3xlib)
Xlib - C Language X Interface
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004