XmDeactivateProtocol(3X) OSF XmDeactivateProtocol(3X)
NAME
XmDeactivateProtocol-A VendorShell function that deactivates
a protocol without removing it
SYNOPSIS
#include <Xm/Xm.h>
#include <Xm/Protocols.h>
void XmDeactivateProtocol (shell, property, protocol)
Widget shell;
Atom property;
Atom protocol;
void XmDeactivateWMProtocol (shell, protocol)
Widget shell;
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, 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.sendmsg entries in the Mwm system menu. 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.
XmDeactivateWMProtocol is a convenience interface. It calls
XmDeactivateProtocol with the property value set to the atom
returned by interning WMPROTOCOLS.
shell Specifies the widget with which the protocol property
is associated
property
Specifies the protocol property
protocol
Specifies the protocol atom (or an int type cast to
Atom)
For a complete definition of VendorShell and its associated
resources, see VendorShell(3X).
RELATED INFORMATION
1 (printed 6/8/92)
XmDeactivateProtocol(3X) OSF XmDeactivateProtocol(3X)
mwm(1X), VendorShell(3X), XmDeactivateWMProtocol(3X), and
XmInternAtom(3X).
2 (printed 6/8/92)