XmDeactivateProtocol(library call) XmDeactivateProtocol(library call)
NAME
XmDeactivateProtocol -- A VendorShell function that deactivates a pro-
tocol 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 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).
RELATED
mwm(1), VendorShell(3), XmActivateProtocol(3), XmDeactivateWMProto-
col(3), and XmInternAtom(3).
XmDeactivateProtocol(library call)
openMotif 2.3.1 - Generated Sun Nov 30 10:42:22 CST 2008