


XmActivateProtocol(3X)				       XmActivateProtocol(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmAAccttiivvaatteePPrroottooccooll - A VendorShell function that activates a protocol

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mA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mA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mAAccttiivvaatteePPrroottooccooll activates a protocol.  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,	and so on) to persist, even
  though the client may	choose to temporarily resign from the interaction.
  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mA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mAAccttiivvaatteePPrroottoo--
  c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	AAttoomm (or an iinntt	type cast to AAttoomm).

  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mA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)).















