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

FreeBSD Manual Pages

  
 
  

home | help
XtNameToWidget(3)		  XT FUNCTIONS		       XtNameToWidget(3)

NAME
     XtNameToWidget,  XtWindowToWidget	- translating strings to widgets or wid-
     gets to windows

SYNTAX
     #include <X11/Intrinsic.h>

     Widget XtNameToWidget(Widget reference, const char *names);

     Widget XtWindowToWidget(Display *display, Window window);

ARGUMENTS
     display   Specifies the display on which the window is defined.

     names     Specifies the fully qualified name of the desired widget.

     reference Specifies the widget from which the search is to start.

     window    Specify the window for which you want the widget.

DESCRIPTION
     The XtNameToWidget function looks for a widget whose name is the first com-
     ponent in the specified names and that is a pop-up child of reference (or a
     normal child if reference is a subclass of compositeWidgetClass).	It  then
     uses that widget as the new reference and repeats the search after deleting
     the first component from the specified names.  If it cannot find the speci-
     fied widget, XtNameToWidget returns NULL.

     Note  that the names argument contains the name of a widget with respect to
     the specified reference widget and can contain more than  one  widget  name
     (separated  by  periods)  for  widgets  that are not direct children of the
     specified reference widget.

     If more than one child of the reference widget matches the name,  XtNameTo-
     Widget  can return any of the children.  The Intrinsics do not require that
     all children of a widget have unique names.  If the specified names contain
     more than one component and if more than one child matches the first compo-
     nent, XtNameToWidget can return NULL if the single branch that  it  follows
     does  not	contain the named widget.  That is, XtNameToWidget does not back
     up and follow other matching branches of the widget tree.

     The XtWindowToWidget function translates the specified window  and  display
     pointer into the appropriate widget instance.

SEE ALSO
     X Toolkit Intrinsics - C Language Interface
     Xlib - C Language X Interface

X Version 11			   libXt 1.3.1		       XtNameToWidget(3)

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

home | help