1XmObjectAtPoint(library call)                    XmObjectAtPoint(library call)
2
3
4

NAME

6       XmObjectAtPoint — A toolkit function that determines which child inter‐
7       sects or comes closest to a specified point
8

SYNOPSIS

10       #include <Xm/Xm.h>
11       Widget XmObjectAtPoint(
12       Widget widget,
13       Position x,
14       Position y);
15

DESCRIPTION

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

RETURN

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)
Impressum