XUniqueContext(3X) — A/UX 3.0.1




XSaveContext(3X)                                 XSaveContext(3X)



NAME
     XSaveContext, XFindContext, XDeleteContext, XUniqueContext -
     manipulate the context manager

SYNOPSIS
     int XSaveContext (display, w, context, data)
     Display *display;
     Window w;
     XContext context;
     caddr_t data;

     int XFindContext (display, w, context, data-return)
     Display *display;
     Window w;
     XContext context;
     caddr_t *data-return;

     int XDeleteContext (display, w, context)
     Display *display;
     Window w;
     XContext context;

     XContext XUniqueContext ();

DESCRIPTION
     The XSaveContext function saves a data value corresponding
     to a window and context type.  If an entry with the speci-
     fied window and type already exists, XSaveContext overrides
     it with the specified context.  The XSaveContext function
     returns a nonzero error code if an error occurs and zero
     otherwise.  Possible errors include XCNOMEM (out of memory).

     The XFindContext function gets a pointer to the data associ-
     ated with a window and type.  The XFindContext function re-
     turns a nonzero value if an error occurs and zero otherwise.
     Possible errors include XCNOENT (context-not-found).
     XDeleteContext function deletes an entry for a given window
     and type from the data structure.  This function returns the
     same errors codes as XFindContext when called with the same
     arguments.  XDeleteContext does not free the data whose ad-
     dress was saved.

     The XUniqueContext function creates a unique context type
     that can be used in subsequent calls to XSaveContext.

   Arguments
     These functions accept the following arguments:

     context Specifies the context type to which the data be-
             longs.

     data    Specifies the data to be associated with the window



November, 1990                                                  1




XSaveContext(3X)                                 XSaveContext(3X)



             and type.

     data-return
             Returns a pointer to the data.

     display Specifies the connection to the X server.

     w       Specifies the window with which the data is associ-
             ated.

SEE ALSO
     Xlib - C Language Interface











































2                                                  November, 1990

Museum