Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

NAME

XFindContext − get data from the context manager (not graphics context). 

Synopsis

int XFindContext(display, rid, context, data_return)
Display *display;
XID rid;
XContext context;
XPointer *data_return;

Arguments

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

ridSpecifies the resource ID with which the data is associated. 

contextSpecifies the context type to which the data corresponds. 

data_return
Returns the data.

Description

XFindContext() gets data that has been assigned to the specified resource ID.  The context manager is used to associate data with windows for use within an application.  This application should have called XUniqueContext() to get a unique ID, and then XSaveContext() to save the data into the array.  The meaning of the data is indicated by the context ID, but is completely up to the client.  XFindContext() returns XCNOENT (a nonzero error code) if the context could not be found and zero (0) otherwise.  For more information on the context manager, see Volume One, Chapter 13, Other Programming Techniques. 

Structures

typedef int XContext;

See Also

XDeleteContext(), XSaveContext(), XUniqueContext(). 

Copyright O’Reilly & Assoc.  —  

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026