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

FreeBSD Manual Pages

  
 
  

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

NAME
       XmIsTraversable	--  A function that identifies whether a widget	can be
       traversed

SYNOPSIS
       #include	<Xm/Xm.h>
       Boolean XmIsTraversable(
       Widget widget);

DESCRIPTION
       XmIsTraversable determines whether the specified	widget is eligible  to
       receive focus through keyboard traversal.  In general, a	widget is eli-
       gible to	receive	focus when all of the following	conditions are true:

	  o  The widget	and its	ancestors are not being	destroyed, are	sensi-
	     tive, and have a value of True for	XmNtraversalOn.

	  o  The  widget  and its ancestors are	realized, managed, and (except
	     for gadgets) mapped.  If an application unmaps a widget that  has
	     its  XmNmappedWhenManaged	resource set to	True, the return value
	     is	undefined.

	  o  Some part of the widget's rectangular area	is unobscured  by  the
	     widget's ancestors, or some part of the widget's rectangular area
	     is	inside the work	window (but possibly outside the clip  window)
	     of	 a  ScrolledWindow whose XmNscrollingPolicy is XmAUTOMATIC and
	     whose XmNtraverseObscuredCallback is not NULL.

       Some widgets may	not be eligible	to receive focus even if they meet all
       these  conditions.   For	 example,  most	 managers cannot receive focus
       through keyboard	traversal.  Some widgets may be	 eligible  to  receive
       focus  under particular conditions.  For	example, a DrawingArea is eli-
       gible to	receive	focus if it meets the  conditions  above  and  has  no
       child whose XmNtraversalOn resource is True.

       Note  that  when	 all  widgets  in a shell hierarchy have been made un-
       traversable, they are considered	to have	lost focus. When a  widget  in
       this hierarchy is made traversable again, it regains focus.

       XmIsTraversable may return unexpected results when widget or its	ances-
       tors are	overlapped by their siblings.

       widget	 Specifies the ID of the widget

RETURN
       Returns True if the widget is eligible to receive  focus	 through  key-
       board traversal;	otherwise, returns False.

RELATED
       XmGetVisibility(3) and XmProcessTraversal(3).

							    XmIsTraversable(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN | RELATED

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

home | help