XmDeactivateProtocol(3X)
Prev | Reference Pages | Next

## Name

XmDeactivateProtocol(3X) — XmDeactivateProtocol--A VendorShell function that deactivates a protocol without removing it XmDeactivateProtocolprotocolsVendorShell functions

## Synopsis

#include <Xm/Xm.h>
#include <Xm/Protocols.h>
void XmDeactivateProtocol (`shell, property, protocol`)
Widget `shell`;
Atom `property`;
Atom `protocol`;
void XmDeactivateWMProtocol (`shell, protocol`)
Widget `shell`;
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, etc.) 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. 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`.

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 (or an int type cast to Atom)

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

## RELATED INFORMATION

mwm(1X), VendorShell(3X), XmDeactivateWMProtocol(3X), and XmInternAtom(3X).

Prev | Table of Contents | Next
XmCvtXmStringToCT(3X) |  | XmDeactivateWMProtocol(3X)