


XmDeactivateProtocol(3X)			     XmDeactivateProtocol(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmDDeeaaccttiivvaatteePPrroottooccooll - A VendorShell function	that deactivates a protocol
  without removing it

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mDDeeaaccttiivvaatteePPrroottooccooll ((_s_h_e_l_l, _p_r_o_p_e_r_t_y, _p_r_o_t_o_c_o_l))
       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;;
  vvooiidd XXmmDDeeaaccttiivvaatteeWWMMPPrroottooccooll ((_s_h_e_l_l, _p_r_o_t_o_c_o_l))
       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;;

DESCRIPTION
  XXmmDDeeaaccttiivvaatteePPrroottooccooll deactivates a protocol without removing it.  It
  updates the handlers and the _p_r_o_p_e_r_t_y, if the	_s_h_e_l_l is realized.  It is
  sometimes useful to allow a protocol's state information (callback lists,
  etc.)	to persist, even though	the client may choose to temporarily resign
  from the interaction.	 The main use of this capability is to gray/ungray
  ff..sseenndd__mmssgg entries in	the Mwm	system menu.  This is supported	by allowing a
  _p_r_o_t_o_c_o_l to be in one	of two states:	active or inactive.  If	the _p_r_o_t_o_c_o_l
  is active and	the _s_h_e_l_l is realized, the _p_r_o_p_e_r_t_y contains the _p_r_o_t_o_c_o_l
  AAttoomm.	 If the	_p_r_o_t_o_c_o_l is inactive, the AAttoomm is not present in the _p_r_o_-
  _p_e_r_t_y.

  XXmmDDeeaaccttiivvaatteeWWMMPPrroottooccooll is a convenience interface.  It calls XXmmDDeeaaccttiivvaa--
  tteePPrroottooccooll 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 associated

  _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	type cast to Atom)

  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
  mmwwmm((11XX)), VVeennddoorrSShheellll((33XX)), XXmmDDeeaaccttiivvaatteeWWMMPPrroottooccooll((33XX)),	and XXmmIInntteerrnnAAttoomm((33XX)).












