1XmDeactivateProtocol(library call) XmDeactivateProtocol(library call)
2
3
4
6 XmDeactivateProtocol — A VendorShell function that deactivates a proto‐
7 col without removing it
8
10 #include <Xm/Xm.h>
11 #include <Xm/Protocols.h>
12 void XmDeactivateProtocol(
13 Widget shell,
14 Atom property,
15 Atom protocol);
16
18 XmDeactivateProtocol deactivates a protocol without removing it. It
19 updates the handlers and the property if the shell is realized. It is
20 sometimes useful to allow a protocol's state information (callback
21 lists, and so on) to persist, even though the client may choose to tem‐
22 porarily resign from the interaction. The main use of this capability
23 is to gray/ungray f.send_msg entries in the MWM system menu. To sup‐
24 port this capability, protocol is allowed to be in one of two states:
25 active or inactive. If protocol is active and shell is realized, prop‐
26 erty contains the protocol Atom. If protocol is inactive, Atom is not
27 present in the property.
28
29 XmDeactivateWMProtocol is a convenience interface. It calls XmDeacti‐
30 vateProtocol with the property value set to the atom returned by
31 interning WM_PROTOCOLS.
32
33 shell Specifies the widget with which the protocol property is
34 associated
35
36 property Specifies the protocol property
37
38 protocol Specifies the protocol atom
39
40 For a complete definition of VendorShell and its associated resources,
41 see VendorShell(3).
42
44 mwm(1), VendorShell(3), XmActivateProtocol(3), XmDeactivateWMProto‐
45 col(3), and XmInternAtom(3).
46
47
48
49 XmDeactivateProtocol(library call)