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
temporarily 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)