FreeBSD Manual Pages
XtRealizeWidget(3) XT FUNCTIONS XtRealizeWidget(3) NAME XtRealizeWidget, XtIsRealized, XtUnrealizeWidget - realize and unreal- ize widgets SYNTAX #include <X11/Intrinsic.h> void XtRealizeWidget(Widget w); Boolean XtIsRealized(Widget w); void XtUnrealizeWidget(Widget w); ARGUMENTS w Specifies the widget. DESCRIPTION If the widget is already realized, XtRealizeWidget simply returns. Otherwise, it performs the following: • Binds all action names in the widget's translation table to proce- dures (see Section 10.1.2). • Makes a post-order traversal of the widget tree rooted at the specified widget and calls the change_managed procedure of each composite widget that has one or more managed children. • Constructs an XSetWindowAttributes structure filled in with infor- mation derived from the Core widget fields and calls the realize procedure for the widget, which adds any widget-specific attrib- utes and creates the X window. • If the widget is not a subclass of compositeWidgetClass, XtRealizeWidget returns; otherwise, it continues and performs the following: - Descends recursively to each of the widget's managed children and calls the realize procedures. Primitive widgets that in- stantiate children are responsible for realizing those chil- dren themselves. - Maps all of the managed children windows that have mapped_when_managed True. (If a widget is managed but mapped_when_managed is False, the widget is allocated visual space but is not displayed. Some people seem to like this to indicate certain states.) If the widget is a top-level shell widget (that is, it has no parent), and mapped_when_managed is True, XtRealizeWidget maps the widget win- dow. The XtIsRealized function returns True if the widget has been realized, that is, if the widget has a nonzero X window ID. Some widget procedures (for example, set_values) might wish to operate differently after the widget has been realized. The XtUnrealizeWidget function destroys the windows of an existing wid- get and all of its children (recursively down the widget tree). To recreate the windows at a later time, call XtRealizeWidget again. If the widget was managed, it will be unmanaged automatically before its window is freed. SEE ALSO XtManageChildren(3) X Toolkit Intrinsics - C Language Interface Xlib - C Language X Interface X Version 11 libXt 1.3.0 XtRealizeWidget(3)
NAME | SYNTAX | ARGUMENTS | DESCRIPTION | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XtIsRealized&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>