Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XmtSymbolAddCallback(3)     Library Functions Manual	 XmtSymbolAddCallback(3)

NAME
     XmtSymbolAddCallback(), XmtSymbolRemoveCallback() - add and remove a proce-
     dure to be called when a symbol's value changes.

SYNOPSIS
     #include <Xmt/Symbols.h>

     void XmtSymbolAddCallback(XmtSymbol s, XmtSymbolCallbackProc proc,
		    XtPointer client_data)

     void XmtSymbolRemoveCallback(XmtSymbol s, XmtSymbolCallbackProc proc,
		    XtPointer client_data)

     typedef void (*XmtSymbolCallbackProc)(XmtSymbol s, XtPointer client_data,
		    XtArgVal value);

ARGUMENTS
     INPUTS

	  s	 An XmtSymbol for which the callback is to be added or removed.

	  proc	 The procedure to be added or removed.

	  client_data
		 An  untyped  data  value registered (or removed) with proc, and
		 which is passed as the second argument to proc when it  is  in-
		 voked.

	  value  The untyped value of the symbol. This argument is not passed to
		 XmtSymbolAddCallback()  or XmtSymbolRemoveCallback(), but it is
		 the third argument passed to the registered  XmtSymbolCallback-
		 Proc proc when it is invoked.

DESCRIPTION
     XmtSymbolAddCallback()  registers the procedure proc to be invoked with the
     specified client_data whenever the value of symbol s changes.

     XmtSymbolRemoveCallback() unregisters the proc/client_data pair for  symbol
     s.  This  procedure will no longer be called with the specified client_data
     when the value of s is updated.

     proc is an XmtSymbolCallbackProc. It will be invoked with three  arguments.
     The  first  argument to a symbol callback is the XmtSymbol that has had its
     value changed. The second argument is whatever untyped client_data was reg-
     istered with the callback procedure, and the third argument, value, is  the
     new  value of the symbol. This is either the value itself, or, if the value
     is too large to fit in an XtArgVal (or if it is of type XmtRBuffer), it  is
     a pointer to the value.

SEE ALSO
     Chapter 12, Symbols,
     XmtLookupSymbol(), XmtSymbolGetValue(), XmtSymbolSetValue(),
     XmtSymbolSetTypedValue(), XmtVaRegisterSymbols().

Xmt				   Motif Tools		 XmtSymbolAddCallback(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmtSymbolRemoveCallback&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help