1XmObjectAtPoint(library call) XmObjectAtPoint(library call)
2
3
4
6 XmObjectAtPoint — A toolkit function that determines which child inter‐
7 sects or comes closest to a specified point
8
10 #include <Xm/Xm.h>
11 Widget XmObjectAtPoint(
12 Widget widget,
13 Position x,
14 Position y);
15
17 XmObjectAtPoint searches the child list of the specified manager widget
18 and returns the child most closely associated with the specified x,y
19 coordinate pair.
20
21 For the typical Motif manager widget, XmObjectAtPoint uses the follow‐
22 ing rules to determine the returned object:
23
24 · If one child intersects x,y, XmObjectAtPoint returns the widget
25 ID of that child.
26
27 · If more than one child intersects x,y, XmObjectAtPoint returns
28 the widget ID of the visible child.
29
30 · If no child intersects x,y, XmObjectAtPoint returns NULL.
31
32 The preceding rules are only general. In fact, each manager widget is
33 free to define "most closely associated" as it desires. For example,
34 if no child intersects x,y, a manager might return the child closest to
35 x,y.
36
37 widget Specifies a manager widget.
38
39 x Specifies the x-coordinate about which you are seeking child
40 information. The x-coordinate must be specified in pixels,
41 relative to the left side of manager.
42
43 y Specifies the y-coordinate about which you are seeking child
44 information. The y-coordinate must be specified in pixels,
45 relative to the top side of manager.
46
48 Returns the child of manager most closely associated with x,y. If none
49 of its children are sufficiently associated with x,y, returns NULL.
50
52 XmManager(3).
53
54
55
56 XmObjectAtPoint(library call)