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

  
 
  

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

NAME
     ApplicationShell -- The ApplicationShell widget class

SYNOPSIS
     #include <Xm/Xm.h>
     #include <X11/Shell.h>

DESCRIPTION
     ApplicationShell  is  used as the main top-level window for an application.
     An application should have more than one ApplicationShell only if it imple-
     ments multiple logical applications.

   Classes
     ApplicationShell inherits behavior  and  resources  from  Core,  Composite,
     Shell, WMShell, VendorShell, and TopLevelShell.

     The class pointer is applicationShellWidgetClass.

     The class name is ApplicationShell.

   New Resources
     The  following table defines a set of widget resources used by the program-
     mer to specify data. The programmer can also set the  resource  values  for
     the inherited classes to set attributes for this widget. To reference a re-
     source by name or by class in a .Xdefaults file, remove the XmN or XmC pre-
     fix and use the remaining letters. To specify one of the defined values for
     a resource in a .Xdefaults file, remove the Xm prefix and use the remaining
     letters  (in either lowercase or uppercase, but include any underscores be-
     tween words).  The codes in the access column indicate  if  the  given  re-
     source  can  be set at creation time (C), set by using XtSetValues (S), re-
     trieved by using XtGetValues (G), or is not applicable (N/A).

     +-------------------------------------------------+
     |	       |ApplicationShell Resource Set |        |
     | Name    | Class	 | Type     | Default | Access |
     +---------+---------+----------+---------+--------+
     | XmNargc | XmCArgc | int	    | 0       | CSG    |
     +---------+---------+----------+---------+--------+
     | XmNargv | XmCArgv | String * | NULL    | CSG    |
     +---------+---------+----------+---------+--------+
     +---------+---------+----------+---------+--------+

     XmNargc   Specifies the number of arguments given in the XmNargv  resource.
	       The  function XtInitialize sets this resource on the shell widget
	       instance it creates by using its parameters as the values.

     XmNargv   Specifies the argument list required  by  a  session  manager  to
	       restart	the application if it is killed. This list should be up-
	       dated at appropriate points by the application if a new state has
	       been reached that can be directly restarted.  The function XtIni-
	       tialize sets this resource on the shell widget instance	it  cre-
	       ates  by using its parameters as the values.  When XtGetValues is
	       called on this resource, the returned value is a pointer  to  the
	       actual resource value and should not be freed.

   Inherited Resources
     ApplicationShell  inherits behavior and resources from the following super-
     classes. For a complete description of each resource, refer to  the  refer-
     ence page for that superclass.

     +------------------------------------------------------------------------+
     |			   | TopLevelShell Resource Set    |	     |	      |
     | Name		   | Class		 | Type    | Default | Access |
     +---------------------+---------------------+---------+---------+--------+
     | XmNiconic	   | XmCIconic		 | Boolean | False   | CSG    |
     +---------------------+---------------------+---------+---------+--------+
     | XmNiconName	   | XmCIconName	 | String  | NULL    | CSG    |
     +---------------------+---------------------+---------+---------+--------+
     | XmNiconNameEncoding | XmCIconNameEncoding | Atom    | dynamic | CSG    |
     +---------------------+---------------------+---------+---------+--------+
     +---------------------+---------------------+---------+---------+--------+

     +--------------------------------------------------------------------------------------------+
     |			      | 	VendorShell Resource Set       |		 |	  |
     | Name		      | Class		       | Type	       | Default	 | Access |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNaudibleWarning      | XmCAudibleWarning      | unsigned char | XmBELL 	 | CSG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNbuttonFontList      | XmCButtonFontList      | XmFontList    | dynamic	 | CSG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNbuttonRenderTable   | XmCButtonRenderTable   | XmRenderTable | dynamic	 | CSG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNdefaultFontList     | XmCDefaultFontList     | XmFontList    | dynamic	 | CG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNdeleteResponse      | XmCDeleteResponse      | unsigned char | XmDESTROY	 | CSG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNinputMethod	      | XmCInputMethod	       | String        | NULL		 | CSG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNinputPolicy	      | XmCInputPolicy	       | XmInputPolicy | XmPER_SHELL	 | CSG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNkeyboardFocusPolicy | XmCKeyboardFocusPolicy | unsigned char | XmEXPLICIT	 | CSG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNlabelFontList       | XmCLabelFontList       | XmFontList    | dynamic	 | CSG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNlabelRenderTable    | XmCLabelRenderTabel    | XmRenderTable | dynamic	 | CSG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNlayoutDirection     | XmCLayoutDirection     | XmDirection   | XmLEFT_TO_RIGHT | CG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNmwmDecorations      | XmCMwmDecorations      | int	       | -1		 | CG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNmwmFunctions	      | XmCMwmFunctions        | int	       | -1		 | CG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNmwmInputMode	      | XmCMwmInputMode        | int	       | -1		 | CG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNmwmMenu	      | XmCMwmMenu	       | String        | NULL		 | CG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNpreeditType	      | XmCPreeditType	       | String        | dynamic	 | CSG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNshellUnitType       | XmCShellUnitType       | unsigned char | XmPIXELS	 | CSG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNtextFontList	      | XmCTextFontList        | XmFontList    | dynamic	 | CSG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNtextRenderTable     | XmCTextRenderTable     | XmRenderTable | dynamic	 | CSG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNunitType	      | XmCUnitType	       | unsigned char | XmPIXELS	 | CSG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     | XmNuseAsyncGeometry    | XmCUseAsyncGeometry    | Boolean       | False		 | CSG	  |
     +------------------------+------------------------+---------------+-----------------+--------+
     +------------------------+------------------------+---------------+-----------------+--------+

     +--------------------------------------------------------------------------------+
     |			|	    WMShell|Resource Set		     |	      |
     | Name		| Class 	   | Type    | Default		     | Access |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNbaseHeight	| XmCBaseHeight    | int     | XtUnspecifiedShellInt | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNbaseWidth	| XmCBaseWidth	   | int     | XtUnspecifiedShellInt | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNheightInc	| XmCHeightInc	   | int     | XtUnspecifiedShellInt | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNiconMask	| XmCIconMask	   | Pixmap  | NULL		     | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNiconPixmap	| XmCIconPixmap    | Pixmap  | NULL		     | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNiconWindow	| XmCIconWindow    | Window  | NULL		     | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNiconX 	| XmCIconX	   | int     | XtUnspecifiedShellInt | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNiconY 	| XmCIconY	   | int     | XtUnspecifiedShellInt | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNinitialState	| XmCInitialState  | int     | NormalState	     | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNinput 	| XmCInput	   | Boolean | True		     | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNmaxAspectX	| XmCMaxAspectX    | int     | XtUnspecifiedShellInt | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNmaxAspectY	| XmCMaxAspectY    | int     | XtUnspecifiedShellInt | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNmaxHeight	| XmCMaxHeight	   | int     | XtUnspecifiedShellInt | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNmaxWidth	| XmCMaxWidth	   | int     | XtUnspecifiedShellInt | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNminAspectX	| XmCMinAspectX    | int     | XtUnspecifiedShellInt | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNminAspectY	| XmCMinAspectY    | int     | XtUnspecifiedShellInt | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNminHeight	| XmCMinHeight	   | int     | XtUnspecifiedShellInt | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNminWidth	| XmCMinWidth	   | int     | XtUnspecifiedShellInt | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNtitle 	| XmCTitle	   | String  | dynamic		     | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNtitleEncoding | XmCTitleEncoding | Atom    | dynamic		     | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNtransient	| XmCTransient	   | Boolean | False		     | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNwaitForWm	| XmCWaitForWm	   | Boolean | True		     | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNwidthInc	| XmCWidthInc	   | int     | XtUnspecifiedShellInt | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNwindowGroup	| XmCWindowGroup   | Window  | dynamic		     | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNwinGravity	| XmCWinGravity    | int     | dynamic		     | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     | XmNwmTimeout	| XmCWmTimeout	   | int     | 5000 ms		     | CSG    |
     +------------------+------------------+---------+-----------------------+--------+
     +------------------+------------------+---------+-----------------------+--------+

     +------------------------------------------------------------------------------------------------------+
     |			       |		Shell Resource Set		  |		   |	    |
     | Name		       | Class			 | Type 		  | Default	   | Access |
     +-------------------------+-------------------------+------------------------+----------------+--------+
     | XmNallowShellResize     | XmCAllowShellResize	 | Boolean		  | False	   | CG     |
     +-------------------------+-------------------------+------------------------+----------------+--------+
     | XmNcreatePopupChildProc | XmCCreatePopupChildProc | XtCreatePopupChildProc | NULL	   | CSG    |
     +-------------------------+-------------------------+------------------------+----------------+--------+
     | XmNgeometry	       | XmCGeometry		 | String		  | NULL	   | CSG    |
     +-------------------------+-------------------------+------------------------+----------------+--------+
     | XmNoverrideRedirect     | XmCOverrideRedirect	 | Boolean		  | False	   | CSG    |
     +-------------------------+-------------------------+------------------------+----------------+--------+
     | XmNpopdownCallback      | XmCCallback		 | XtCallbackList	  | NULL	   | C	    |
     +-------------------------+-------------------------+------------------------+----------------+--------+
     | XmNpopupCallback        | XmCCallback		 | XtCallbackList	  | NULL	   | C	    |
     +-------------------------+-------------------------+------------------------+----------------+--------+
     | XmNsaveUnder	       | XmCSaveUnder		 | Boolean		  | False	   | CSG    |
     +-------------------------+-------------------------+------------------------+----------------+--------+
     | XmNvisual	       | XmCVisual		 | Visual *		  | CopyFromParent | CSG    |
     +-------------------------+-------------------------+------------------------+----------------+--------+
     +-------------------------+-------------------------+------------------------+----------------+--------+

     +------------------------------------------------------------------------+
     |			 |     Composite Resource Set	   |	     |	      |
     | Name		 | Class	     | Type	   | Default | Access |
     +-------------------+-------------------+-------------+---------+--------+
     | XmNchildren	 | XmCReadOnly	     | WidgetList  | NULL    | G      |
     +-------------------+-------------------+-------------+---------+--------+
     | XmNinsertPosition | XmCInsertPosition | XtOrderProc | NULL    | CSG    |
     +-------------------+-------------------+-------------+---------+--------+
     | XmNnumChildren	 | XmCReadOnly	     | Cardinal    | 0	     | G      |
     +-------------------+-------------------+-------------+---------+--------+
     +-------------------+-------------------+-------------+---------+--------+

     +----------------------------------------------------------------------------------------------------------------+
     |				     |		     Core Resource Set		      | 		     |	      |
     | Name			     | Class			     | Type	      | Default 	     | Access |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     | XmNaccelerators		     | XmCAccelerators		     | XtAccelerators | dynamic 	     | CSG    |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     | XmNancestorSensitive	     | XmCSensitive		     | Boolean	      | dynamic 	     | G      |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     | XmNbackground		     | XmCBackground		     | Pixel	      | dynamic 	     | CSG    |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     | XmNbackgroundPixmap	     | XmCPixmap		     | Pixmap	      | XmUNSPECIFIED_PIXMAP | CSG    |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     | XmNborderColor		     | XmCBorderColor		     | Pixel	      | XtDefaultForeground  | CSG    |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     | XmNborderPixmap		     | XmCPixmap		     | Pixmap	      | XmUNSPECIFIED_PIXMAP | CSG    |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     | XmNborderWidth		     | XmCBorderWidth		     | Dimension      | 0		     | CSG    |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     | XmNcolormap		     | XmCColormap		     | Colormap       | dynamic 	     | CG     |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     | XmNdepth 		     | XmCDepth 		     | int	      | dynamic 	     | CG     |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     | XmNdestroyCallback	     | XmCCallback		     | XtCallbackList | NULL		     | C      |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     | XmNheight		     | XmCHeight		     | Dimension      | dynamic 	     | CSG    |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     | XmNinitialResourcesPersistent | XmCInitialResourcesPersistent | Boolean	      | True		     | C      |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     | XmNmappedWhenManaged	     | XmCMappedWhenManaged	     | Boolean	      | True		     | CSG    |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     | XmNscreen		     | XmCScreen		     | Screen *       | dynamic 	     | CG     |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     | XmNsensitive		     | XmCSensitive		     | Boolean	      | True		     | CSG    |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     | XmNtranslations		     | XmCTranslations		     | XtTranslations | dynamic 	     | CSG    |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     | XmNwidth 		     | XmCWidth 		     | Dimension      | dynamic 	     | CSG    |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     | XmNx			     | XmCPosition		     | Position       | 0		     | CSG    |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     | XmNy			     | XmCPosition		     | Position       | 0		     | CSG    |
     +-------------------------------+-------------------------------+----------------+----------------------+--------+
     +-------------------------------+-------------------------------+----------------+----------------------+--------+

   Translations
     There are no translations for ApplicationShell.

RELATED
     Composite(3),    Core(3),	 Shell(3),   WMShell(3),   VendorShell(3),   and
     TopLevelShell(3).

							     ApplicationShell(3)

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

home | help