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:

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

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

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

NAME | SYNOPSIS | DESCRIPTION | RETURN | RELATED

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

home | help