XmActivateProtocol(3X)XmActivateProtocol(3X)NAMEXmActivateProtocol — A VendorShell function that activates a protocol
SYNOPSIS
#include <Xm/Xm.h> #include <Xm/Protocols.h>
void XmActivateProtocol (shell, property, protocol) Wid‐
get shell; Atom property; Atom protocol;
void XmActivateWMProtocol (shell, protocol) Widget shell;
Atom protocol;
VERSION
This page documents version 1.2 of the Motif library.
DESCRIPTIONXmActivateProtocol 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 inter‐
action. 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 XmActi‐
vateProtocol with the property value set to the atom returned by
interning WM_PROTOCOLS. Specifies the widget with which the protocol
property is associated. Specifies the protocol property. 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 INFORMATIONVendorShell(3X), XmActivateWMProtocol(3X) and XmInternAtom(3X).
XmActivateProtocol(3X)