Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

tk_setclassprocs(3tk) [opensolaris man page]

Tk_SetClassProcs(3TK)					       Tk Library Procedures					     Tk_SetClassProcs(3TK)

__________________________________________________________________________________________________________________________________________________

NAME

       Tk_SetClassProcs - register widget specific procedures

SYNOPSIS

       #include <tk.h>

       Tk_SetClassProcs(tkwin, procs, instanceData)

ARGUMENTS

       Tk_Window      tkwin	     (in)      Token for window to modify.

       Tk_ClassProcs  *procs	     (in)      Pointer	to data structure containing widget specific procedures.  The data structure pointed to by
					       procs must be static: Tk keeps a reference to it as long as the window exists.

       ClientData     instanceData   (in)      Arbitrary one-word value to pass to widget callbacks.
_________________________________________________________________

DESCRIPTION

       Tk_SetClassProcs is called to register a set of procedures that are used as callbacks in different places.

       The structure pointed to by procs contains the following:
	      typedef struct Tk_ClassProcs {
		unsigned int size;
		Tk_ClassWorldChangedProc *worldChangedProc;
		Tk_ClassCreateProc *createProc;
		Tk_ClassModalProc *modalProc;
	      } Tk_ClassProcs;
       The size field is used to simplify future expansion of the structure. It should always be set to (literally) sizeof(Tk_ClassProcs).

       worldChangedProc is invoked when the system has altered in some way that requires some reaction from the widget.  For example, when a  font
       alias (see the font manual entry) is reconfigured, widgets configured to use that font alias must update their display accordingly.  world-
       ChangedProc should have arguments and results that match the type Tk_ClassWorldChangedProc:
	      typedef void Tk_ClassWorldChangedProc(
		ClientData instanceData);
       The instanceData parameter passed to the worldChangedProc will be identical to the instanceData paramter passed to Tk_SetClassProcs.

       createProc is used to create platform-dependant windows.  It is invoked	by  Tk_MakeWindowExist.   createProc  should  have  arguments  and
       results that match the type Tk_ClassCreateProc:
	      typedef Window Tk_ClassCreateProc(
		Tk_Window tkwin,
		Window parent,
		ClientData instanceData);
       The  tkwin  and	instanceData parameters will be identical to the tkwin and instanceData parameters passed to Tk_SetClassProcs.	The parent
       parameter will be the parent of the window to be created.  The createProc should return the created window.

       modalProc is invoked after all bindings on a widget have been triggered in order to handle a modal loop.  modalProc should  have  arguments
       and results that match the type Tk_ClassModalProc:
	      typedef void Tk_ClassModalProc(
		Tk_Window tkwin,
		XEvent *eventPtr);
       The  tkwin  parameter  to  modalProc will be identical to the tkwin parameter passed to Tk_SetClassProcs.  The eventPtr parameter will be a
       pointer to an XEvent structure describing the event being processed.

KEYWORDS

       callback, class

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES

       Source for Tk is available on http://opensolaris.org.

Tk									8.4						     Tk_SetClassProcs(3TK)

Check Out this Related Man Page

Tk_OwnSelection(3TK)					       Tk Library Procedures					      Tk_OwnSelection(3TK)

__________________________________________________________________________________________________________________________________________________

NAME

       Tk_OwnSelection - make a window the owner of the primary selection

SYNOPSIS

       #include <tk.h>

       Tk_OwnSelection(tkwin, selection, proc, clientData)

ARGUMENTS

       Tk_Window	tkwin	     (in)      Window that is to become new selection owner.

       Atom		selection    (in)      The name of the selection to be owned, such as XA_PRIMARY.

       Tk_LostSelProc	*proc	     (in)      Procedure to invoke when tkwin loses selection ownership later.

       ClientData	clientData   (in)      Arbitrary one-word value to pass to proc.
_________________________________________________________________

DESCRIPTION

       Tk_OwnSelection	arranges  for  tkwin to become the new owner of the selection specified by the atom selection.	After this call completes,
       future requests for the selection will be directed to handlers created for tkwin using Tk_CreateSelHandler.  When  tkwin  eventually  loses
       the  selection  ownership, proc will be invoked so that the window can clean itself up (e.g. by unhighlighting the selection).  Proc should
       have arguments and result that match the type Tk_LostSelProc:
	      typedef void Tk_LostSelProc(ClientData clientData);
       The clientData parameter to proc is a copy of the clientData argument given to Tk_OwnSelection, and is usually a pointer to a  data  struc-
       ture containing application-specific information about tkwin.

KEYWORDS

       own, selection owner

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES

       Source for Tk is available on http://opensolaris.org.

Tk									4.0						      Tk_OwnSelection(3TK)
Man Page