NAME

XmDeactivateProtocol — a VendorShell function that deactivates a protocol without removing it.

SYNOPSIS

#include <Xm/Xm.h>
#include <X11/Protocols.h> void XmDeactivateProtocol (shell, property, protocol)
Widgetshell;
Atomproperty;
Atomprotocol; void XmDeactivateWMProtocol (shell, protocol)
Widgetshell;
Atomprotocol;

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, then the property will contain the protocol Atom.  If the protocol is inactive, the Atom will not be 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. 

shellSpecifies the widget with which the protocol property is associated. 

propertySpecifies the protocol property. 

protocolSpecifies the protocol atom (or an int cast to Atom). 

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

RELATED INFORMATION

mwm(1X), VendorShell(3Xm), XmDeactivateWMProtocol(3Xm), and XmInternAtom(3Xm). 

7th Edition