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