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