1 XICHANGEHIERARCHY(libmansuffix)
2 ===============================
7 XIChangeHierarchy - change the device hierarchy.
12 #include <X11/extensions/XInput2.h>
14 Status XIChangeHierarchy( Display *display,
15 XIAnyHierarchyChangeInfo *changes,
19 Specifies the connection to the X server.
22 Specifies the number of elements in changes.
25 Specifies the changes to be made.
30 XIChangeHierarchy modifies the device hierarchy by creating or
31 removing master devices or changing the attachment of slave
32 devices. If num_changes is non-zero, changes is an array of
33 XIAnyHierarchyChangeInfo structures. If num_changes is equal or less than
34 zero, XIChangeHierarchy does nothing.
36 XIChangeHierarchy processes changes in order, effective
37 immediately. If an error occurs, processing is aborted and the
38 error is reported to the client. Changes already made remain
41 The list of changes is any combination of
42 XIAnyHierarchyChangeInfo. The type of a hierarchy change can be
43 XIAddMaster, XIRemoveMaster, XIAttachSlave or XIDetachSlave.
48 XIRemoveMasterInfo remove;
51 } XIAnyHierarchyChangeInfo;
54 int type; /* XIAddMaster */
61 int type; /* XIRemoveMaster */
69 int type; /* XIAttachSlave */
75 int type; /* XIDetachSlave */
79 XIAddMasterInfo creates a new master pointer and a new
80 master keyboard labelled "name pointer" and "name keyboard"
81 respectively. If sendCore is True, the devices will send core
82 events. If enable is True, the device is enabled immediately.
84 XIAddMasterInfo can generate a BadValue error.
86 XIRemoveMasterInfo removes device and its paired master device.
87 If returnMode is XIAttachToMaster, all pointers attached to
88 device or its paired master device are attached to
89 returnPointer. Likewise, all keyboards are attached to
90 returnKeyboard. If returnMode is XIFloating, all attached
91 devices are set to floating.
93 XIRemoveMasterInfo can generate a BadValue and a BadDevice
96 XIAttachSlaveInfo attaches device to newMaster. If the device
97 is currently attached to a master device, it is detached from
98 the master device and attached to the new master device.
100 XIAttachSlaveInfo can generate a BadDevice error.
102 XIDettachSlaveInfo deattaches device from the current master
103 device and sets it floating. If the device is already floating,
106 XIDetachSlaveInfo can generate a BadDevice error.
108 XIChangeHierarchy generates an XIHierarchyEvent if any
109 modifications were successful.
115 An invalid device was specified. The device does not
116 exist or is not a appropriate for the type of change.
119 Some numeric value falls out of the allowed range.