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

FreeBSD Manual Pages

  
 
  

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

NAME
     XmtAddDeleteCallback(),  XmtAddSaveYourselfCallback()  - register callbacks
     for session management protocols.

SYNOPSIS
     #include <Xmt/Xmt.h>
     void XmtAddDeleteCallback(Widget shell, int response, XtCallbackProc proc,
		    XtPointer data)

     void XmtAddSaveYourselfCallback(Widget shell, XtCallbackProc proc,
		    XtPointer data)

ARGUMENTS
     INPUTS

	  shell  The shell widget that is to have the callback	registered.  May
		 be  any  shell  for XmtAddDelete Callback(). Must be a toplevel
		 ApplicationShell for XmtAddSaveYourselfCallback().

	  response
		 A value to be set on the XmNdeleteResponse resource, for XmtAd-
		 dDeleteCallback() only.

	  proc	 The callback procedure to register. This is a nor mal Xt  call-
		 back  procedure.  When  invoked, it will be passed shell as its
		 first argument and data as its second argument. Its third argu-
		 ment will be unused.

	  data	 An arbitrary untyped value to pass to the callback procedure as
		 its second, client_data argument.

DESCRIPTION
     XmtAddDeleteCallback() sets the Motif VendorShell	XmNdelete  Response  re-
     source  of shell to response, and calls XmAdd WMProtocolCallback() to spec-
     ify that the callback proc should be invoked when	that  shell  receives  a
     WM_DELETE_WINDOW  message	from  the window manager or the session manager.
     The value of response specifies what actions the shell should perform auto-
     matically in response to this message, and the procedure proc  can  perform
     any other, custom actions.

     XmtAddSaveYourselfCallback()  registers a procedure proc to be invoked when
     the specified shell receives a WM_SAVE_YOURSELF message  from  the  session
     manager.  In order to comply with the WM_SAVE_YOURSELF protocol, there must
     be no more than one callback registered per application, and  the	callback
     must set the WM_COMMAND property of the shell window before returning. Note
     that  this  function  does not have a response/ argument, since there is no
     equivalent to the XmNdelete Response resource for the WM_SAVE_YOURSELF ses-
     sion management protocol. Also note that this  protocol  is  replaced  with
     much more sophisticated session management facilities in X11R6.

SEE ALSO
     Chapter 16, Working with the Session Manager, Inter-client Communications
     Conventions Manual, VendorShell, XmAddWMProtocolCallback()

Xmt				   Motif Tools		 XmtAddDeleteCallback(3)

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

home | help