XmDeactivateProtocol(3X) X11 SDE 5.4R3.00 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.send_msg 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 WM_PROTOCOLS.
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
mwm(1X), VendorShell(3X), XmDeactivateWMProtocol(3X), and
XmInternAtom(3X).
Licensed material--property of copyright holder(s) 1