1XISETCLIENTPOINTER(3)                                    XISETCLIENTPOINTER(3)
2
3
4

NAME

6       XISetClientPointer, XIGetClientPointer - set or get the ClientPointer
7       device.
8

SYNOPSIS

10       #include <X11/extensions/XInput2.h>
11
12       XISetClientPointer( Display *display,
13                           Window win,
14                           int deviceid);
15
16       Bool XIGetClientPointer( Display *display,
17                                Window win,
18                                int *device);
19
20       display
21              Specifies the connection to the X server.
22
23       win
24              Specifies a window belonging to the client. May be None.
25
26       deviceid
27              Specifies the ClientPointer device.
28

DESCRIPTION

30           The ClientPointer is the device that is perceived to be the
31           core pointer for non-XI protocol requests and replies. Each
32           time a protocol message needs device-dependent data and the
33           device is not explicitly given, the ClientPointer device is
34           used to obtain the data. For example, a XQueryPointer request
35           will return the coordinates of the ClientPointer.
36
37           XISetClientPointer request sets the ClientPointer device for
38           the client that owns the given window. If win is None, the
39           requesting client's ClientPointer is set to the device
40           specified with deviceid. Only master pointer devices can be set
41           as ClientPointer.
42
43           XISetClientPointer and can generate a BadDevice and a BadWindow
44           error.
45
46           The XIGetClientPointer request returns the ClientPointer's
47           device ID for the client that owns the given window. If win is
48           None, the requesting client's ClientPointer is returned.
49
50           win may be a client ID instead of a window.
51
52           XIGetClientPointer can generate a BadWindow error.
53

DIAGNOSTICS

55           BadDevice
56                  An invalid device was specified. The device does not
57                  exist or is not a master pointer device.
58
59           BadWindow
60                  A value for a Window argument does not name a defined
61                  window.
62
63
64
65                                  05/04/2023             XISETCLIENTPOINTER(3)
Impressum