1XmActivateProtocol(library call) XmActivateProtocol(library call)
2
3
4
6 XmActivateProtocol — A VendorShell function that activates a protocol
7
9 #include <Xm/Protocols.h>
10 void XmActivateProtocol(
11 Widget shell,
12 Atom property,
13 Atom protocol);
14
16 XmActivateProtocol activates a protocol. It updates the handlers and
17 the property if the shell is realized. It is sometimes useful to allow
18 a protocol's state information (callback lists, and so on) to persist,
19 even though the client may choose to temporarily resign from the inter‐
20 action. This is supported by allowing a protocol to be in one of two
21 states: active or inactive. If the protocol is active and the shell is
22 realized, the property contains the protocol Atom. If the protocol is
23 inactive, the Atom is not present in the property.
24
25 XmActivateWMProtocol is a convenience interface. It calls XmActi‐
26 vateProtocol with the property value set to the atom returned by
27 interning WM_PROTOCOLS.
28
29 shell Specifies the widget with which the protocol property is
30 associated
31
32 property Specifies the protocol property
33
34 protocol Specifies the protocol Atom
35
36 For a complete definition of VendorShell and its associated resources,
37 see VendorShell(3).
38
40 VendorShell(3), XmActivateWMProtocol(3), XmRemoveProtocols(3) and
41 XmInternAtom(3).
42
43
44
45 XmActivateProtocol(library call)