XmActivateProtocol(Xm)
XmActivateProtocol --
a VendorShell function that activates a protocol
Syntax
#include <Xm/Xm.h>
#include <Xm/Protocols.h>
void XmActivateProtocol (shell, property, protocol)
Widget shell;
Atom property;
Atom protocol;
void XmActivateWMProtocol (shell, protocol)
Widget shell;
Atom protocol;
Description
XmActivateProtocol activates a protocol. 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. 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.
XmActivateWMProtocol is a convenience interface.
It calls XmActivateProtocol
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(Xm).
See also
VendorShell(Xm),
XmActivateWMProtocol(Xm)
and
XmInternAtom(Xm).
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003