XmDeactivateProtocol(3)XmDeactivateProtocol(3)NAMEXmDeactivateProtocol — A VendorShell function that deactivates a proto‐
col without removing it
SYNOPSIS
#include <Xm/Xm.h>
#include <Xm/Protocols.h>
void XmDeactivateProtocol(
Widget shell,
Atom property,
Atom protocol);
DESCRIPTIONXmDeactivateProtocol 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 sup‐
port this capability, protocol is allowed to be in one of two states:
active or inactive. If protocol is active and shell is realized, prop‐
erty contains the protocol Atom. If protocol is inactive, Atom is not
present in the property.
XmDeactivateWMProtocol is a convenience interface. It calls XmDeacti‐
vateProtocol 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).
RELATEDmwm(1), VendorShell(3), XmActivateProtocol(3), XmDeactivateWMProto‐
col(3), and XmInternAtom(3).
XmDeactivateProtocol(3)