xmactivateprotocol(3x) [osf1 man page]

XmActivateProtocol(3X)													    XmActivateProtocol(3X)

NAME

       XmActivateProtocol - A VendorShell function that activates a protocol

SYNOPSIS

       #include <Xm/Xm.h> #include <Xm/Protocols.h>

       void XmActivateProtocol (shell, property, protocol)
	       Widget shell;
	       Atom property;
	       Atom protocol;

       void XmActivateWMProtocol (shell, protocol)
	       Widget shell;
	       Atom protocol;

DESCRIPTION

       XmActivateProtocol  activates  a  protocol.   It updates the handlers and the property if the shell 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 protocol to be in one of two states:	active or inactive.  If the protocol is active and
       the shell is realized, the property contains the protocol Atom. If the protocol is inactive, the Atom is not present in the property.

       XmActivateWMProtocol is a convenience interface.  It calls XmActivateProtocol with the property value set to the atom returned by interning
       WM_PROTOCOLS.  Specifies the widget with which the protocol property is associated.  Specifies the protocol property.  Specifies the proto-
       col Atom (or an int type cast to Atom).

       For a complete definition of VendorShell and its associated resources, see VendorShell(3X).

SEE ALSO

       VendorShell(3X), XmActivateWMProtocol(3X), XmInternAtom(3X)

															    XmActivateProtocol(3X)

XmDeactivateProtocol(library call)										XmDeactivateProtocol(library call)

NAME

       XmDeactivateProtocol -- A VendorShell function that deactivates a protocol without removing it

SYNOPSIS

       #include <Xm/Xm.h>
       #include <Xm/Protocols.h>
       void XmDeactivateProtocol(
       Widget shell,
       Atom property,
       Atom protocol);

DESCRIPTION

       XmDeactivateProtocol  deactivates a protocol without removing it.  It updates the handlers and the property if the shell 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  tem-
       porarily  resign  from  the  interaction.  The main use of this capability is to gray/ungray f.send_msg entries in the MWM system menu.	To
       support this capability, protocol is allowed to be in one of two states: active or inactive.  If protocol is active and shell is  realized,
       property contains the protocol Atom.  If protocol is inactive, Atom is not present in the property.

       XmDeactivateWMProtocol  is  a  convenience  interface.	It  calls XmDeactivateProtocol with the property value set to the atom returned by
       interning WM_PROTOCOLS.

       shell	 Specifies the widget with which the protocol property is associated

       property  Specifies the protocol property

       protocol  Specifies the protocol atom

       For a complete definition of VendorShell and its associated resources, see VendorShell(3).

RELATED

       mwm(1), VendorShell(3), XmActivateProtocol(3), XmDeactivateWMProtocol(3), and XmInternAtom(3).

														XmDeactivateProtocol(library call)