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

FreeBSD Manual Pages

  
 
  

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

NAME
     XmtIconifyShell(),  XmtDeiconifyShell(), XmtRaiseShell(), XmtLowerShell() -
     perform window manager manipulations on shell widgets.

SYNOPSIS
     #include <Xmt/Xmt.h>

     void XmtIconifyShell(Widget w)

     void XmtDeiconifyShell(Widget w)

     void XmtRaiseShell(Widget w)

     void XmtLowerShell(Widget w)

ARGUMENTS
     INPUTS

     w	    The toplevel shell (i.e. not a dialog shell) that is to  be  manipu-
	    lated, or any child of that toplevel shell.

DESCRIPTION
     XmtIconifyShell() iconifies the specified shell widget.

     XmtDeiconifyShell() un-iconifies the specified shell widget.

     XmtRaiseShell()  un-iconifies the specified shell widget, if necessary, and
     raises the shell window to to the top of the window stack.

     XmtLowerShell() un-iconifies the specified shell widget, if necessary,  and
     lowers the shell window to to the bottom of the window stack.

     These  functions  all work in a way that is compatible with ICCCM-compliant
     window managers. It is safe to call these functions even for shell  widgets
     that have not been realized yet.

USAGE
     XmtFocusShell()  goes  a  step  beyond  XmtRaiseShell()-it  deiconifies and
     raises a shell, and also sets keyboard focus to it.

     Remember that the user can iconify, deiconify,  raise,  and  lower  windows
     through  the  window manager. You can use these functions to provide short-
     cuts for window manager actions, but you should call them only in	response
     to  an  explicit  user  request to manipulate the window-otherwise you risk
     confusing the user. You might use XmtRaiseShell(),  for  example  when  the
     user selects an item from a Windows menu of your application, for example

SEE ALSO
     Chapter 15, Working with the Window Manager, XmtFocusShell().

Xmt				   Motif Tools		      XmtIconifyShell(3)

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

home | help