Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

XtUnrealizeWidget()					   XtUnrealizeWidget()

Name
  XtUnrealizeWidget  -	destroy	 the windows associated with a widget and
  its descendants.

Synopsis
  void XtUnrealizeWidget(w)
	 Widget w;

Inputs
  w	    Specifies the widget.  Must be of class Core or any	 subclass
	    thereof.

Description
  XtUnrealizeWidget()  unmanages  the  specified  widget and destroys the
  windows associated with the widget and all  of  its  non-popup  descen‐
  dants.

  The "Algorithm" section below explains the details of this process.

Usage
  Note	that  this  call  simply destroys the windows associated with the
  widgets.  The widget instances themselves remain intact.   To	 recreate
  the  windows	at  a  later time, call XtRealizeWidget() again.  Compare
  this to XtDestroyWidget(), which destroys the widgets themselves.

  Unmanaging a widget is the usual method  for	temporarily  removing  it
  from	the  screen.   Unrealizing  a  widget frees up resources on the X
  server, and may be a better choice for widgets  that	are  only  infre‐
  quently visible.

Algorithm
  If  the  widget  is  currently  unrealized,  XtUnrealizeWidget() simply
  returns; otherwise, it performs the following:

  ·  Unmanages the widget if the widget is managed.

  ·  Makes a post-order (child to parent) traversal of	the  widget  tree
     rooted  at	 the  specified	 widget	 and,  for  each  widget that has
     declared a callback list named unrealizeCallback, executes the  pro‐
     cedures on the XtNunrealizeCallback list.

  ·  Destroys the widget's window and any subwindows by calling XDestroy‐
     Window() on the specified widget's window.

  Any events that are either in the queue or that arrive following a call
  to  XtUnrealizeWidget()  will	 be dispatched as if the window(s) of the
  unrealized widget(s) had never existed.

See Also
  XtDestroyWidget(1), XtRealizeWidget(1), XtUnmanageWidget(1).

Xt - Widget Lifecycle					   XtUnrealizeWidget()

Vote for polarhome