XmActivateProtocol(3Xm)

NAME
XmActivateProtocol — a VendorShell function that activates a protocol.

SYNOPSIS
#include <Xm/Xm.h>
#include <X11/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, etc.) 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, then the property will contain the protocol Atom. If the protocol is inactive, the Atom will not be 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 cast to Atom).

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

RELATED INFORMATION
VendorShell(3Xm), XmActivateWMProtocol(3Xm) and XmInternAtom(3Xm).