Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XmObjectAtPoint(3)	   Library Functions Manual	    XmObjectAtPoint(3)

NAME
       XmObjectAtPoint	--  A toolkit function that determines which child in-
       tersects	or comes closest to a specified	point

SYNOPSIS
       #include	<Xm/Xm.h>
       Widget XmObjectAtPoint(
       Widget widget,
       Position	x,
       Position	y);

DESCRIPTION
       XmObjectAtPoint searches	the child list of the specified	manager	widget
       and returns the child most closely associated with  the	specified  x,y
       coordinate pair.

       For  the	typical	Motif manager widget, XmObjectAtPoint uses the follow-
       ing rules to determine the returned object:

	    If	one child intersects x,y, XmObjectAtPoint returns  the	widget
	     ID	of that	child.

	    If	 more  than  one child intersects x,y, XmObjectAtPoint returns
	     the widget	ID of the visible child.

	    If	no child intersects x,y, XmObjectAtPoint returns NULL.

       The preceding rules are only general. In	fact, each manager  widget  is
       free  to	 define	"most closely associated" as it	desires.  For example,
       if no child intersects x,y, a manager might return the child closest to
       x,y.

       widget	 Specifies a manager widget.

       x	 Specifies the x-coordinate about which	you are	seeking	 child
		 information.  The  x-coordinate  must be specified in pixels,
		 relative to the left side of manager.

       y	 Specifies the y-coordinate about which	you are	seeking	 child
		 information.  The  y-coordinate  must be specified in pixels,
		 relative to the top side of manager.

RETURN
       Returns the child of manager most closely associated with x,y.  If none
       of its children are sufficiently	associated with	x,y, returns NULL.

RELATED
       XmManager(3).

							    XmObjectAtPoint(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmObjectAtPoint&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help