


XmSetProtocolHooks(3X)				       XmSetProtocolHooks(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmSSeettPPrroottooccoollHHooookkss - A VendorShell function that allows pre and post
  actions to be	executed when a	protocol message is received from MWM

SYNOPSIS


  ##iinncclluuddee <<XXmm//XXmm..hh>>
  ##iinncclluuddee <<XXmm//PPrroottooccoollss..hh>>
  vvooiidd XXmmSSeettPPrroottooccoollHHooookkss ((_s_h_e_l_l, _p_r_o_p_e_r_t_y, _p_r_o_t_o_c_o_l, _p_r_e_h_o_o_k,
	    _p_r_e__c_l_o_s_u_r_e, _p_o_s_t_h_o_o_k, _p_o_s_t__c_l_o_s_u_r_e))
       WWiiddggeett	      _s_h_e_l_l;;
       AAttoomm	      _p_r_o_p_e_r_t_y;;
       AAttoomm	      _p_r_o_t_o_c_o_l;;
       XXttCCaallllbbaacckkPPrroocc _p_r_e_h_o_o_k;;
       XXttPPooiinntteerr      _p_r_e__c_l_o_s_u_r_e;;
       XXttCCaallllbbaacckkPPrroocc _p_o_s_t_h_o_o_k;;
       XXttPPooiinntteerr      _p_o_s_t__c_l_o_s_u_r_e;;
  vvooiidd XXmmSSeettWWMMPPrroottooccoollHHooookkss ((_s_h_e_l_l, _p_r_o_t_o_c_o_l, _p_r_e_h_o_o_k, _p_r_e__c_l_o_s_u_r_e,
	    _p_o_s_t_h_o_o_k, _p_o_s_t__c_l_o_s_u_r_e))
       WWiiddggeett	      _s_h_e_l_l;;
       AAttoomm	      _p_r_o_t_o_c_o_l;;
       XXttCCaallllbbaacckkPPrroocc _p_r_e_h_o_o_k;;
       XXttPPooiinntteerr      _p_r_e__c_l_o_s_u_r_e;;
       XXttCCaallllbbaacckkPPrroocc _p_o_s_t_h_o_o_k;;
       XXttPPooiinntteerr      _p_o_s_t__c_l_o_s_u_r_e;;

DESCRIPTION
  XXmmSSeettPPrroottooccoollHHooookkss is	used by	shells that want to have pre and post actions
  executed when	a protocol message is received from MWM.  Since	there is no
  guaranteed ordering in execution of event handlers or	callback lists,	this
  allows the shell to control the flow while leaving the protocol manager
  structures opaque.

  XXmmSSeettWWMMPPrroottooccoollHHooookkss is a convenience	interface.  It calls XXmmSSeettPPrroottoo--
  ccoollHHooookkss with	the property value set to the atom returned by interning
  WWMM__PPRROOTTOOCCOOLLSS.

  _s_h_e_l_l	    Specifies the widget with which the	protocol property is associ-
	    ated

  _p_r_o_p_e_r_t_y  Specifies the protocol property

  _p_r_o_t_o_c_o_l  Specifies the protocol atom	(or an int cast	to Atom)

  _p_r_e_h_o_o_k   Specifies the procedure to call before calling entries on the
	    client callback-list

  _p_r_e__c_l_o_s_u_r_e
	    Specifies the client data to be passed to the prehook when it is
	    invoked

  _p_o_s_t_h_o_o_k  Specifies the procedure to call after calling entries on the
	    client callback-list

  _p_o_s_t__c_l_o_s_u_r_e
	    Specifies the client data to be passed to the posthook when	it is
	    invoked

  For a	complete definition of VendorShell and its associated resources, see
  VVeennddoorrSShheellll((33XX)).

RELATED	INFORMATION
  VVeennddoorrSShheellll((33XX)), XXmmIInntteerrnnAAttoomm((33XX)), and XXmmSSeettWWMMPPrroottooccoollHHooookkss((33XX)).




























































