WMShell(3)

NAME

   WMShell --- The WMShell widget class "WMShell" "widget class" "WMShell"

SYNOPSIS

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

DESCRIPTION

   WMShell  is  a  top-level widget that encapsulates the interaction with
   the window manager.

   Classes
   WMShell inherits behavior and resources from the Core,  Composite,  and
   Shell classes.

   The class pointer is wmShellWidgetClass.

   The class name is WMShell.

   New Resources
   The  following  table  defines  a  set  of widget resources used by the
   programmer to specify data. The programmer can also  set  the  resource
   values  for the inherited classes to set attributes for this widget. To
   reference a resource by name or by class in a .Xdefaults  file,  remove
   the  XmN or XmC prefix 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 between words).  The codes  in  the  access
   column  indicate if the given resource can be set at creation time (C),
   set by using XtSetValues (S), retrieved by using XtGetValues (G), or is
   not applicable (N/A).

   
                               WMShellResource 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  False                  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    
   
   
   XmNbaseHeight
             Specifies the base for a progression of preferred heights for
             the  window  manager  to  use  in  sizing  the  widget.   The
             preferred  heights  are XmNbaseHeight plus integral multiples
             of XmNheightInc, with a minimum of XmNminHeight and a maximum
             of  XmNmaxHeight.   If  an  initial value is not supplied for
             XmNbaseHeight but is supplied for XmNbaseWidth, the value  of
             XmNbaseHeight is set to 0 (zero) when the widget is realized.

   XmNbaseWidth
             Specifies  the base for a progression of preferred widths for
             the  window  manager  to  use  in  sizing  the  widget.   The
             preferred  widths are XmNbaseWidth plus integral multiples of
             XmNwidthInc, with a minimum of XmNminWidth and a  maximum  of
             XmNmaxWidth.   If  an  initial  value  is  not  supplied  for
             XmNbaseWidth but is supplied for XmNbaseHeight, the value  of
             XmNbaseWidth is set to 0 (zero) when the widget is realized.

   XmNheightInc
             Specifies  the  increment  for  a  progression  of  preferred
             heights for the window manager to use in sizing  the  widget.
             The   preferred   heights  are  XmNbaseHeight  plus  integral
             multiples of XmNheightInc, with a minimum of XmNminHeight and
             a  maximum  of  XmNmaxHeight.   If  an  initial  value is not
             supplied for XmNheightInc but is  supplied  for  XmNwidthInc,
             the  value  of  XmNheightInc  is  set to 1 when the widget is
             realized.

   XmNiconMask
             Specifies a bitmap that could be used by the  window  manager
             to   clip   the   XmNiconPixmap   bitmap  to  make  the  icon
             nonrectangular.

   XmNiconPixmap
             Specifies a bitmap that could be used by the  window  manager
             as the application's icon.

   XmNiconWindow
             Specifies the ID of a window that could be used by the window
             manager as the application's icon.

   XmNiconX  Specifies a suitable place to  put  the  application's  icon;
             this  is  a  hint  to  the  window  manager  in  root  window
             coordinates.  Because  the  window  manager   controls   icon
             placement policy, this resource may be ignored.

   XmNiconY  Specifies  a  suitable  place  to put the application's icon;
             this  is  a  hint  to  the  window  manager  in  root  window
             coordinates.    Because  the  window  manager  controls  icon
             placement policy, this resource may be ignored.

   XmNinitialState
             Specifies the state the application wants the widget instance
             to  start in.  It must be one of the constants NormalState or
             IconicState.

   XmNinput  Specifies the application's input model for this  widget  and
             its  descendants.   The  meaning of a True or False value for
             this resource  depends  on  the  presence  or  absence  of  a
             WM_TAKE_FOCUS atom in the WM_PROTOCOLS property:

             
             Input Model      XmNinput  WM_TAKE_FOCUS 
             
             No input         False     Absent        
             
             Passive          True      Absent        
             
             Locally active   True      Present       
             
             Globally active  False     Present       
             
             
             For  more  information  on input models, see the X Consortium
             Standard  Inter-Client   Communication   Conventions   Manual
             (ICCCM).

   XmNmaxAspectX
             Specifies  the  numerator  of  the maximum aspect ratio (X/Y)
             that the application wants the widget instance to have.

   XmNmaxAspectY
             Specifies the denominator of the maximum aspect  ratio  (X/Y)
             that the application wants the widget instance to have.

   XmNmaxHeight
             Specifies  the  maximum height that the application wants the
             widget instance to have.

   XmNmaxWidth
             Specifies the maximum width that the  application  wants  the
             widget instance to have.

   XmNminAspectX
             Specifies  the  numerator  of  the minimum aspect ratio (X/Y)
             that the application wants the widget instance to have.

   XmNminAspectY
             Specifies the denominator of the minimum aspect  ratio  (X/Y)
             that the application wants the widget instance to have.

   XmNminHeight
             Specifies  the  minimum height that the application wants the
             widget instance to have.

   XmNminWidth
             Specifies the minimum width that the  application  wants  the
             widget instance to have.

   XmNtitle  Specifies  the application name to be displayed by the window
             manager.   The  default  is  the  icon  name,  if  specified;
             otherwise,   it   is  the  name  of  the  application.   When
             XtGetValues is called on this resource, the returned value is
             a  pointer  to  the  actual  resource value and should not be
             freed.

   XmNtitleEncoding
             Specifies a property type that represents the encoding of the
             XmNtitle  string.   If a language procedure has been set, the
             default is None; otherwise, the default  is  XA_STRING.  When
             the   widget   is   realized,  if  the  value  is  None,  the
             corresponding name is assumed to be in  the  current  locale.
             The  name  is  passed  to  XmbTextListToTextProperty  with an
             encoding style of XStdICCTextStyle. The resulting encoding is
             STRING  if the name is fully convertible to STRING; otherwise
             it is COMPOUND_TEXT.  The values of  the  encoding  resources
             are not changed; they remain None.

   XmNtransient
             Specifies a Boolean value that is True if the widget instance
             is transient, typically a popup on behalf of another  widget.
             The  window  manager  may  treat  a transient widget's window
             differently  from  other  windows.   For  example,  a  window
             manager  may  not  iconify a transient window separately from
             its associated application.  Applications  and  users  should
             not normally alter this resource.

   XmNwaitForWm
             When  True, specifies that the Intrinsics waits the length of
             time given  by  the  XmNwmTimeout  resource  for  the  window
             manager  to  respond  to certain actions before assuming that
             there is no window manager present.  This resource is altered
             by  the  Intrinsics  as  it  receives,  or  fails to receive,
             responses from the window manager.

   XmNwidthInc
             Specifies the base for a progression of preferred widths  for
             the  window  manager  to  use  in  sizing  the  widget.   The
             preferred widths are XmNbaseWidth plus integral multiples  of
             XmNwidthInc,  with  a minimum of XmNminWidth and a maximum of
             XmNmaxWidth.   If  an  initial  value  is  not  supplied  for
             XmNwidthInc  but  is  supplied for XmNheightInc, the value of
             XmNwidthInc is set to 1 when the widget is realized.

   XmNwindowGroup
             Specifies the ID of a window with which this widget  instance
             is associated.  By convention, this window is the "leader" of
             a group of windows.  A window manager may treat  all  windows
             in  a  group  in some way; for example, it may always move or
             iconify them together.

             If no initial value is specified, the value  is  set  to  the
             window  of  the  first realized ancestor widget in the parent
             hierarchy when  the  widget  is  realized.   If  a  value  of
             XtUnspecifiedWindowGroup  is  specified,  no  window group is
             set.

   XmNwinGravity
             Specifies the window gravity for use by the window manager in
             positioning  the  widget.   If no initial value is specified,
             the value is set when the widget is realized.  If XmNgeometry
             is  not  NULL,  XmNwinGravity  is  set  to the window gravity
             returned by XWMGeometry.  Otherwise, XmNwinGravity is set  to
             NorthWestGravity.

   XmNwmTimeout
             Specifies  the  length  of time that the Intrinsics waits for
             the window manager  to  respond  to  certain  actions  before
             assuming  that there is no window manager present.  The value
             is in milliseconds and must not be negative.

   Inherited Resources
   WMShell inherits behavior and resources from the superclasses described
   in  the following tables.  For a complete description of each resource,
   refer to the reference page for that superclass.

   
                                           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 WMShell.

RELATED

   Composite(3), Core(3), and Shell(3).

                                                                WMShell(3)



Opportunity


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.


Free Software


Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.


Free Books


The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.


Education


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.