


   XmCommand(3X)



   NAME
     XXmmCCoommmmaanndd-The Command widget class

   SYNOPSIS
     ##iinncclluuddee <<XXmm//CCoommmmaanndd..hh>>

   DESCRIPTION
     Command is a special-purpose composite widget for command entry that
     provides a built-in command-history mechanism.  Command includes a
     command-line text-input field, a command-line prompt, and a command-
     history list region.

     One additional WWoorrkkAArreeaa child may be added to the Command after crea-
     tion.

     Whenever a command is entered, it is automatically added to the end of
     the command-history list and made visible.  This does not change the
     selected item in the list, if there is one.

     Many of the new resources specified for Command are actually Selection-
     Box resources that have been renamed for clarity and ease of use.

     Classes

     Command inherits behavior and resources from CCoorree, CCoommppoossiittee, CCoonn--
     ssttrraaiinntt, XXmmMMaannaaggeerr, XXmmBBuulllleettiinnBBooaarrdd, and XXmmSSeelleeccttiioonnBBooxx classes.

     The class pointer is xxmmCCoommmmaannddWWiiddggeettCCllaassss.

     The class name is XXmmCCoommmmaanndd.

     New Resources

     The following table defines a set of widget resources used by the pro-
     grammer 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 XXmmNN or XXmmCC prefix and use the remaining letters.  To specify one of
     the defined values for a resource in a .Xdefaults file, remove the XXmm
     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 XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G), or is
     not applicable (N/A).
                                  XXmmCCoommmmaanndd RReessoouurrccee SSeett
   NNaammee                         CCllaassss                 TTyyppee             DDeeffaauulltt   AAcccceessss
   ____________________________________________________________________________________
   XmNcommand                   XmCTextString         XmString         ""        CSG
   XmNcommandChangedCallback    XmCCallback           XtCallbackList   NULL      C
   XmNcommandEnteredCallback    XmCCallback           XtCallbackList   NULL      C
   XmNhistoryItems              XmCItems              XmStringTable    NULL      CSG
   XmNhistoryItemCount          XmCItemCount          int              0         CSG
   XmNhistoryMaxItems           XmCMaxItems           int              100       CSG


   1-194






                                                                XmCommand(3X)


   XmNhistoryVisibleItemCount   XmCVisibleItemCount   int              dynamic   CSG
   XmNpromptString              XmCPromptString       XmString         dynamic   CSG

     XXmmNNccoommmmaanndd
               Contains the current command-line text.  This is the XXmmNNtteexxtt--
               SSttrriinngg resource in SelectionBox, renamed for Command.  This
               resource can also be modified via XXmmCCoommmmaannddSSeettVVaalluuee and XXmmCCoomm--
               mmaannddAAppppeennddVVaalluuee functions.  The command area is a Text widget.

     XXmmNNccoommmmaannddCChhaannggeeddCCaallllbbaacckk
               Specifies the list of callbacks that is called when the value
               of the command changes.  The callback reason is
               XXmmCCRR__CCOOMMMMAANNDD__CCHHAANNGGEEDD.  This is equivalent to the
               XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk of the Text widget, except that a
               pointer to an XXmmCCoommmmaannddCCaallllbbaacckkSSttrruuccttuurree is passed, and the
               structure's _v_a_l_u_e member contains the XXmmSSttrriinngg.

     XXmmNNccoommmmaannddEEnntteerreeddCCaallllbbaacckk
               Specifies the list of callbacks that is called when a command
               is entered in the Command.  The callback reason is
               XXmmCCRR__CCOOMMMMAANNDD__EENNTTEERREEDD.  A pointer to an XXmmCCoommmmaannddCCaallllbbaacckk
               structure is passed.

     XXmmNNhhiissttoorryyIItteemmss
               Lists XXmmSSttrriinngg items that make up the contents of the history
               list.  This is the XXmmNNlliissttIItteemmss resource in SelectionBox,
               renamed for Command.  XXttGGeettVVaalluueess for this resource returns
               the list items themselves, not a copy of the list items.  The
               application must not free the returned items.

     XXmmNNhhiissttoorryyIItteemmCCoouunntt
               Specifies the number of XXmmSSttrriinnggss in XXmmNNhhiissttoorryyIItteemmss.  This is
               the XXmmNNlliissttIItteemmCCoouunntt resource in SelectionBox, renamed for
               Command.  The value must not be negative.

     XXmmNNhhiissttoorryyMMaaxxIItteemmss
               Specifies the maximum number of items allowed in the history
               list.  Once this number is reached, an existing list item must
               be removed before a new item can be added to the list.  For
               each command entered, the first list item is removed from the
               list, so the new command can be added to the list.  The value
               must be greater than 0.

     XXmmNNhhiissttoorryyVViissiibblleeIItteemmCCoouunntt
               Specifies the number of items in the history list that should
               be visible at one time.  In effect, it sets the height (in
               lines) of the history list window.  This is the XXmmNNlliissttVViissii--
               bblleeIItteemmCCoouunntt resource in SelectionBox, renamed for Command.
               The value must be greater than 0.  The default is dynamic
               based on the height of the list.

     XXmmNNpprroommppttSSttrriinngg
               Specifies a prompt for the command line.  This is the
               XXmmNNsseelleeccttiioonnLLaabbeellSSttrriinngg resource in SelectionBox, renamed for


   1-195






   XmCommand(3X)


               Command.  The default may vary depending on the value of the
               XXmmNNssttrriinnggDDiirreeccttiioonn resource and the locale.  In the C locale
               the default is ">".

     Inherited Resources

     Command inherits behavior and resources from the following superclasses.
     For a complete description of each resource, refer to the man page for
     that superclass.
                                        XXmmSSeelleeccttiioonnBBooxx RReessoouurrccee SSeett
   NNaammee                      CCllaassss                     TTyyppee             DDeeffaauulltt                   AAcccceessss
   _____________________________________________________________________________________________________
   XmNapplyCallback          XmCCallback               XtCallbackList   NULL                      N/A
   XmNapplyLabelString       XmCApplyLabelString       XmString         dynamic                   N/A
   XmNcancelCallback         XmCCallback               XtCallbackList   NULL                      N/A
   XmNcancelLabelString      XmCCancelLabelString      XmString         dynamic                   N/A
   XmNchildPlacement         XmCChildPlacement         unsigned char    XmPLACE_ABOVE_SELECTION   CSG
   XmNdialogType             XmCDialogType             unsigned char    XmDIALOG_COMMAND          G
   XmNhelpLabelString        XmCHelpLabelString        XmString         dynamic                   N/A
   XmNlistItemCount          XmCItemCount              int              0                         CSG
   XmNlistItems              XmCItems                  XmStringTable    NULL                      CSG
   XmNlistLabelString        XmCListLabelString        XmString         NULL                      N/A
   XmNlistVisibleItemCount   XmCVisibleItemCount       int              dynamic                   CSG
   XmNminimizeButtons        XmCMinimizeButtons        Boolean          False                     N/A
   XmNmustMatch              XmCMustMatch              Boolean          False                     N/A
   XmNnoMatchCallback        XmCCallback               XtCallbackList   NULL                      N/A
   XmNokCallback             XmCCallback               XtCallbackList   NULL                      N/A
   XmNokLabelString          XmCOkLabelString          XmString         dynamic                   N/A
   XmNselectionLabelString   XmCSelectionLabelString   XmString         dynamic                   CSG
   XmNtextAccelerators       XmCTextAccelerators       XtAccelerators   default                   C
   XmNtextColumns            XmCColumns                short            dynamic                   CSG
   XmNtextString             XmCTextString             XmString         ""                        CSG
                              XXmmBBuulllleettiinnBBooaarrdd RReessoouurrccee SSeett
   NNaammee                  CCllaassss                TTyyppee             DDeeffaauulltt         AAcccceessss
   __________________________________________________________________________________
   XmNallowOverlap       XmCAllowOverlap      Boolean          True            CSG
   XmNautoUnmanage       XmCAutoUnmanage      Boolean          False           N/A
   XmNbuttonFontList     XmCButtonFontList    XmFontList       dynamic         N/A
   XmNcancelButton       XmCWidget            Widget           NULL            N/A
   XmNdefaultButton      XmCWidget            Widget           NULL            N/A
   XmNdefaultPosition    XmCDefaultPosition   Boolean          False           CSG
   XmNdialogStyle        XmCDialogStyle       unsigned char    dynamic         CSG
   XmNdialogTitle        XmCDialogTitle       XmString         NULL            CSG
   XmNfocusCallback      XmCCallback          XtCallbackList   NULL            C
   XmNlabelFontList      XmCLabelFontList     XmFontList       dynamic         CSG
   XmNmapCallback        XmCCallback          XtCallbackList   NULL            C
   XmNmarginHeight       XmCMarginHeight      Dimension        10              CSG
   XmNmarginWidth        XmCMarginWidth       Dimension        10              CSG
   XmNnoResize           XmCNoResize          Boolean          False           CSG
   XmNresizePolicy       XmCResizePolicy      unsigned char    XmRESIZE_NONE   CSG
   XmNshadowType         XmCShadowType        unsigned char    XmSHADOW_OUT    CSG
   XmNtextFontList       XmCTextFontList      XmFontList       dynamic         CSG
   XmNtextTranslations   XmCTranslations      XtTranslations   NULL            C
   XmNunmapCallback      XmCCallback          XtCallbackList   NULL            C


   1-196






                                                                XmCommand(3X)


                                        XXmmMMaannaaggeerr RReessoouurrccee SSeett
   NNaammee                    CCllaassss                   TTyyppee                DDeeffaauulltt                AAcccceessss
   _________________________________________________________________________________________________
   XmNbottomShadowColor    XmCBottomShadowColor    Pixel               dynamic                CSG
   XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
   XmNforeground           XmCForeground           Pixel               dynamic                CSG
   XmNhelpCallback         XmCCallback             XtCallbackList      NULL                   C
   XmNhighlightColor       XmCHighlightColor       Pixel               dynamic                CSG
   XmNhighlightPixmap      XmCHighlightPixmap      Pixmap              dynamic                CSG
   XmNinitialFocus         XmCInitialFocus         Widget              dynamic                CSG
   XmNnavigationType       XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
   XmNshadowThickness      XmCShadowThickness      Dimension           dynamic                CSG
   XmNstringDirection      XmCStringDirection      XmStringDirection   dynamic                CG
   XmNtopShadowColor       XmCTopShadowColor       Pixel               dynamic                CSG
   XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap              dynamic                CSG
   XmNtraversalOn          XmCTraversalOn          Boolean             True                   CSG
   XmNunitType             XmCUnitType             unsigned char       dynamic                CSG
   XmNuserData             XmCUserData             XtPointer           NULL                   CSG
                              CCoommppoossiittee RReessoouurrccee SSeett
      NNaammee                CCllaassss               TTyyppee          DDeeffaauulltt   AAcccceessss
      ______________________________________________________________________
      XmNchildren         XmCReadOnly         WidgetList    NULL      G
      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
      XmNnumChildren      XmCReadOnly         Cardinal      0         G
                                                 CCoorree RReessoouurrccee SSeett
   NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                AAcccceessss
   ______________________________________________________________________________________________________________
   XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                N/A
   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

     Callback Information

     A pointer to the following structure is passed to each callback:
     ttyyppeeddeeff ssttrruucctt
     {{
       iinntt      _r_e_a_s_o_n;;
       XXEEvveenntt   * _e_v_e_n_t;;


   1-197






   XmCommand(3X)


       XXmmSSttrriinngg _v_a_l_u_e;;
       iinntt      _l_e_n_g_t_h;;
     }} XXmmCCoommmmaannddCCaallllbbaacckkSSttrruucctt;;

     _r_e_a_s_o_n Indicates why the callback was invoked

     _e_v_e_n_t  Points to the XXEEvveenntt that triggered the callback

     _v_a_l_u_e  Specifies the XXmmSSttrriinngg in the CommandArea

     _l_e_n_g_t_h Specifies the size of the command in XXmmSSttrriinngg

     Translations

     XmCommand inherits translations from XmSelectionBox.

     Accelerators

     The XXmmNNtteexxttAAcccceelleerraattoorrss from XmSelectionBox are added to the Text des-
     cendant of XmCommand.

     Action Routines

     The XmCommand action routines are described below:

     SSeelleeccttiioonnBBooxxUUppOOrrDDoowwnn((00||11||22||33)):
               When called with a 0 argument, selects the previous item in
               the history list and replaces the text with that item.  When
               called with a 1 argument, selects the next item in the history
               list and replaces the text with that item.  When called with a
               2 argument, selects the first item in the history list and
               replaces the text with that item.  When called with a 3 argu-
               ment, selects the last item in the history list and replaces
               the text with that item.  Calls the callbacks for XXmmNNccoomm--
               mmaannddCChhaannggeeddCCaallllbbaacckk.

     Additional Behavior

     The Command widget has the additional behavior described below:

     MMAAnnyy KKCCaanncceell:
               If the parent of the Command is a manager, the event is passed
               to the parent.

     KKAAccttiivvaattee in Text:
               Calls the Text widget's XXmmNNaaccttiivvaatteeCCaallllbbaacckk callbacks.  If the
               text is empty, this action then returns.  Otherwise, if the
               history list has XXmmNNhhiissttoorryyMMaaxxIItteemmss items, it removes the
               first item in the list.  It adds the text to the history list
               as the last item, clears the text, and calls the XXmmNNccoommmmaannddEEnn--
               tteerreeddCCaallllbbaacckk callbacks.

     <<KKeeyy>> in Text:
               When any change is made to the text edit widget, this action


   1-198






                                                                XmCommand(3X)


               calls the callbacks for XXmmNNccoommmmaannddCChhaannggeeddCCaallllbbaacckk.

     <<DDoouubblleeCClliicckk>> or <<KKAAccttiivvaattee>> in List:
               Calls the List widget's XXmmNNddeeffaauullttAAccttiioonnCCaallllbbaacckk callbacks.
               If the history list has XXmmNNhhiissttoorryyMMaaxxIItteemmss items, this action
               removes the first item in the list.  It adds the selected List
               item to the history list as the last item, clears the text,
               and calls the XXmmNNccoommmmaannddEEnntteerreeddCCaallllbbaacckk callbacks.

     <<FFooccuussIInn>>:
               Calls the callbacks for XXmmNNffooccuussCCaallllbbaacckk.

     <<MMaappWWiinnddooww>>:
               When a Command that is the child of a DialogShell is mapped,
               this action calls the callbacks for XXmmNNmmaappCCaallllbbaacckk.

     <<UUnnmmaappWWiinnddooww>>:
               When a Command that is the child of a DialogShell is unmapped,
               this action calls the callbacks for XXmmNNuunnmmaappCCaallllbbaacckk.

     Virtual Bindings

     The bindings for virtual keys are vendor specific.  For information
     about bindings for virtual buttons and keys, see VViirrttuuaallBBiinnddiinnggss((33XX)).

   RELATED INFORMATION
     CCoommppoossiittee((33XX)), CCoonnssttrraaiinntt((33XX)), CCoorree((33XX)), XXmmBBuulllleettiinnBBooaarrdd((33XX)),
     XXmmCCoommmmaannddAAppppeennddVVaalluuee((33XX)), XXmmCCoommmmaannddEErrrroorr((33XX)), XXmmCCoommmmaannddGGeettCChhiilldd((33XX)),
     XXmmCCoommmmaannddSSeettVVaalluuee((33XX)), XXmmCCrreeaatteeCCoommmmaanndd((33XX)), XXmmMMaannaaggeerr((33XX)), and
     XXmmSSeelleeccttiioonnBBooxx((33XX)).


























   1-199






   XmCommandAppendValue(3X)



   NAME
     XXmmCCoommmmaannddAAppppeennddVVaalluuee-A Command function that appends the passed XmString
     to the end of the string displayed in the command area of the widget

   SYNOPSIS
     ##iinncclluuddee <<XXmm//CCoommmmaanndd..hh>>
     vvooiidd XXmmCCoommmmaannddAAppppeennddVVaalluuee ((_w_i_d_g_e_t, _c_o_m_m_a_n_d))
          WWiiddggeett    _w_i_d_g_e_t;;
          XXmmSSttrriinngg  _c_o_m_m_a_n_d;;

   DESCRIPTION
     XXmmCCoommmmaannddAAppppeennddVVaalluuee appends the passed XXmmSSttrriinngg to the end of the
     string displayed in the command area of the Command widget.

     _w_i_d_g_e_t Specifies the Command widget ID

     _c_o_m_m_a_n_dSpecifies the passed XXmmSSttrriinngg

     For a complete definition of Command and its associated resources, see
     XXmmCCoommmmaanndd((33XX)).

   RELATED INFORMATION
     XXmmCCoommmmaanndd((33XX)).
































   1-200






                                                           XmCommandError(3X)



   NAME
     XXmmCCoommmmaannddEErrrroorr-A Command function that displays an error message

   SYNOPSIS
     ##iinncclluuddee <<XXmm//CCoommmmaanndd..hh>>
     vvooiidd XXmmCCoommmmaannddEErrrroorr ((_w_i_d_g_e_t, _e_r_r_o_r))
          WWiiddggeett    _w_i_d_g_e_t;;
          XXmmSSttrriinngg  _e_r_r_o_r;;

   DESCRIPTION
     XXmmCCoommmmaannddEErrrroorr displays an error message in the history area of the Com-
     mand widget.  The XXmmSSttrriinngg error is displayed until the next command
     entered occurs.

     _w_i_d_g_e_t Specifies the Command widget ID

     _e_r_r_o_r  Specifies the passed XXmmSSttrriinngg

     For a complete definition of Command and its associated resources, see
     XXmmCCoommmmaanndd((33XX)).

   RELATED INFORMATION
     XXmmCCoommmmaanndd((33XX)).
































   1-201






   XmCommandGetChild(3X)



   NAME
     XXmmCCoommmmaannddGGeettCChhiilldd-A Command function that is used to access a component

   SYNOPSIS
     ##iinncclluuddee <<XXmm//CCoommmmaanndd..hh>>
     WWiiddggeett XXmmCCoommmmaannddGGeettCChhiilldd ((_w_i_d_g_e_t, _c_h_i_l_d))
          WWiiddggeett    _w_i_d_g_e_t;;
          uunnssiiggnneedd cchhaarr_c_h_i_l_d;;

   DESCRIPTION
     XXmmCCoommmmaannddGGeettCChhiilldd is used to access a component within a Command.  The
     parameters given to the function are the Command widget and a value
     indicating which component to access.

     _w_i_d_g_e_t Specifies the Command widget ID.

     _c_h_i_l_d  Specifies a component within the Command.  The following are
            legal values for this parameter:

              ++oo  XXmmDDIIAALLOOGG__CCOOMMMMAANNDD__TTEEXXTT

              ++oo  XXmmDDIIAALLOOGG__PPRROOMMPPTT__LLAABBEELL

              ++oo  XXmmDDIIAALLOOGG__HHIISSTTOORRYY__LLIISSTT

              ++oo  XXmmDDIIAALLOOGG__WWOORRKK__AARREEAA

     For a complete definition of Command and its associated resources, see
     XXmmCCoommmmaanndd((33XX)).

   RETURN VALUE
     Returns the widget ID of the specified Command component.  An applica-
     tion should not assume that the returned widget will be of any particu-
     lar class.

   RELATED INFORMATION
     XXmmCCoommmmaanndd((33XX)).


















   1-202






                                                        XmCommandSetValue(3X)



   NAME
     XXmmCCoommmmaannddSSeettVVaalluuee-A Command function that replaces a displayed string

   SYNOPSIS
     ##iinncclluuddee <<XXmm//CCoommmmaanndd..hh>>
     vvooiidd XXmmCCoommmmaannddSSeettVVaalluuee ((_w_i_d_g_e_t, _c_o_m_m_a_n_d))
          WWiiddggeett    _w_i_d_g_e_t;;
          XXmmSSttrriinngg  _c_o_m_m_a_n_d;;

   DESCRIPTION
     XXmmCCoommmmaannddSSeettVVaalluuee replaces the string displayed in the command area of
     the Command widget with the passed XXmmSSttrriinngg.

     _w_i_d_g_e_t Specifies the Command widget ID

     _c_o_m_m_a_n_dSpecifies the passed XXmmSSttrriinngg

     For a complete definition of Command and its associated resources, see
     XXmmCCoommmmaanndd((33XX)).

   RELATED INFORMATION
     XXmmCCoommmmaanndd((33XX)).

































   1-203






   XmConvertUnits(3X)



   NAME
     XXmmCCoonnvveerrttUUnniittss-A function that converts a value in one unit type to
     another unit type

   SYNOPSIS
     ##iinncclluuddee <<XXmm//XXmm..hh>>
     iinntt XXmmCCoonnvveerrttUUnniittss ((_w_i_d_g_e_t, _o_r_i_e_n_t_a_t_i_o_n, _f_r_o_m__u_n_i_t__t_y_p_e,
               _f_r_o_m__v_a_l_u_e, _t_o__u_n_i_t__t_y_p_e))
          WWiiddggeett    _w_i_d_g_e_t;;
          iinntt       _o_r_i_e_n_t_a_t_i_o_n;;
          iinntt       _f_r_o_m__u_n_i_t__t_y_p_e;;
          iinntt       _f_r_o_m__v_a_l_u_e;;
          iinntt       _t_o__u_n_i_t__t_y_p_e;;

   DESCRIPTION
     XXmmCCoonnvveerrttUUnniittss converts the value and returns it as the return value
     from the function.

     _w_i_d_g_e_t      Specifies the widget for which the data is to be converted

     _o_r_i_e_n_t_a_t_i_o_n Specifies whether the converter uses the horizontal or vert-
                 ical screen resolution when performing the conversions.
                 _o_r_i_e_n_t_a_t_i_o_n can have values of XXmmHHOORRIIZZOONNTTAALL or XXmmVVEERRTTIICCAALL.

     _f_r_o_m__u_n_i_t__t_y_p_e
                 Specifies the current unit type of the supplied value

     _f_r_o_m__v_a_l_u_e  Specifies the value to be converted

     _t_o__u_n_i_t__t_y_p_e
                 Converts the value to the unit type specified

     The parameters _f_r_o_m__u_n_i_t__t_y_p_e and _t_o__u_n_i_t__t_y_p_e can have the following
     values:

       ++oo  XXmmPPIIXXEELLSS-all values provided to the widget are treated as normal
          pixel values.  This is the default for the resource.

       ++oo  XXmm110000TTHH__MMIILLLLIIMMEETTEERRSS-all values provided to the widget are treated
          as 1/100 millimeter.

       ++oo  XXmm11000000TTHH__IINNCCHHEESS-all values provided to the widget are treated as
          1/1000 inch.

       ++oo  XXmm110000TTHH__PPOOIINNTTSS-all values provided to the widget are treated as
          1/100 point.  A point is a unit typically used in text processing
          applications and is defined as 1/72 inch.

       ++oo  XXmm110000TTHH__FFOONNTT__UUNNIITTSS-all values provided to the widget are treated as
          1/100 of a font unit.  A font unit has horizontal and vertical com-
          ponents.  These are the values of the XmScreen resources XXmmNNhhoorr--
          iizzoonnttaallFFoonnttUUnniitt and XXmmNNvveerrttiiccaallFFoonnttUUnniitt.



   1-204






                                                           XmConvertUnits(3X)


   RETURN VALUE
     Returns the converted value.  If a NULL widget, incorrect _o_r_i_e_n_t_a_t_i_o_n,
     or incorrect _u_n_i_t__t_y_p_e is supplied as parameter data, 0 is returned.

   RELATED INFORMATION
     XXmmSSeettFFoonnttUUnniittss((33XX)) and XXmmSSccrreeeenn((33XX)).


















































   1-205






   XmCreateArrowButton(3X)



   NAME
     XXmmCCrreeaatteeAArrrroowwBBuuttttoonn-The ArrowButton widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//AArrrroowwBB..hh>>
     WWiiddggeett XXmmCCrreeaatteeAArrrroowwBBuuttttoonn ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeAArrrroowwBBuuttttoonn creates an instance of an ArrowButton widget and
     returns the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of ArrowButton and its associated resources,
     see XXmmAArrrroowwBBuuttttoonn((33XX)).

   RETURN VALUE
     Returns the ArrowButton widget ID.

   RELATED INFORMATION
     XXmmAArrrroowwBBuuttttoonn((33XX)).






















   1-206






                                                XmCreateArrowButtonGadget(3X)



   NAME
     XXmmCCrreeaatteeAArrrroowwBBuuttttoonnGGaaddggeett-The ArrowButtonGadget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//AArrrroowwBBGG..hh>>
     WWiiddggeett XXmmCCrreeaatteeAArrrroowwBBuuttttoonnGGaaddggeett ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeAArrrroowwBBuuttttoonnGGaaddggeett creates an instance of an ArrowButtonGadget
     widget and returns the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of ArrowButtonGadget and its associated
     resources, see XXmmAArrrroowwBBuuttttoonnGGaaddggeett((33XX)).

   RETURN VALUE
     Returns the ArrowButtonGadget widget ID.

   RELATED INFORMATION
     XXmmAArrrroowwBBuuttttoonnGGaaddggeett((33XX)).






















   1-207






   XmCreateBulletinBoard(3X)



   NAME
     XXmmCCrreeaatteeBBuulllleettiinnBBooaarrdd-The BulletinBoard widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//BBuulllleettiinnBB..hh>>
     WWiiddggeett XXmmCCrreeaatteeBBuulllleettiinnBBooaarrdd ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeBBuulllleettiinnBBooaarrdd creates an instance of a BulletinBoard widget and
     returns the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of BulletinBoard and its associated resources,
     see XXmmBBuulllleettiinnBBooaarrdd((33XX)).

   RETURN VALUE
     Returns the BulletinBoard widget ID.

   RELATED INFORMATION
     XXmmBBuulllleettiinnBBooaarrdd((33XX)).






















   1-208






                                              XmCreateBulletinBoardDialog(3X)



   NAME
     XXmmCCrreeaatteeBBuulllleettiinnBBooaarrddDDiiaalloogg-The BulletinBoard BulletinBoardDialog con-
     venience creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//BBuulllleettiinnBB..hh>>
     WWiiddggeett XXmmCCrreeaatteeBBuulllleettiinnBBooaarrddDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeBBuulllleettiinnBBooaarrddDDiiaalloogg is a convenience creation function that
     creates a DialogShell and an unmanaged BulletinBoard child of the Dia-
     logShell.  A BulletinBoardDialog is used for interactions not supported
     by the standard dialog set.  This function does not automatically create
     any labels, buttons, or other dialog components.  Such components should
     be added by the application after the BulletinBoardDialog is created.

     Use XXttMMaannaaggeeCChhiilldd to pop up the BulletinBoardDialog (passing the Bul-
     letinBoard as the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to pop it down.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of BulletinBoard and its associated resources,
     see XXmmBBuulllleettiinnBBooaarrdd((33XX)).

   RETURN VALUE
     Returns the BulletinBoard widget ID.

   RELATED INFORMATION
     XXmmBBuulllleettiinnBBooaarrdd((33XX)).














   1-209






   XmCreateCascadeButton(3X)



   NAME
     XXmmCCrreeaatteeCCaassccaaddeeBBuuttttoonn-The CascadeButton widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//CCaassccaaddeeBB..hh>>
     WWiiddggeett XXmmCCrreeaatteeCCaassccaaddeeBBuuttttoonn ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeCCaassccaaddeeBBuuttttoonn creates an instance of a CascadeButton widget and
     returns the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID.  The parent must be a RowColumn
            widget.

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of CascadeButton and its associated resources,
     see XXmmCCaassccaaddeeBBuuttttoonn((33XX)).

   RETURN VALUE
     Returns the CascadeButton widget ID.

   RELATED INFORMATION
     XXmmCCaassccaaddeeBBuuttttoonn((33XX)).





















   1-210






                                              XmCreateCascadeButtonGadget(3X)



   NAME
     XXmmCCrreeaatteeCCaassccaaddeeBBuuttttoonnGGaaddggeett-The CascadeButtonGadget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//CCaassccaaddeeBBGG..hh>>
     WWiiddggeett XXmmCCrreeaatteeCCaassccaaddeeBBuuttttoonnGGaaddggeett ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeCCaassccaaddeeBBuuttttoonnGGaaddggeett creates an instance of a CascadeButtonGadget
     and returns the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID.  The parent must be a RowColumn
            widget.

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of CascadeButtonGadget and its associated
     resources, see XXmmCCaassccaaddeeBBuuttttoonnGGaaddggeett((33XX)).

   RETURN VALUE
     Returns the CascadeButtonGadget widget ID.

   RELATED INFORMATION
     XXmmCCaassccaaddeeBBuuttttoonnGGaaddggeett((33XX)).





















   1-211






   XmCreateCommand(3X)



   NAME
     XXmmCCrreeaatteeCCoommmmaanndd-The Command widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//CCoommmmaanndd..hh>>
     WWiiddggeett XXmmCCrreeaatteeCCoommmmaanndd ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeCCoommmmaanndd creates an instance of a Command widget and returns the
     associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of Command and its associated resources, see
     XXmmCCoommmmaanndd((33XX)).

   RETURN VALUE
     Returns the Command widget ID.

   RELATED INFORMATION
     XXmmCCoommmmaanndd((33XX)).






















   1-212






                                                      XmCreateDialogShell(3X)



   NAME
     XXmmCCrreeaatteeDDiiaallooggSShheellll-The DialogShell widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//DDiiaallooggSS..hh>>
     WWiiddggeett XXmmCCrreeaatteeDDiiaallooggSShheellll ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeDDiiaallooggSShheellll creates an instance of a DialogShell widget and
     returns the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of DialogShell and its associated resources,
     see XXmmDDiiaallooggSShheellll((33XX)).

   RETURN VALUE
     Returns the DialogShell widget ID.

   RELATED INFORMATION
     XXmmDDiiaallooggSShheellll((33XX)).






















   1-213






   XmCreateDragIcon(3X)



   NAME
     XXmmCCrreeaatteeDDrraaggIIccoonn-A Drag and Drop function that creates a DragIcon widget

   SYNOPSIS
     ##iinncclluuddee <<XXmm//DDrraaggIIccoonn..hh>>
     WWiiddggeett XXmmCCrreeaatteeDDrraaggIIccoonn ((_w_i_d_g_e_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett      _w_i_d_g_e_t;;
          SSttrriinngg      _n_a_m_e;;
          AArrggLLiisstt     _a_r_g_l_i_s_t;;
          CCaarrddiinnaall    _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeDDrraaggIIccoonn creates a DragIcon and returns the associated widget
     ID.

     _w_i_d_g_e_t Specifies the ID of the widget that the function uses to access
            default values for visual attributes of the DragIcon.  This
            widget may be different than the actual parent of the DragIcon.

     _n_a_m_e   Specifies the name of the DragIcon widget.

     _a_r_g_l_i_s_tSpecifies the argument list.

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t).

     For a complete definition of DragIcon and its associated resources, see
     XXmmDDrraaggIIccoonn((33XX)).

   RETURN VALUE
     The function creates a DragIcon and returns the associated widget ID.

   RELATED INFORMATION
     XXmmDDrraaggCCoonntteexxtt((33XX)), XXmmDDrraaggIIccoonn((33XX)), and XXmmSSccrreeeenn((33XX)).




















   1-214






                                                      XmCreateDrawingArea(3X)



   NAME
     XXmmCCrreeaatteeDDrraawwiinnggAArreeaa-The DrawingArea widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//DDrraawwiinnggAA..hh>>
     WWiiddggeett XXmmCCrreeaatteeDDrraawwiinnggAArreeaa ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeDDrraawwiinnggAArreeaa creates an instance of a DrawingArea widget and
     returns the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of DrawingArea and its associated resources,
     see XXmmDDrraawwiinnggAArreeaa((33XX)).

   RETURN VALUE
     Returns the DrawingArea widget ID.

   RELATED INFORMATION
     XXmmDDrraawwiinnggAArreeaa((33XX)).






















   1-215






   XmCreateDrawnButton(3X)



   NAME
     XXmmCCrreeaatteeDDrraawwnnBBuuttttoonn-The DrawnButton widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//DDrraawwnnBB..hh>>
     WWiiddggeett XXmmCCrreeaatteeDDrraawwnnBBuuttttoonn ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeDDrraawwnnBBuuttttoonn creates an instance of a DrawnButton widget and
     returns the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of DrawnButton and its associated resources,
     see XXmmDDrraawwnnBBuuttttoonn((33XX)).

   RETURN VALUE
     Returns the DrawnButton widget ID.

   RELATED INFORMATION
     XXmmDDrraawwnnBBuuttttoonn((33XX)).






















   1-216






                                                      XmCreateErrorDialog(3X)



   NAME
     XXmmCCrreeaatteeEErrrroorrDDiiaalloogg-The MessageBox ErrorDialog convenience creation
     function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>
     WWiiddggeett XXmmCCrreeaatteeEErrrroorrDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeEErrrroorrDDiiaalloogg is a convenience creation function that creates a
     DialogShell and an unmanaged MessageBox child of the DialogShell.  An
     ErrorDialog warns the user of an invalid or potentially dangerous condi-
     tion.  It includes a symbol, a message, and three buttons.  The default
     symbol is an octagon with a diagonal slash.  The default button labels
     are OOKK, CCaanncceell, and HHeellpp.

     Use XXttMMaannaaggeeCChhiilldd to pop up the ErrorDialog (passing the MessageBox as
     the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to pop it down.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of MessageBox and its associated resources,
     see XXmmMMeessssaaggeeBBooxx((33XX)).

   RETURN VALUE
     Returns the MessageBox widget ID.

   RELATED INFORMATION
     XXmmMMeessssaaggeeBBooxx((33XX)).














   1-217






   XmCreateFileSelectionBox(3X)



   NAME
     XXmmCCrreeaatteeFFiilleeSSeelleeccttiioonnBBooxx-The FileSelectionBox widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//FFiilleeSSBB..hh>>
     WWiiddggeett XXmmCCrreeaatteeFFiilleeSSeelleeccttiioonnBBooxx ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeFFiilleeSSeelleeccttiioonnBBooxx creates an unmanaged FileSelectionBox.  A
     FileSelectionBox is used to select a file and includes the following:

       ++oo  An editable text field for the directory mask

       ++oo  A scrolling list of file names

       ++oo  An editable text field for the selected file

       ++oo  Labels for the list and text fields

       ++oo  Four buttons

     The default button labels are OOKK, FFiilltteerr, CCaanncceell, and HHeellpp. Additional
     work area children may be added to the FileSelectionBox after creation.
     FileSelectionBox inherits the layout functionality provided by Selec-
     tionBox for any additional work area children.

     If the parent of the FileSelectionBox is a DialogShell, use
     XXttMMaannaaggeeCChhiilldd to pop up the FileSelectionDialog (passing the FileSelec-
     tionBox as the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to pop it down.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of FileSelectionBox and its associated
     resources, see XXmmFFiilleeSSeelleeccttiioonnBBooxx((33XX)).

   RETURN VALUE
     Returns the FileSelectionBox widget ID.






   1-218






                                                 XmCreateFileSelectionBox(3X)


   RELATED INFORMATION
     XXmmFFiilleeSSeelleeccttiioonnBBooxx((33XX)).






















































   1-219






   XmCreateFileSelectionDialog(3X)



   NAME
     XXmmCCrreeaatteeFFiilleeSSeelleeccttiioonnDDiiaalloogg-The FileSelectionBox FileSelectionDialog
     convenience creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//FFiilleeSSBB..hh>>
     WWiiddggeett XXmmCCrreeaatteeFFiilleeSSeelleeccttiioonnDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeFFiilleeSSeelleeccttiioonnDDiiaalloogg is a convenience creation function that
     creates a DialogShell and an unmanaged FileSelectionBox child of the
     DialogShell.  A FileSelectionDialog selects a file.  It includes the
     following:

       ++oo  An editable text field for the directory mask

       ++oo  A scrolling list of filenames

       ++oo  An editable text field for the selected file

       ++oo  Labels for the list and text fields

       ++oo  Four buttons

     The default button labels are: OOKK, FFiilltteerr, CCaanncceell, and HHeellpp.  One addi-
     tional WWoorrkkAArreeaa child may be added to the FileSelectionBox after crea-
     tion.

     Use XXttMMaannaaggeeCChhiilldd to pop up the FileSelectionDialog (passing the
     FileSelectionBox as the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to pop it
     down.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of FileSelectionBox and its associated
     resources, see XXmmFFiilleeSSeelleeccttiioonnBBooxx((33XX)).

   RETURN VALUE
     Returns the FileSelectionBox widget ID.




   1-220






                                              XmCreateFileSelectionDialog(3X)


   RELATED INFORMATION
     XXmmFFiilleeSSeelleeccttiioonnBBooxx((33XX)).






















































   1-221






   XmCreateForm(3X)



   NAME
     XXmmCCrreeaatteeFFoorrmm-The Form widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//FFoorrmm..hh>>
     WWiiddggeett XXmmCCrreeaatteeFFoorrmm ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeFFoorrmm creates an instance of a Form widget and returns the asso-
     ciated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of Form and its associated resources, see
     XXmmFFoorrmm((33XX)).

   RETURN VALUE
     Returns the Form widget ID.

   RELATED INFORMATION
     XXmmFFoorrmm((33XX)).






















   1-222






                                                       XmCreateFormDialog(3X)



   NAME
     XXmmCCrreeaatteeFFoorrmmDDiiaalloogg-A Form FormDialog convenience creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//FFoorrmm..hh>>
     WWiiddggeett XXmmCCrreeaatteeFFoorrmmDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeFFoorrmmDDiiaalloogg is a convenience creation function that creates a
     DialogShell and an unmanaged Form child of the DialogShell.  A FormDia-
     log is used for interactions not supported by the standard dialog set.
     This function does not automatically create any labels, buttons, or
     other dialog components.  Such components should be added by the appli-
     cation after the FormDialog is created.

     Use XXttMMaannaaggeeCChhiilldd to pop up the FormDialog (passing the Form as the
     widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to pop it down.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of Form and its associated resources, see
     XXmmFFoorrmm((33XX)).

   RETURN VALUE
     Returns the Form widget ID.

   RELATED INFORMATION
     XXmmFFoorrmm((33XX)).















   1-223






   XmCreateFrame(3X)



   NAME
     XXmmCCrreeaatteeFFrraammee-The Frame widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//FFrraammee..hh>>
     WWiiddggeett XXmmCCrreeaatteeFFrraammee ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeFFrraammee creates an instance of a Frame widget and returns the
     associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of Frame and its associated resources, see
     XXmmFFrraammee((33XX)).

   RETURN VALUE
     Returns the Frame widget ID.

   RELATED INFORMATION
     XXmmFFrraammee((33XX)).






















   1-224






                                                XmCreateInformationDialog(3X)



   NAME
     XXmmCCrreeaatteeIInnffoorrmmaattiioonnDDiiaalloogg-The MessageBox InformationDialog convenience
     creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>
     WWiiddggeett XXmmCCrreeaatteeIInnffoorrmmaattiioonnDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeIInnffoorrmmaattiioonnDDiiaalloogg is a convenience creation function that
     creates a DialogShell and an unmanaged MessageBox child of the Dialog-
     Shell.  An InformationDialog gives the user information, such as the
     status of an action.  It includes a symbol, a message, and three but-
     tons.  The default symbol is a lower case ii.  The default button labels
     are OOKK, CCaanncceell, and HHeellpp.

     Use XXttMMaannaaggeeCChhiilldd to pop up the InformationDialog (passing the Message-
     Box as the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to pop it down.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of MessageBox and its associated resources,
     see XXmmMMeessssaaggeeBBooxx((33XX)).

   RETURN VALUE
     Returns the MessageBox widget ID.

   RELATED INFORMATION
     XXmmMMeessssaaggeeBBooxx((33XX)).














   1-225






   XmCreateLabel(3X)



   NAME
     XXmmCCrreeaatteeLLaabbeell-The Label widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//LLaabbeell..hh>>
     WWiiddggeett XXmmCCrreeaatteeLLaabbeell ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeLLaabbeell creates an instance of a Label widget and returns the
     associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of Label and its associated resources, see
     XXmmLLaabbeell((33XX)).

   RETURN VALUE
     Returns the Label widget ID.

   RELATED INFORMATION
     XXmmLLaabbeell((33XX)).






















   1-226






                                                      XmCreateLabelGadget(3X)



   NAME
     XXmmCCrreeaatteeLLaabbeellGGaaddggeett-The LabelGadget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//LLaabbeellGG..hh>>
     WWiiddggeett XXmmCCrreeaatteeLLaabbeellGGaaddggeett ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeLLaabbeellGGaaddggeett creates an instance of a LabelGadget widget and
     returns the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of LabelGadget and its associated resources,
     see XXmmLLaabbeellGGaaddggeett((33XX)).

   RETURN VALUE
     Returns the LabelGadget widget ID.

   RELATED INFORMATION
     XXmmLLaabbeellGGaaddggeett((33XX)).






















   1-227






   XmCreateList(3X)



   NAME
     XXmmCCrreeaatteeLLiisstt-The List widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//LLiisstt..hh>>
     WWiiddggeett XXmmCCrreeaatteeLLiisstt ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeLLiisstt creates an instance of a List widget and returns the asso-
     ciated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of List and its associated resources, see
     XXmmLLiisstt((33XX)).

   RETURN VALUE
     Returns the List widget ID.

   RELATED INFORMATION
     XXmmLLiisstt((33XX)).






















   1-228






                                                       XmCreateMainWindow(3X)



   NAME
     XXmmCCrreeaatteeMMaaiinnWWiinnddooww-The MainWindow widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMaaiinnWW..hh>>
     WWiiddggeett XXmmCCrreeaatteeMMaaiinnWWiinnddooww ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeMMaaiinnWWiinnddooww creates an instance of a MainWindow widget and
     returns the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of MainWindow and its associated resources,
     see XXmmMMaaiinnWWiinnddooww((33XX)).

   RETURN VALUE
     Returns the MainWindow widget ID.

   RELATED INFORMATION
     XXmmMMaaiinnWWiinnddooww((33XX)).






















   1-229






   XmCreateMenuBar(3X)



   NAME
     XXmmCCrreeaatteeMMeennuuBBaarr-A RowColumn widget convenience creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXmmCCrreeaatteeMMeennuuBBaarr ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeMMeennuuBBaarr creates an instance of a RowColumn widget of type
     XXmmMMEENNUU__BBAARR and returns the associated widget ID.It is provided as a con-
     venience function for creating RowColumn widgets configured to operate
     as a MenuBar and is not implemented as a separate widget class.

     The MenuBar widget is generally used for building a Pulldown menu sys-
     tem.  Typically, a MenuBar is created and placed along the top of the
     application window, and several CascadeButtons are inserted as the chil-
     dren.  Each of the CascadeButtons has a Pulldown MenuPane associated
     with it.  These Pulldown MenuPanes must have been created as children of
     the MenuBar.  The user interacts with the MenuBar by using either the
     mouse or the keyboard.

     The MenuBar displays a 3-D shadow along its border.  The application
     controls the shadow attributes using the visual-related resources sup-
     ported by XXmmMMaannaaggeerr.

     The MenuBar widget is  homogeneous in that it accepts only children that
     are a subclass of XXmmCCaassccaaddeeBBuuttttoonn or XXmmCCaassccaaddeeBBuuttttoonnGGaaddggeett.  Attempting
     to insert a child of a different class results in a warning message.

     If the MenuBar does not have enough room to fit all of its subwidgets on
     a single line, the MenuBar attempts to wrap the remaining entries onto
     additional lines if allowed by the geometry manager of the parent
     widget.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of RowColumn and its associated resources, see
     XXmmRRoowwCCoolluummnn((33XX)).





   1-230






                                                          XmCreateMenuBar(3X)


   RETURN VALUE
     Returns the RowColumn widget ID.

   RELATED INFORMATION
     XXmmCCaassccaaddeeBBuuttttoonn((33XX)), XXmmCCaassccaaddeeBBuuttttoonnGGaaddggeett((33XX)),
     XXmmCCrreeaatteePPuullllddoowwnnMMeennuu((33XX)), XXmmCCrreeaatteeSSiimmpplleeMMeennuuBBaarr((33XX)), XXmmMMaannaaggeerr((33XX)),
     XXmmRRoowwCCoolluummnn((33XX)), and XXmmVVaaCCrreeaatteeSSiimmpplleeMMeennuuBBaarr((33XX)).

















































   1-231






   XmCreateMenuShell(3X)



   NAME
     XXmmCCrreeaatteeMMeennuuSShheellll-The MenuShell widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMeennuuSShheellll..hh>>
     WWiiddggeett XXmmCCrreeaatteeMMeennuuSShheellll ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeMMeennuuSShheellll creates an instance of a MenuShell widget and returns
     the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of MenuShell and its associated resources, see
     XXmmMMeennuuSShheellll((33XX)).

   RETURN VALUE
     Returns the MenuShell widget ID.

   RELATED INFORMATION
     XXmmMMeennuuSShheellll((33XX)).






















   1-232






                                                       XmCreateMessageBox(3X)



   NAME
     XXmmCCrreeaatteeMMeessssaaggeeBBooxx-The MessageBox widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>
     WWiiddggeett XXmmCCrreeaatteeMMeessssaaggeeBBooxx ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeMMeessssaaggeeBBooxx creates an unmanaged MessageBox.  A MessageBox is
     used for common interaction tasks, which include giving information,
     asking questions, and reporting errors.  It includes an optional symbol,
     a message, and three buttons.

     By default, there is no symbol.  The default button labels are OOKK, CCaann--
     cceell, and HHeellpp.

     If the parent of the MessageBox is a DialogShell, use XXttMMaannaaggeeCChhiilldd to
     pop up the MessageBox (passing the MessageBox as the widget parameter);
     use XXttUUnnmmaannaaggeeCChhiilldd to pop it down.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of MessageBox and its associated resources,
     see XXmmMMeessssaaggeeBBooxx((33XX)).

   RETURN VALUE
     Returns the MessageBox widget ID.

   RELATED INFORMATION
     XXmmMMeessssaaggeeBBooxx((33XX)).













   1-233






   XmCreateMessageDialog(3X)



   NAME
     XXmmCCrreeaatteeMMeessssaaggeeDDiiaalloogg-The MessageBox MessageDialog convenience creation
     function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>
     WWiiddggeett XXmmCCrreeaatteeMMeessssaaggeeDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeMMeessssaaggeeDDiiaalloogg is a convenience creation function that creates a
     DialogShell and an unmanaged MessageBox child of the DialogShell.  A
     MessageDialog is used for common interaction tasks, which include giving
     information, asking questions, and reporting errors.  It includes a sym-
     bol, a message, and three buttons.  By default, there is no symbol.  The
     default button labels are OOKK, CCaanncceell, and HHeellpp.

     Use XXttMMaannaaggeeCChhiilldd to pop up the MessageDialog (passing the MessageBox as
     the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to pop it down.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of MessageBox and its associated resources,
     see XXmmMMeessssaaggeeBBooxx((33XX)).

   RETURN VALUE
     Returns the MessageBox widget ID.

   RELATED INFORMATION
     XXmmMMeessssaaggeeBBooxx((33XX)).














   1-234






                                                       XmCreateOptionMenu(3X)



   NAME
     XXmmCCrreeaatteeOOppttiioonnMMeennuu-A RowColumn widget convenience creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXmmCCrreeaatteeOOppttiioonnMMeennuu ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeOOppttiioonnMMeennuu creates an instance of a RowColumn widget of type
     XXmmMMEENNUU__OOPPTTIIOONN and returns the associated widget ID.

     It is provided as a convenience function for creating a RowColumn widget
     configured to operate as an OptionMenu and is not implemented as a
     separate widget class.

     The OptionMenu widget is a specialized RowColumn manager composed of a
     label, a selection area, and a single Pulldown MenuPane.  When an appli-
     cation creates an OptionMenu widget, it supplies the label string and
     the Pulldown MenuPane.  In order to succeed, there must be a valid
     XXmmNNssuubbMMeennuuIIdd resource set when calling this function.  When the Option-
     Menu is created, the Pulldown MenuPane must have been created as a child
     of the OptionMenu's parent and must be specified.  The LabelGadget and
     the selection area (a CascadeButtonGadget) are created by the Option-
     Menu.

     The OptionMenu's Pulldown MenuPane must not contain any ToggleButtons or
     ToggleButtonGadgets.  The results of including CascadeButtons or Cas-
     cadeButtonGadgets in the OptionMenu's Pulldown MenuPane are undefined.

     An OptionMenu is laid out with the label displayed on one side of the
     widget and the selection area on the other side when XXmmNNoorriieennttaattiioonn is
     XmHORIZONTAL.  If the value is XmVERTICAL, the label is above the selec-
     tion area. The selection area has a dual purpose; it displays the label
     of the last item selected from the associated Pulldown MenuPane, and it
     provides the means for posting the Pulldown MenuPane.

     The OptionMenu typically does not display any 3-D visuals around itself
     or the internal LabelGadget.  By default, the internal CascadeBut-
     tonGadget has a visible 3-D shadow.  The application may change this by
     getting the CascadeButtonGadget ID using XXmmOOppttiioonnBBuuttttoonnGGaaddggeett, and then
     calling XXttSSeettVVaalluueess using the standard visual-related resources.

     The Pulldown MenuPane is posted by moving the mouse pointer over the
     selection area and pressing a mouse button defined by OptionMenu's
     RowColumn parent.  The Pulldown MenuPane is posted and positioned so
     that the last selected item is directly over the selection area.  The
     mouse is then used to arm the desired menu item.  When the mouse button
     is released, the armed menu item is selected and the label within the
     selection area is changed to match that of the selected item.  By


   1-235






   XmCreateOptionMenu(3X)


     default, BBSSeelleecctt is used to interact with an OptionMenu.  The default
     can be changed via the RowColumn resource XXmmNNmmeennuuPPoosstt.

     The OptionMenu also operates by using the keyboard interface mechanism.
     If the application has established a mnemonic with the OptionMenu, typ-
     ing Alt with the mnemonic causes the Pulldown MenuPane to be posted with
     traversal enabled.  The standard traversal keys can then be used to move
     within the MenuPane.  Selection can occur as the result of pressing the
     Return key or typing a mnemonic or accelerator for one of the menu
     items.

     An application may use the XXmmNNmmeennuuHHiissttoorryy resource to indicate which
     item in the Pulldown MenuPane should be treated as the current choice
     and have its label displayed in the selection area.  By default, the
     first item in the Pulldown MenuPane is used.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     The user can specify resources in a resource file for the automatically
     created widgets and gadgets of an OptionMenu.  The following list iden-
     tifies the names of these widgets (or gadgets) and the associated
     OptionMenu areas.

       ++oo

       ++oo  Option Menu Label Gadget-"OptionLabel"

       ++oo  Option Menu Cascade Button-"OptionButton"

     For a complete definition of RowColumn and its associated resources, see
     XXmmRRoowwCCoolluummnn((33XX)).

   RETURN VALUE
     Returns the RowColumn widget ID.

   RELATED INFORMATION
     XXmmCCaassccaaddeeBBuuttttoonnGGaaddggeett((33XX)), XXmmCCrreeaatteePPuullllddoowwnnMMeennuu((33XX)),
     XXmmCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu((33XX)), XXmmLLaabbeellGGaaddggeett((33XX)),
     XXmmOOppttiioonnBBuuttttoonnGGaaddggeett((33XX)), XXmmOOppttiioonnLLaabbeellGGaaddggeett((33XX)), XXmmRRoowwCCoolluummnn((33XX)), and
     XXmmVVaaCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu((33XX)).








   1-236






                                                      XmCreatePanedWindow(3X)



   NAME
     XXmmCCrreeaatteePPaanneeddWWiinnddooww-The PanedWindow widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//PPaanneeddWW..hh>>
     WWiiddggeett XXmmCCrreeaatteePPaanneeddWWiinnddooww ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteePPaanneeddWWiinnddooww creates an instance of a PanedWindow widget and
     returns the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of PanedWindow and its associated resources,
     see XXmmPPaanneeddWWiinnddooww((33XX)).

   RETURN VALUE
     Returns the PanedWindow widget ID.

   RELATED INFORMATION
     XXmmPPaanneeddWWiinnddooww((33XX)).






















   1-237






   XmCreatePopupMenu(3X)



   NAME
     XXmmCCrreeaatteePPooppuuppMMeennuu-A RowColumn widget convenience creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXmmCCrreeaatteePPooppuuppMMeennuu ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteePPooppuuppMMeennuu creates an instance of a RowColumn widget of type
     XXmmMMEENNUU__PPOOPPUUPP and returns the associated widget ID.  When using this
     function to create the Popup MenuPane, a MenuShell widget is automati-
     cally created as the parent of the MenuPane.  The parent of the Menu-
     Shell widget is the widget indicated by the _p_a_r_e_n_t parameter.

     XXmmCCrreeaatteePPooppuuppMMeennuu is provided as a convenience function for creating
     RowColumn widgets configured to operate as Popup MenuPanes and is not
     implemented as a separate widget class.

     The PopupMenu is used as the first MenuPane within a PopupMenu system;
     all other MenuPanes are of the Pulldown type.  A Popup MenuPane displays
     a 3-D shadow, unless the feature is disabled by the application.  The
     shadow appears around the edge of the MenuPane.

     The Popup MenuPane must be created as the child of a MenuShell widget in
     order to function properly when it is incorporated into a menu.  If the
     application uses this convenience function for creating a Popup Menu-
     Pane, the MenuShell is automatically created as the real parent of the
     MenuPane.  If the application does not use this convenience function to
     create the RowColumn to function as a Popup MenuPane, it is the
     application's responsibility to create the MenuShell widget.

     To access the PopupMenu, the application must first position the widget
     using the XXmmMMeennuuPPoossiittiioonn function and then manage it using
     XXttMMaannaaggeeCChhiilldd.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     Popup MenuPanes support tear-off capabilities for tear-off menus through
     XXmmRRoowwCCoolluummnn resources.  For a complete definition of RowColumn and its
     associated resources, see XXmmRRoowwCCoolluummnn((33XX)).



   1-238






                                                        XmCreatePopupMenu(3X)


   RETURN VALUE
     Returns the RowColumn widget ID.

   RELATED INFORMATION
     XXmmCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu((33XX)), XXmmMMeennuuPPoossiittiioonn((33XX)), XXmmMMeennuuSShheellll((33XX)),
     XXmmRRoowwCCoolluummnn((33XX)), and XXmmVVaaCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu((33XX)).


















































   1-239






   XmCreatePromptDialog(3X)



   NAME
     XXmmCCrreeaatteePPrroommppttDDiiaalloogg-The SelectionBox PromptDialog convenience creation
     function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//SSeelleeccttiiooBB..hh>>
     WWiiddggeett XXmmCCrreeaatteePPrroommppttDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteePPrroommppttDDiiaalloogg is a convenience creation function that creates a
     DialogShell and an unmanaged SelectionBox child of the DialogShell.  A
     PromptDialog prompts the user for text input.  It includes a message, a
     text input region, and three managed buttons.  The default button labels
     are OOKK, CCaanncceell, and HHeellpp.  An additional button, with AAppppllyy as the
     default label, is created unmanaged; it may be explicitly managed if
     needed.  One additional WWoorrkkAArreeaa child may be added to the SelectionBox
     after creation.

     XXmmCCrreeaatteePPrroommppttDDiiaalloogg forces the value of the SelectionBox resource
     XXmmNNddiiaallooggTTyyppee to XXmmDDIIAALLOOGG__PPRROOMMPPTT.

     Use XXttMMaannaaggeeCChhiilldd to pop up the PromptDialog (passing the SelectionBox
     as the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to pop it down.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of SelectionBox and its associated resources,
     see XXmmSSeelleeccttiioonnBBooxx((33XX)).

   RETURN VALUE
     Returns the SelectionBox widget ID.

   RELATED INFORMATION
     XXmmSSeelleeccttiioonnBBooxx((33XX)).









   1-240






                                                     XmCreatePulldownMenu(3X)



   NAME
     XXmmCCrreeaatteePPuullllddoowwnnMMeennuu-A RowColumn widget convenience creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXmmCCrreeaatteePPuullllddoowwnnMMeennuu ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteePPuullllddoowwnnMMeennuu creates an instance of a RowColumn widget of type
     XXmmMMEENNUU__PPUULLLLDDOOWWNN and returns the associated widget ID.  When using this
     function to create the Pulldown MenuPane, a MenuShell widget is automat-
     ically created as the parent of the MenuPane. If the widget specified by
     the _p_a_r_e_n_t parameter is a Popup or a Pulldown MenuPane, the MenuShell
     widget is created as a child of the _p_a_r_e_n_t's MenuShell; otherwise, it is
     created as a child of the specified _p_a_r_e_n_t widget.

     XXmmCCrreeaatteePPuullllddoowwnnMMeennuu is provided as a convenience function for creating
     RowColumn widgets configured to operate as Pulldown MenuPanes and is not
     implemented as a separate widget class.

     A Pulldown MenuPane displays a 3-D shadow, unless the feature is dis-
     abled by the application.  The shadow appears around the edge of the
     MenuPane.

     A Pulldown MenuPane is used when creating submenus that are to be
     attached to a CascadeButton or a CascadeButtonGadget.  This is the case
     for all MenuPanes that are part of a PulldownMenu system (a MenuBar),
     the MenuPane associated with an OptionMenu, and any MenuPanes that cas-
     cade from a Popup MenuPane.  Pulldown MenuPanes that are to be associ-
     ated with an OptionMenu must be created before the OptionMenu is
     created.

     The Pulldown MenuPane must be attached to a CascadeButton or CascadeBut-
     tonGadget that resides in a MenuBar, a Popup MenuPane, a Pulldown Menu-
     Pane, or an OptionMenu.  This is done by using the button resource
     XXmmNNssuubbMMeennuuIIdd.

     A MenuShell widget is required between the Pulldown MenuPane and its
     parent.  If the application uses this convenience function for creating
     a Pulldown MenuPane, the MenuShell is automatically created as the real
     parent of the MenuPane; otherwise, it is the application's responsibil-
     ity to create the MenuShell widget.

     To function correctly when incorporated into a menu, the Pulldown
     MenuPane's hierarchy must be considered; this hierarchy depends on the
     type of menu system that is being built as follows:

       ++oo  If the Pulldown MenuPane is to be pulled down from a MenuBar, its
          _p_a_r_e_n_t must be the MenuBar.


   1-241






   XmCreatePulldownMenu(3X)



       ++oo  If the Pulldown MenuPane is to be pulled down from a Popup or
          another Pulldown MenuPane, its _p_a_r_e_n_t must be that Popup or Pull-
          down MenuPane.

       ++oo  If the Pulldown MenuPane is to be pulled down from an OptionMenu,
          its _p_a_r_e_n_t must be the same as the OptionMenu parent.

       ++oo  Specifies the parent widget ID

       ++oo  Specifies the name of the created widget

       ++oo  Specifies the argument list

       ++oo  Specifies the number of attribute/value pairs in the argument list
          (_a_r_g_l_i_s_t)

     PullDown MenuPanes support tear-off capabilities for tear-off menus
     through XXmmRRoowwCCoolluummnn resources.  For a complete definition of RowColumn
     and its associated resources, see XXmmRRoowwCCoolluummnn((33XX)).

   RETURN VALUE
     Returns the RowColumn widget ID.

   RELATED INFORMATION
     XXmmCCaassccaaddeeBBuuttttoonn((33XX)), XXmmCCaassccaaddeeBBuuttttoonnGGaaddggeett((33XX)), XXmmCCrreeaatteeOOppttiioonnMMeennuu((33XX)),
     XXmmCCrreeaatteePPooppuuppMMeennuu((33XX)), XXmmCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuu((33XX)), XXmmMMeennuuSShheellll((33XX)),
     XXmmRRoowwCCoolluummnn((33XX)), and XXmmVVaaCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuu((33XX)).




























   1-242






                                                       XmCreatePushButton(3X)



   NAME
     XXmmCCrreeaatteePPuusshhBBuuttttoonn-The PushButton widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//PPuusshhBB..hh>>
     WWiiddggeett XXmmCCrreeaatteePPuusshhBBuuttttoonn ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteePPuusshhBBuuttttoonn creates an instance of a PushButton widget and
     returns the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of PushButton and its associated resources,
     see XXmmPPuusshhBBuuttttoonn((33XX)).

   RETURN VALUE
     Returns the PushButton widget ID.

   RELATED INFORMATION
     XXmmPPuusshhBBuuttttoonn((33XX)).






















   1-243






   XmCreatePushButtonGadget(3X)



   NAME
     XXmmCCrreeaatteePPuusshhBBuuttttoonnGGaaddggeett-The PushButtonGadget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//PPuusshhBBGG..hh>>
     WWiiddggeett XXmmCCrreeaatteePPuusshhBBuuttttoonnGGaaddggeett ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteePPuusshhBBuuttttoonnGGaaddggeett creates an instance of a PushButtonGadget
     widget and returns the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of PushButtonGadget and its associated
     resources, see XXmmPPuusshhBBuuttttoonnGGaaddggeett((33XX)).

   RETURN VALUE
     Returns the PushButtonGadget widget ID.

   RELATED INFORMATION
     XXmmPPuusshhBBuuttttoonnGGaaddggeett((33XX)).






















   1-244






                                                   XmCreateQuestionDialog(3X)



   NAME
     XXmmCCrreeaatteeQQuueessttiioonnDDiiaalloogg-The MessageBox QuestionDialog convenience crea-
     tion function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>
     WWiiddggeett XXmmCCrreeaatteeQQuueessttiioonnDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeQQuueessttiioonnDDiiaalloogg is a convenience creation function that creates a
     DialogShell and an unmanaged MessageBox child of the DialogShell.  A
     QuestionDialog is used to get the answer to a question from the user.
     It includes a symbol, a message, and three buttons.   The default symbol
     is a question mark.  The default button labels are OOKK, CCaanncceell, and HHeellpp.

     Use XXttMMaannaaggeeCChhiilldd to pop up the QuestionDialog (passing the MessageBox
     as the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to pop it down.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of MessageBox and its associated resources,
     see XXmmMMeessssaaggeeBBooxx((33XX)).

   RETURN VALUE
     Returns the MessageBox widget ID.

   RELATED INFORMATION
     XXmmMMeessssaaggeeBBooxx((33XX)).















   1-245






   XmCreateRadioBox(3X)



   NAME
     XXmmCCrreeaatteeRRaaddiiooBBooxx-A RowColumn widget convenience creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXmmCCrreeaatteeRRaaddiiooBBooxx ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeRRaaddiiooBBooxx creates an instance of a RowColumn widget of type
     XXmmWWOORRKK__AARREEAA and returns the associated widget ID.  Typically, this is a
     composite widget that contains multiple ToggleButtonGadgets.  The
     RadioBox arbitrates and ensures that at most one ToggleButtonGadget is
     on at any time.

     Unless the application supplies other values in the _a_r_g_l_i_s_t, this func-
     tion provides initial values for several RowColumn resources.  It ini-
     tializes XXmmNNppaacckkiinngg to XXmmPPAACCKK__CCOOLLUUMMNN, XXmmNNrraaddiiooBBeehhaavviioorr to True, XXmmNNiissHHoo--
     mmooggeenneeoouuss to True, and XXmmNNeennttrryyCCllaassss to xxmmTToogggglleeBBuuttttoonnGGaaddggeettCCllaassss.

     In a RadioBox the ToggleButton or ToggleButtonGadget resource XXmmNNiinnddiiccaa--
     ttoorrTTyyppee defaults to XXmmOONNEE__OOFF__MMAANNYY, and the ToggleButton or ToggleBut-
     tonGadget resourceXXmmNNvviissiibblleeWWhheennOOffff defaults to True.

     This routine is provided as a convenience function for creating
     RowColumn widgets.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of RowColumn and its associated resources, see
     XXmmRRoowwCCoolluummnn((33XX)).

   RETURN VALUE
     Returns the RowColumn widget ID.

   RELATED INFORMATION
     XXmmCCrreeaatteeRRoowwCCoolluummnn((33XX)), XXmmCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX)),
     XXmmCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)), XXmmCCrreeaatteeWWoorrkkAArreeaa((33XX)), XXmmRRoowwCCoolluummnn((33XX)),
     XXmmVVaaCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX)), and XXmmVVaaCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)).





   1-246






                                                        XmCreateRowColumn(3X)



   NAME
     XXmmCCrreeaatteeRRoowwCCoolluummnn-The RowColumn widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXmmCCrreeaatteeRRoowwCCoolluummnn ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeRRoowwCCoolluummnn creates an instance of a RowColumn widget and returns
     the associated widget ID.  If XXmmNNrroowwCCoolluummnnTTyyppee is not specified, then it
     is created with XXmmWWOORRKK__AARREEAA, which is the default.

     If this function is used to create a Popup Menu of type XXmmMMEENNUU__PPOOPPUUPP or
     a Pulldown Menu of type XXmmMMEENNUU__PPUULLLLDDOOWWNN, a MenuShell widget is not
     automatically created as the parent of the MenuPane.  The application
     must first create the MenuShell by using either XXmmCCrreeaatteeMMeennuuSShheellll or the
     standard toolkit create function.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of RowColumn and its associated resources, see
     XXmmRRoowwCCoolluummnn((33XX)).

   RETURN VALUE
     Returns the RowColumn widget ID.

   RELATED INFORMATION
     XXmmCCrreeaatteeMMeennuuBBaarr((33XX)), XXmmCCrreeaatteeMMeennuuSShheellll((33XX)), XXmmCCrreeaatteeOOppttiioonnMMeennuu((33XX)),
     XXmmCCrreeaatteePPooppuuppMMeennuu((33XX)), XXmmCCrreeaatteePPuullllddoowwnnMMeennuu((33XX)), XXmmCCrreeaatteeRRaaddiiooBBooxx((33XX)),
     XXmmCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX)), XXmmCCrreeaatteeSSiimmpplleeMMeennuuBBaarr((33XX)),
     XXmmCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu((33XX)), XXmmCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu((33XX)),
     XXmmCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuu((33XX)), XXmmCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)),
     XXmmCCrreeaatteeWWoorrkkAArreeaa((33XX)), XXmmRRoowwCCoolluummnn((33XX)), XXmmVVaaCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX)),
     XXmmVVaaCCrreeaatteeSSiimmpplleeMMeennuuBBaarr((33XX)), XXmmVVaaCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu((33XX)),
     XXmmVVaaCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu((33XX)), XXmmVVaaCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuu((33XX)), and
     XXmmVVaaCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)).







   1-247






   XmCreateScale(3X)



   NAME
     XXmmCCrreeaatteeSSccaallee-The Scale widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//SSccaallee..hh>>
     WWiiddggeett XXmmCCrreeaatteeSSccaallee ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeSSccaallee creates an instance of a Scale widget and returns the
     associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of Scale and its associated resources, see
     XXmmSSccaallee((33XX)).

   RETURN VALUE
     Returns the Scale widget ID.

   RELATED INFORMATION
     XXmmSSccaallee((33XX)).






















   1-248






                                                        XmCreateScrollBar(3X)



   NAME
     XXmmCCrreeaatteeSSccrroollllBBaarr-The ScrollBar widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//SSccrroollllBBaarr..hh>>
     WWiiddggeett XXmmCCrreeaatteeSSccrroollllBBaarr ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeSSccrroollllBBaarr creates an instance of a ScrollBar widget and returns
     the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of ScrollBar and its associated resources, see
     XXmmSSccrroollllBBaarr((33XX)).

   RETURN VALUE
     Returns the ScrollBar widget ID.

   RELATED INFORMATION
     XXmmSSccrroollllBBaarr((33XX)).






















   1-249






   XmCreateScrolledList(3X)



   NAME
     XXmmCCrreeaatteeSSccrroolllleeddLLiisstt-The List ScrolledList convenience creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//LLiisstt..hh>>
     WWiiddggeett XXmmCCrreeaatteeSSccrroolllleeddLLiisstt ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeSSccrroolllleeddLLiisstt creates an instance of a List widget that is con-
     tained within a ScrolledWindow.  All ScrolledWindow subarea widgets are
     automatically created by this function. The ID returned by this function
     is that of the List widget.  Use this ID for all normal List operations,
     as well as those that are relevant for the ScrolledList widget.

     All arguments to either the List or the ScrolledWindow widget can be
     specified at creation time using this function.  Changes to initial
     position and size are sent only to the ScrolledWindow widget.  Other
     resources are sent to the List or the ScrolledWindow widget as appropri-
     ate.

     This function forces the following initial values for ScrolledWindow
     resources:

       ++oo  XXmmNNssccrroolllliinnggPPoolliiccyy is set to XXmmAAPPPPLLIICCAATTIIOONN__DDEEFFIINNEEDD.

       ++oo  XXmmNNvviissuuaallPPoolliiccyy is set to XXmmVVAARRIIAABBLLEE.

       ++oo  XXmmNNssccrroollllBBaarrDDiissppllaayyPPoolliiccyy is set to XXmmSSTTAATTIICC.  (No initial value is
          forced for the List's XXmmNNssccrroollllBBaarrDDiissppllaayyPPoolliiccyy.)

       ++oo  XXmmNNsshhaaddoowwTThhiicckknneessss is set to 0.

     To obtain the ID of the ScrolledWindow widget associated with the Scrol-
     ledList, use the Xt Intrinsics XXttPPaarreenntt function.  The name of the
     ScrolledWindow created by this function is formed by concatenating the
     letters SSWW onto the end of the _n_a_m_e specified in the parameter list.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of List and its associated resources, see
     XXmmLLiisstt((33XX)).


   1-250






                                                     XmCreateScrolledList(3X)



   RETURN VALUE
     Returns the List widget ID.

   RELATED INFORMATION
     XXmmLLiisstt((33XX)) and XXmmSSccrroolllleeddWWiinnddooww((33XX)).


















































   1-251






   XmCreateScrolledText(3X)



   NAME
     XXmmCCrreeaatteeSSccrroolllleeddTTeexxtt-The TextScrolledText convenience creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//TTeexxtt..hh>>
     WWiiddggeett XXmmCCrreeaatteeSSccrroolllleeddTTeexxtt ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeSSccrroolllleeddTTeexxtt creates an instance of a Text widget that is con-
     tained within a ScrolledWindow.  All ScrolledWindow subarea widgets are
     automatically created by this function. The ID returned by this function
     is that of the Text widget.  Use this ID for all normal Text operations,
     as well as those that are relevant for the ScrolledText widget.

     The Text widget defaults to single-line text edit; therefore, no
     ScrollBars are displayed.  The Text resource XXmmNNeeddiittMMooddee must be set to
     XXmmMMUULLTTII__LLIINNEE__EEDDIITT to display the ScrollBars.  The results of placing a
     Text widget inside a ScrolledWindow when the Text's XXmmNNeeddiittMMooddee is
     XXmmSSIINNGGLLEE__LLIINNEE__EEDDIITT are undefined.

     All arguments to either the Text or the ScrolledWindow widget can be
     specified at creation time using this function.  Changes to initial
     position and size are sent only to the ScrolledWindow widget.  Other
     resources are sent to the Text or the ScrolledWindow widget as appropri-
     ate.

     This function forces the following initial values for ScrolledWindow
     resources:

       ++oo  XXmmNNssccrroolllliinnggPPoolliiccyy is set to XXmmAAPPPPLLIICCAATTIIOONN__DDEEFFIINNEEDD.

       ++oo  XXmmNNvviissuuaallPPoolliiccyy is set to XXmmVVAARRIIAABBLLEE.

       ++oo  XXmmNNssccrroollllBBaarrDDiissppllaayyPPoolliiccyy is set to XXmmSSTTAATTIICC.

       ++oo  XXmmNNsshhaaddoowwTThhiicckknneessss is set to 0.

     To obtain the ID of the ScrolledWindow widget associated with the Scrol-
     ledText, use the Xt Intrinsics XXttPPaarreenntt function.  The name of the
     ScrolledWindow created by this function is formed by concatenating the
     letters SSWW onto the end of the _n_a_m_e specified in the parameter list.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t


   1-252






                                                     XmCreateScrolledText(3X)


            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of Text and its associated resources, see
     XXmmTTeexxtt((33XX)).

   RETURN VALUE
     Returns the Text widget ID.

   RELATED INFORMATION
     XXmmSSccrroolllleeddWWiinnddooww((33XX)) and XXmmTTeexxtt((33XX)).













































   1-253






   XmCreateScrolledWindow(3X)



   NAME
     XXmmCCrreeaatteeSSccrroolllleeddWWiinnddooww-The ScrolledWindow widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//SSccrroolllleeddWW..hh>>
     WWiiddggeett XXmmCCrreeaatteeSSccrroolllleeddWWiinnddooww ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeSSccrroolllleeddWWiinnddooww creates an instance of a ScrolledWindow widget
     and returns the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of ScrolledWindow and its associated
     resources, see XXmmSSccrroolllleeddWWiinnddooww((33XX)).

   RETURN VALUE
     Returns the ScrolledWindow widget ID.

   RELATED INFORMATION
     XXmmSSccrroolllleeddWWiinnddooww((33XX)).






















   1-254






                                                     XmCreateSelectionBox(3X)



   NAME
     XXmmCCrreeaatteeSSeelleeccttiioonnBBooxx-The SelectionBox widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//SSeelleeccttiiooBB..hh>>
     WWiiddggeett XXmmCCrreeaatteeSSeelleeccttiioonnBBooxx ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeSSeelleeccttiioonnBBooxx creates an unmanaged SelectionBox.  A SelectionBox
     is used to get a selection from a list of alternatives from the user and
     includes the following:

       ++oo  A scrolling list of alternatives

       ++oo  An editable text field for the selected alternative

       ++oo  Labels for the list and text field

       ++oo  Three or four buttons

     The default button labels are OOKK, CCaanncceell, and HHeellpp.  By default an AAppppllyy
     button is also created; if the parent of the SelectionBox is a Dialog-
     Shell it is managed, and otherwise it is unmanaged.  Additional work
     area children may be added to the SelectionBox after creation.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of SelectionBox and its associated resources,
     see XXmmSSeelleeccttiioonnBBooxx((33XX)).

   RETURN VALUE
     Returns the SelectionBox widget ID.

   RELATED INFORMATION
     XXmmSSeelleeccttiioonnBBooxx((33XX)).








   1-255






   XmCreateSelectionDialog(3X)



   NAME
     XXmmCCrreeaatteeSSeelleeccttiioonnDDiiaalloogg-The SelectionBox SelectionDialog convenience
     creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//SSeelleeccttiiooBB..hh>>
     WWiiddggeett XXmmCCrreeaatteeSSeelleeccttiioonnDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeSSeelleeccttiioonnDDiiaalloogg is a convenience creation function that creates
     a DialogShell and an unmanaged SelectionBox child of the DialogShell.  A
     SelectionDialog offers the user a choice from a list of alternatives and
     gets a selection.  It includes the following:

       ++oo  A scrolling list of alternatives

       ++oo  An editable text field for the selected alternative

       ++oo  Labels for the text field

       ++oo  Four buttons

     The default button labels are OOKK, CCaanncceell, AAppppllyy, and HHeellpp.  One addi-
     tional WWoorrkkAArreeaa child may be added to the SelectionBox after creation.

     XXmmCCrreeaatteeSSeelleeccttiioonnDDiiaalloogg forces the value of the SelectionBox resource
     XXmmNNddiiaallooggTTyyppee to XXmmDDIIAALLOOGG__SSEELLEECCTTIIOONN.

     Use XXttMMaannaaggeeCChhiilldd to pop up the SelectionDialog (passing the Selection-
     Box as the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to pop it down.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of SelectionBox and its associated resources,
     see XXmmSSeelleeccttiioonnBBooxx((33XX)).

   RETURN VALUE
     Returns the SelectionBox widget ID.





   1-256






                                                  XmCreateSelectionDialog(3X)


   RELATED INFORMATION
     XXmmSSeelleeccttiioonnBBooxx((33XX)).






















































   1-257






   XmCreateSeparator(3X)



   NAME
     XXmmCCrreeaatteeSSeeppaarraattoorr-The Separator widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//SSeeppaarraattoorr..hh>>
     WWiiddggeett XXmmCCrreeaatteeSSeeppaarraattoorr ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeSSeeppaarraattoorr creates an instance of a Separator widget and returns
     the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of Separator and its associated resources, see
     XXmmSSeeppaarraattoorr((33XX)).

   RETURN VALUE
     Returns the Separator widget ID.

   RELATED INFORMATION
     XXmmSSeeppaarraattoorr((33XX)).






















   1-258






                                                  XmCreateSeparatorGadget(3X)



   NAME
     XXmmCCrreeaatteeSSeeppaarraattoorrGGaaddggeett-The SeparatorGadget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//SSeeppaarraattooGG..hh>>
     WWiiddggeett XXmmCCrreeaatteeSSeeppaarraattoorrGGaaddggeett ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeSSeeppaarraattoorrGGaaddggeett creates an instance of a SeparatorGadget widget
     and returns the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of SeparatorGadget and its associated
     resources, see XXmmSSeeppaarraattoorrGGaaddggeett((33XX)).

   RETURN VALUE
     Returns the SeparatorGadget widget ID.

   RELATED INFORMATION
     XXmmSSeeppaarraattoorrGGaaddggeett((33XX)).






















   1-259






   XmCreateSimpleCheckBox(3X)



   NAME
     XXmmCCrreeaatteeSSiimmpplleeCChheecckkBBooxx-A RowColumn widget convenience creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXmmCCrreeaatteeSSiimmpplleeCChheecckkBBooxx ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeSSiimmpplleeCChheecckkBBooxx creates an instance of a RowColumn widget of type
     XXmmWWOORRKK__AARREEAA and returns the associated widget ID.

     This routine creates a CheckBox and its ToggleButtonGadget children.  A
     CheckBox is similar to a RadioBox, except that more than one button can
     be selected at a time.  The name of each button is button__n, where _n is
     an integer from 0 to one minus the number of buttons in the menu.  But-
     tons are named and created in the order in which they are specified in
     the RowColumn simple menu creation resources supplied in the argument
     list.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     A number of resources exist specifically for use with this and other
     simple menu creation routines.  The only button type allowed in the
     XXmmNNbbuuttttoonnTTyyppee resource is XXmmCCHHEECCKKBBUUTTTTOONN.  For a complete definition of
     RowColumn and its associated resources, see XXmmRRoowwCCoolluummnn((33XX)).

   RETURN VALUE
     Returns the RowColumn widget ID.

   RELATED INFORMATION
     XXmmCCrreeaatteeRRaaddiiooBBooxx((33XX)), XXmmCCrreeaatteeRRoowwCCoolluummnn((33XX)), XXmmCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)),
     XXmmRRoowwCCoolluummnn((33XX)), XXmmVVaaCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX)), and
     XXmmVVaaCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)).










   1-260






                                                    XmCreateSimpleMenuBar(3X)



   NAME
     XXmmCCrreeaatteeSSiimmpplleeMMeennuuBBaarr-A RowColumn widget convenience creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXmmCCrreeaatteeSSiimmpplleeMMeennuuBBaarr ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeSSiimmpplleeMMeennuuBBaarr creates an instance of a RowColumn widget of type
     XXmmMMEENNUU__BBAARR and returns the associated widget ID.

     This routine creates a MenuBar and its CascadeButtonGadget children.
     The name of each button is button__n, where _n is an integer from 0 to one
     minus the number of buttons in the menu.  Buttons are named and created
     in the order in which they are specified in the RowColumn simple menu
     creation resources supplied in the argument list.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     A number of resources exist specifically for use with this and other
     simple menu creation routines.  The only button type allowed in the
     XXmmNNbbuuttttoonnTTyyppee resource is XXmmCCAASSCCAADDEEBBUUTTTTOONN.  For a complete definition of
     RowColumn and its associated resources, see XXmmRRoowwCCoolluummnn((33XX)).

   RETURN VALUE
     Returns the RowColumn widget ID.

   RELATED INFORMATION
     XXmmCCrreeaatteeMMeennuuBBaarr((33XX)), XXmmCCrreeaatteeRRoowwCCoolluummnn((33XX)), XXmmRRoowwCCoolluummnn((33XX)), and
     XXmmVVaaCCrreeaatteeSSiimmpplleeMMeennuuBBaarr((33XX)).













   1-261






   XmCreateSimpleOptionMenu(3X)



   NAME
     XXmmCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu-A RowColumn widget convenience creation func-
     tion

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXmmCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu creates an instance of a RowColumn widget of
     type XXmmMMEENNUU__OOPPTTIIOONN and returns the associated widget ID.

     This routine creates an Option Menu and its submenu containing PushBut-
     tonGadget or CascadeButtonGadget children.  The name of each button is
     button__n, where _n is an integer from 0 to one minus the number of but-
     tons in the menu.  The name of each separator is separator__n, where _n is
     an integer from 0 to one minus the number of separators in the menu.
     Buttons and separators are named and created in the order in which they
     are specified in the RowColumn simple menu creation resources supplied
     in the argument list.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     The user can specify resources in a resource file for the automatically
     created widgets and gadgets of an OptionMenu.  The following list iden-
     tifies the names of these widgets (or gadgets) and the associated
     OptionMenu areas.

       ++oo

       ++oo  Option Menu Label Gadget-"OptionLabel"

       ++oo  Option Menu Cascade Button-"OptionButton"

     A number of resources exist specifically for use with this and other
     simple menu creation routines.  The only button types allowed in the
     XXmmNNbbuuttttoonnTTyyppee resource are XXmmPPUUSSHHBBUUTTTTOONN, XXmmCCAASSCCAADDEEBBUUTTTTOONN, XXmmSSEEPPAARRAATTOORR,
     and XXmmDDOOUUBBLLEE__SSEEPPAARRAATTOORR.  For a complete definition of RowColumn and its
     associated resources, see XXmmRRoowwCCoolluummnn((33XX)).




   1-262






                                                 XmCreateSimpleOptionMenu(3X)


   RETURN VALUE
     Returns the RowColumn widget ID.

   RELATED INFORMATION
     XXmmCCrreeaatteeOOppttiioonnMMeennuu((33XX)), XXmmCCrreeaatteeRRoowwCCoolluummnn((33XX)), XXmmRRoowwCCoolluummnn((33XX)), and
     XXmmVVaaCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu((33XX)).


















































   1-263






   XmCreateSimplePopupMenu(3X)



   NAME
     XXmmCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu-A RowColumn widget convenience creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXmmCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu creates an instance of a RowColumn widget of
     type XXmmMMEENNUU__PPOOPPUUPP and returns the associated widget ID.

     This routine creates a Popup MenuPane and its button children.  The name
     of each button is button__n, where _n is an integer from 0 to one minus
     the number of buttons in the menu.  The name of each separator is
     separator__n, where _n is an integer from 0 to one minus the number of
     separators in the menu.  The name of each title is label__n, where _n is
     an integer from 0 to one minus the number of titles in the menu.  But-
     tons, separators, and titles are named and created in the order in which
     they are specified in the RowColumn simple menu creation resources sup-
     plied in the argument list.

     _p_a_r_e_n_t Specifies the widget ID of the parent of the MenuShell

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     A number of resources exist specifically for use with this and other
     simple menu creation routines.  The only button types allowed in the
     XXmmNNbbuuttttoonnTTyyppee resource are XXmmCCAASSCCAADDEEBBUUTTTTOONN, XXmmPPUUSSHHBBUUTTTTOONN, XXmmRRAADDIIOOBBUUTTTTOONN,
     XXmmCCHHEECCKKBBUUTTTTOONN, XXmmTTIITTLLEE, XXmmSSEEPPAARRAATTOORR, and XXmmDDOOUUBBLLEE__SSEEPPAARRAATTOORR.  For a com-
     plete definition of RowColumn and its associated resources, see
     XXmmRRoowwCCoolluummnn((33XX)).

   RETURN VALUE
     Returns the RowColumn widget ID.

   RELATED INFORMATION
     XXmmCCrreeaatteePPooppuuppMMeennuu((33XX)), XXmmCCrreeaatteeRRoowwCCoolluummnn((33XX)), XXmmRRoowwCCoolluummnn((33XX)), and
     XXmmVVaaCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu((33XX)).







   1-264






                                               XmCreateSimplePulldownMenu(3X)



   NAME
     XXmmCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuu-A RowColumn widget convenience creation func-
     tion

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXmmCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuu ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuu creates an instance of a RowColumn widget of
     type XXmmMMEENNUU__PPUULLLLDDOOWWNN and returns the associated widget ID.

     This routine creates a Pulldown MenuPane and its button children.  The
     name of each button is button__n, where _n is an integer from 0 to one
     minus the number of buttons in the menu.  The name of each separator is
     separator__n, where _n is an integer from 0 to one minus the number of
     separators in the menu.  The name of each title is label__n, where _n is
     an integer from 0 to one minus the number of titles in the menu.  But-
     tons, separators, and titles are named and created in the order in which
     they are specified in the RowColumn simple menu creation resources sup-
     plied in the argument list.

     _p_a_r_e_n_t Specifies the widget ID of the parent of the MenuShell

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     A number of resources exist specifically for use with this and other
     simple menu creation routines.  The only button types allowed in the
     XXmmNNbbuuttttoonnTTyyppee resource are XXmmCCAASSCCAADDEEBBUUTTTTOONN, XXmmPPUUSSHHBBUUTTTTOONN, XXmmRRAADDIIOOBBUUTTTTOONN,
     XXmmCCHHEECCKKBBUUTTTTOONN, XXmmTTIITTLLEE, XXmmSSEEPPAARRAATTOORR, and XXmmDDOOUUBBLLEE__SSEEPPAARRAATTOORR.  For a com-
     plete definition of RowColumn and its associated resources, see
     XXmmRRoowwCCoolluummnn((33XX)).

   RETURN VALUE
     Returns the RowColumn widget ID.

   RELATED INFORMATION
     XXmmCCrreeaatteePPuullllddoowwnnMMeennuu((33XX)), XXmmCCrreeaatteeRRoowwCCoolluummnn((33XX)), XXmmRRoowwCCoolluummnn((33XX)), and
     XXmmVVaaCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuu((33XX)).






   1-265






   XmCreateSimpleRadioBox(3X)



   NAME
     XXmmCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx-A RowColumn widget convenience creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXmmCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx creates an instance of a RowColumn widget of type
     XXmmWWOORRKK__AARREEAA and returns the associated widget ID.

     This routine creates a Radio Box and its ToggleButtonGadget children.
     The name of each button is button__n, where _n is an integer from 0 to one
     minus the number of buttons in the menu.  Buttons are named and created
     in the order in which they are specified in the RowColumn simple menu
     creation resources supplied in the argument list.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     A number of resources exist specifically for use with this and other
     simple menu creation routines.  The only button type allowed in the
     XXmmNNbbuuttttoonnTTyyppee resource is XXmmRRAADDIIOOBBUUTTTTOONN.  For a complete definition of
     RowColumn and its associated resources, see XXmmRRoowwCCoolluummnn((33XX)).

   RETURN VALUE
     Returns the RowColumn widget ID.

   RELATED INFORMATION
     XXmmCCrreeaatteeRRaaddiiooBBooxx((33XX)), XXmmCCrreeaatteeRRoowwCCoolluummnn((33XX)), XXmmCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX)),
     XXmmRRoowwCCoolluummnn((33XX)), and XXmmVVaaCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)).













   1-266






                                                   XmCreateTemplateDialog(3X)



   NAME
     XXmmCCrreeaatteeTTeemmppllaatteeDDiiaalloogg-A MessageBox TemplateDialog convenience creation
     function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>
     WWiiddggeett XXmmCCrreeaatteeTTeemmppllaatteeDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeTTeemmppllaatteeDDiiaalloogg is a convenience creation function that creates a
     DialogShell and an unmanaged MessageBox child of the DialogShell. The
     MessageBox widget's XXmmNNddiiaallooggTTyyppee resource is set to XXmmDDIIAALLOOGG__TTEEMMPPLLAATTEE.
     By default, the TemplateDialog widget contains only the separator child.
     You can build a customized dialog by adding children to the TemplateDia-
     log.

     You can create the standard MessageBox pushbuttons, CCaanncceell, HHeellpp, and
     OOKK, by specifying the associated callback and label string resources.
     Setting XXmmNNssyymmbboollPPiixxmmaapp or XXmmNNmmeessssaaggeeSSttrriinngg creates a symbol or message
     label.

     Use XXttMMaannaaggeeCChhiilldd to pop up the TemplateDialog (passing the MessageBox
     as the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to pop it down.

     _p_a_r_e_n_t      Specifies the parent widget ID

     _n_a_m_e        Specifies the name of the created widget

     _a_r_g_l_i_s_t     Specifies the argument list

     _a_r_g_c_o_u_n_t    Specifies the number of attribute/value pairs in the argu-
                 ment list (_a_r_g_l_i_s_t)

     For a complete definition of MessageBox and its associated resources,
     see XXmmMMeessssaaggeeBBooxx((33XX)).

   RETURN VALUE
     Returns the MessageBox widget ID.

   RELATED INFORMATION
     XXmmMMeessssaaggeeBBooxx((33XX)).










   1-267






   XmCreateText(3X)



   NAME
     XXmmCCrreeaatteeTTeexxtt-The Text widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//TTeexxtt..hh>>
     WWiiddggeett XXmmCCrreeaatteeTTeexxtt ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeTTeexxtt creates an instance of a Text widget and returns the asso-
     ciated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of Text and its associated resources, see
     XXmmTTeexxtt((33XX)).

   RETURN VALUE
     Returns the Text widget ID.

   RELATED INFORMATION
     XXmmTTeexxtt((33XX)).






















   1-268






                                                        XmCreateTextField(3X)



   NAME
     XXmmCCrreeaatteeTTeexxttFFiieelldd-The TextField widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//TTeexxttFF..hh>>
     WWiiddggeett XXmmCCrreeaatteeTTeexxttFFiieelldd ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeTTeexxttFFiieelldd creates an instance of a TextField widget and returns
     the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of TextField and its associated resources, see
     XXmmTTeexxttFFiieelldd((33XX)).

   RETURN VALUE
     Returns the TextField widget ID.

   RELATED INFORMATION
     XXmmTTeexxttFFiieelldd((33XX)).






















   1-269






   XmCreateToggleButton(3X)



   NAME
     XXmmCCrreeaatteeTToogggglleeBBuuttttoonn-The ToggleButton widget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//TToogggglleeBB..hh>>
     WWiiddggeett XXmmCCrreeaatteeTToogggglleeBBuuttttoonn ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeTToogggglleeBBuuttttoonn creates an instance of a ToggleButton widget and
     returns the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of ToggleButton and its associated resources,
     see XXmmTToogggglleeBBuuttttoonn((33XX)).

   RETURN VALUE
     Returns the ToggleButton widget ID.

   RELATED INFORMATION
     XXmmTToogggglleeBBuuttttoonn((33XX)).






















   1-270






                                               XmCreateToggleButtonGadget(3X)



   NAME
     XXmmCCrreeaatteeTToogggglleeBBuuttttoonnGGaaddggeett-The ToggleButtonGadget creation function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//TToogggglleeBBGG..hh>>
     WWiiddggeett XXmmCCrreeaatteeTToogggglleeBBuuttttoonnGGaaddggeett ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeTToogggglleeBBuuttttoonnGGaaddggeett creates an instance of a ToggleButtonGadget
     and returns the associated widget ID.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of ToggleButtonGadget and its associated
     resources, see XXmmTToogggglleeBBuuttttoonnGGaaddggeett((33XX)).

   RETURN VALUE
     Returns the ToggleButtonGadget widget ID.

   RELATED INFORMATION
     XXmmTToogggglleeBBuuttttoonnGGaaddggeett((33XX)).






















   1-271






   XmCreateWarningDialog(3X)



   NAME
     XXmmCCrreeaatteeWWaarrnniinnggDDiiaalloogg-The MessageBox WarningDialog convenience creation
     function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>
     WWiiddggeett XXmmCCrreeaatteeWWaarrnniinnggDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeWWaarrnniinnggDDiiaalloogg is a convenience creation function that creates a
     DialogShell and an unmanaged MessageBox child of the DialogShell.  A
     WarningDialog warns users of action consequences and gives them a choice
     of resolutions.  It includes a symbol, a message, and three buttons.
     The default symbol is an exclamation point.  The default button labels
     are OOKK, CCaanncceell, and HHeellpp.

     Use XXttMMaannaaggeeCChhiilldd to pop up the WarningDialog (passing the MessageBox as
     the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to pop it down.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of MessageBox and its associated resources,
     see XXmmMMeessssaaggeeBBooxx((33XX)).

   RETURN VALUE
     Returns the MessageBox widget ID.

   RELATED INFORMATION
     XXmmMMeessssaaggeeBBooxx((33XX)).














   1-272






                                                         XmCreateWorkArea(3X)



   NAME
     XXmmCCrreeaatteeWWoorrkkAArreeaa-A function that creates a RowColumn work area

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXmmCCrreeaatteeWWoorrkkAArreeaa ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeWWoorrkkAArreeaa creates an instance of a RowColumn widget and returns
     the associated widget ID.  The widget is created with XXmmNNrroowwCCoolluummnnTTyyppee
     set to XXmmWWOORRKK__AARREEAA.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of RowColumn and its associated resources, see
     XXmmRRoowwCCoolluummnn((33XX)).

   RETURN VALUE
     Returns the RowColumn widget ID.

   RELATED INFORMATION
     XXmmCCrreeaatteeRRaaddiiooBBooxx((33XX)), XXmmCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX)),
     XXmmCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)), XXmmRRoowwCCoolluummnn((33XX)),
     XXmmVVaaCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX)), and XXmmVVaaCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)).



















   1-273






   XmCreateWorkingDialog(3X)



   NAME
     XXmmCCrreeaatteeWWoorrkkiinnggDDiiaalloogg-The MessageBox WorkingDialog convenience creation
     function

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>
     WWiiddggeett XXmmCCrreeaatteeWWoorrkkiinnggDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
          WWiiddggeett    _p_a_r_e_n_t;;
          SSttrriinngg    _n_a_m_e;;
          AArrggLLiisstt   _a_r_g_l_i_s_t;;
          CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

   DESCRIPTION
     XXmmCCrreeaatteeWWoorrkkiinnggDDiiaalloogg is a convenience creation function that creates a
     DialogShell and an unmanaged MessageBox child of the DialogShell.  A
     WorkingDialog informs users that there is a time-consuming operation in
     progress and allows them to cancel the operation.  It includes a symbol,
     a message, and three buttons.  The default symbol is an hourglass.  The
     default button labels are OOKK, CCaanncceell, and HHeellpp.

     Use XXttMMaannaaggeeCChhiilldd to pop up the WorkingDialog (passing the MessageBox as
     the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to pop it down.

     _p_a_r_e_n_t Specifies the parent widget ID

     _n_a_m_e   Specifies the name of the created widget

     _a_r_g_l_i_s_tSpecifies the argument list

     _a_r_g_c_o_u_n_t
            Specifies the number of attribute/value pairs in the argument
            list (_a_r_g_l_i_s_t)

     For a complete definition of MessageBox and its associated resources,
     see XXmmMMeessssaaggeeBBooxx((33XX)).

   RETURN VALUE
     Returns the MessageBox widget ID.

   RELATED INFORMATION
     XXmmMMeessssaaggeeBBooxx((33XX)).














   1-274






                                                        XmCvtCTToXmString(3X)



   NAME
     XXmmCCvvttCCTTTTooXXmmSSttrriinngg-A compound string function that converts compound text
     to a compound string

   SYNOPSIS
     ##iinncclluuddee <<XXmm//XXmm..hh>>
     XXmmSSttrriinngg XXmmCCvvttCCTTTTooXXmmSSttrriinngg ((_t_e_x_t))
          cchhaarr        * _t_e_x_t;;

   DESCRIPTION
     XXmmCCvvttCCTTTTooXXmmSSttrriinngg converts a (char *) string in compound text format to
     a compound string.  The application must call XXttAAppppIInniittiiaalliizzee before
     calling this function.  Conversion of compound text to compound strings
     is implementation dependent.

     _t_e_x_t   Specifies a string in compound text format to be converted to a
            compound string.

   RETURN VALUE
     Returns a compound string derived from the compound text.  The compound
     text is assumed to be NULL-terminated; NULLs within the compound text
     are handled correctly.  The handling of HORIZONTAL TABULATION (HT) con-
     trol characters within the compound text is undefined.  The compound
     text format is described in the X Consortium Standard _C_o_m_p_o_u_n_d _T_e_x_t
     _E_n_c_o_d_i_n_g.

   RELATED INFORMATION
     XXmmCCvvttXXmmSSttrriinnggTTooCCTT((33XX)).



























   1-275






   XmCvtStringToUnitType(3X)



   NAME
     XXmmCCvvttSSttrriinnggTTooUUnniittTTyyppee-A function that converts a string to a unit-type
     value

   SYNOPSIS
     ##iinncclluuddee <<XXmm//XXmm..hh>>
     vvooiidd XXmmCCvvttSSttrriinnggTTooUUnniittTTyyppee ((_a_r_g_s, _n_u_m__a_r_g_s, _f_r_o_m__v_a_l, _t_o__v_a_l))
          XXrrmmVVaalluueePPttrr_a_r_g_s;;
          CCaarrddiinnaall  * _n_u_m__a_r_g_s;;
          XXrrmmVVaalluuee  * _f_r_o_m__v_a_l;;
          XXrrmmVVaalluuee  * _t_o__v_a_l;;

   DESCRIPTION
     XXmmCCvvttSSttrriinnggTTooUUnniittTTyyppee converts a string to a unit type.  Refer to the
     man pages for XXmmGGaaddggeett, XXmmMMaannaaggeerr, or XXmmPPrriimmiittiivvee for a description of
     the valid unit types.  Use of this function as a resource converter is
     obsolete.  It has been replaced by a new resource converter that uses
     the RepType facility.

     _a_r_g_s   Specifies a list of additional XXrrmmVVaalluuee arguments to the con-
            verter if additional context is needed to perform the conversion.
            For example, the string-to-font converter needs the widget's
            screen and the string-to-pixel converter needs the widget's
            screen and color map.  This argument is often NULL.

     _n_u_m__a_r_g_s
            Specifies the number of additional XXrrmmVVaalluuee arguments.  This
            argument is often zero.

     _f_r_o_m__v_a_l
            Specifies the value to convert

     _t_o__v_a_l Specifies the descriptor to use to return the converted value

   RELATED INFORMATION
     XXmmGGaaddggeett((33XX)), XXmmMMaannaaggeerr((33XX)), and XXmmPPrriimmiittiivvee((33XX)).



















   1-276






                                                        XmCvtXmStringToCT(3X)



   NAME
     XXmmCCvvttXXmmSSttrriinnggTTooCCTT-A compound string function that converts a compound
     string to compound text

   SYNOPSIS
     ##iinncclluuddee <<XXmm//XXmm..hh>>
     cchhaarr ** XXmmCCvvttXXmmSSttrriinnggTTooCCTT ((_s_t_r_i_n_g))
          XXmmSSttrriinngg    _s_t_r_i_n_g;;

   DESCRIPTION
     XXmmCCvvttXXmmSSttrriinnggTTooCCTT converts a compound string to a (char *) string in
     compound text format.  The application must call XXttAAppppIInniittiiaalliizzee before
     calling this function.  The converter uses the font list tag associated
     with a given compound string segment to select a compound text format
     for that segment.  A registry defines a mapping between font list tags
     and compound text encoding formats.  The converter uses the following
     algorithm for each compound string segment:

      11..  If the compound string segment tag is mapped to
          XXmmFFOONNTTLLIISSTT__DDEEFFAAUULLTT__TTAAGG in the registry, the converter passes the
          text of the compound string segment to XXmmbbTTeexxttLLiissttTTooTTeexxttPPrrooppeerrttyy
          with an encoding style of XXCCoommppoouunnddTTeexxttSSttyyllee and uses the resulting
          compound text for that segment.

      22..  If the compound string segment tag is mapped to an MIT registered
          charset in the registry, the converter creates the compound text
          for that segment using the charset (from the registry) and the text
          of the compound string segment as defined in the X Consortium Stan-
          dard _C_o_m_p_o_u_n_d _T_e_x_t _E_n_c_o_d_i_n_g.

      33..  If the compound string segment tag is mapped to a charset in the
          registry that is neither XXmmFFOONNTTLLIISSTT__DDEEFFAAUULLTT__TTAAGG nor an MIT
          registered charset, the converter creates the compound text for
          that segment using the charset (from the registry) and the text of
          the compound string segment as an "extended segment" with a vari-
          able number of octets per character.

      44..  If the compound string segment tag is not mapped in the registry,
          the result is implementation dependent.

     _s_t_r_i_n_g Specifies a compound string to be converted to compound text.

   RETURN VALUE
     Returns a (char *) string in compound text format.  This format is
     described in the X Consortium Standard _C_o_m_p_o_u_n_d _T_e_x_t _E_n_c_o_d_i_n_g.

   RELATED INFORMATION
     XXmmCCvvttCCTTTTooXXmmSSttrriinngg((33XX)), XXmmFFoonnttLLiisstt((33XX)), XXmmMMaappSSeeggmmeennttEEnnccooddiinngg((33XX)),
     XXmmRReeggiisstteerrSSeeggmmeennttEEnnccooddiinngg((33XX)), and XXmmSSttrriinngg.






   1-277






   XmDeactivateProtocol(3X)



   NAME
     XXmmDDeeaaccttiivvaatteePPrroottooccooll-A VendorShell function that deactivates a protocol
     without removing it

   SYNOPSIS
     ##iinncclluuddee <<XXmm//XXmm..hh>>
     ##iinncclluuddee <<XXmm//PPrroottooccoollss..hh>>
     vvooiidd XXmmDDeeaaccttiivvaatteePPrroottooccooll ((_s_h_e_l_l, _p_r_o_p_e_r_t_y, _p_r_o_t_o_c_o_l))
          WWiiddggeett    _s_h_e_l_l;;
          AAttoomm      _p_r_o_p_e_r_t_y;;
          AAttoomm      _p_r_o_t_o_c_o_l;;
     vvooiidd XXmmDDeeaaccttiivvaatteeWWMMPPrroottooccooll ((_s_h_e_l_l, _p_r_o_t_o_c_o_l))
          WWiiddggeett    _s_h_e_l_l;;
          AAttoomm      _p_r_o_t_o_c_o_l;;

   DESCRIPTION
     XXmmDDeeaaccttiivvaatteePPrroottooccooll deactivates a protocol without removing it.  It
     updates the handlers and the _p_r_o_p_e_r_t_y, if the _s_h_e_l_l is realized.  It is
     sometimes useful to allow a protocol's state information (callback
     lists, etc.) to persist, even though the client may choose to tem-
     porarily resign from the interaction.  The main use of this capability
     is to gray/ungray ff..sseenndd__mmssgg entries in the Mwm system menu.  This is
     supported by allowing a _p_r_o_t_o_c_o_l to be in one of two states:  active or
     inactive.  If the _p_r_o_t_o_c_o_l is active and the _s_h_e_l_l is realized, the _p_r_o_-
     _p_e_r_t_y contains the _p_r_o_t_o_c_o_l AAttoomm.  If the _p_r_o_t_o_c_o_l is inactive, the AAttoomm
     is not present in the _p_r_o_p_e_r_t_y.

     XXmmDDeeaaccttiivvaatteeWWMMPPrroottooccooll is a convenience interface.  It calls XXmmDDeeaaccttiivvaa--
     tteePPrroottooccooll with the property value set to the atom returned by interning
     WWMM__PPRROOTTOOCCOOLLSS.

     _s_h_e_l_l  Specifies the widget with which the protocol property is associ-
            ated

     _p_r_o_p_e_r_t_y
            Specifies the protocol property

     _p_r_o_t_o_c_o_l
            Specifies the protocol atom (or an int type cast to Atom)

     For a complete definition of VendorShell and its associated resources,
     see VVeennddoorrSShheellll((33XX)).

   RELATED INFORMATION
     mmwwmm((11XX)), VVeennddoorrSShheellll((33XX)), XXmmDDeeaaccttiivvaatteeWWMMPPrroottooccooll((33XX)), and
     XXmmIInntteerrnnAAttoomm((33XX)).









   1-278






                                                   XmDeactivateWMProtocol(3X)



   NAME
     XXmmDDeeaaccttiivvaatteeWWMMPPrroottooccooll-A VendorShell convenience interface that deac-
     tivates a protocol without removing it

   SYNOPSIS
     ##iinncclluuddee <<XXmm//XXmm..hh>>
     ##iinncclluuddee <<XXmm//PPrroottooccoollss..hh>>
     vvooiidd XXmmDDeeaaccttiivvaatteeWWMMPPrroottooccooll ((_s_h_e_l_l, _p_r_o_t_o_c_o_l))
          WWiiddggeett    _s_h_e_l_l;;
          AAttoomm      _p_r_o_t_o_c_o_l;;

   DESCRIPTION
     XXmmDDeeaaccttiivvaatteeWWMMPPrroottooccooll is a convenience interface.  It calls XXmmDDeeaaccttiivvaa--
     tteePPrroottooccooll with the property value set to the atom returned by interning
     WWMM__PPRROOTTOOCCOOLLSS.

     _s_h_e_l_l  Specifies the widget with which the protocol property is associ-
            ated

     _p_r_o_t_o_c_o_l
            Specifies the protocol atom (or an int type cast to Atom)

     For a complete definition of VendorShell and its associated resources,
     see VVeennddoorrSShheellll((33XX)).

   RELATED INFORMATION
     VVeennddoorrSShheellll((33XX)), XXmmDDeeaaccttiivvaatteePPrroottooccooll((33XX)), and XXmmIInntteerrnnAAttoomm((33XX)).




























   1-279






   XmDestroyPixmap(3X)



   NAME
     XXmmDDeessttrrooyyPPiixxmmaapp-A pixmap caching function that removes a pixmap from the
     pixmap cache

   SYNOPSIS
     ##iinncclluuddee <<XXmm//XXmm..hh>>
     BBoooolleeaann XXmmDDeessttrrooyyPPiixxmmaapp ((_s_c_r_e_e_n, _p_i_x_m_a_p))
          SSccrreeeenn    * _s_c_r_e_e_n;;
          PPiixxmmaapp    _p_i_x_m_a_p;;

   DESCRIPTION
     XXmmDDeessttrrooyyPPiixxmmaapp removes pixmaps that are no longer used.  Pixmaps are
     completely freed only when there is no further reference to them.

     _s_c_r_e_e_n Specifies the display screen for which the pixmap was requested

     _p_i_x_m_a_p Specifies the pixmap to be destroyed

   RETURN VALUE
     Returns True when successful; returns False if there is no matching
     screen and pixmap in the pixmap cache.

   RELATED INFORMATION
     XXmmIInnssttaallllIImmaaggee((33XX)), XXmmUUnniinnssttaallllIImmaaggee((33XX)), and XXmmGGeettPPiixxmmaapp((33XX)).































   1-280






                                                            XmDialogShell(3X)



   NAME
     XXmmDDiiaallooggSShheellll-The DialogShell widget class

   SYNOPSIS
     ##iinncclluuddee <<XXmm//DDiiaallooggSS..hh>>

   DESCRIPTION
     Modal and modeless dialogs use DialogShell as the Shell parent.  Dialog-
     Shell widgets cannot be iconified.  Instead, all secondary DialogShell
     widgets associated with an ApplicationShell widget are iconified and
     de-iconified as a group with the primary widget.

     The client indirectly manipulates DialogShell via the convenience inter-
     faces during creation, and it can directly manipulate its
     BulletinBoard-derived child.  Much of the functionality of DialogShell
     assumes that its child is a BulletinBoard subclass, although it can
     potentially stand alone.

     Setting XXmmNNhheeiigghhtt, XXmmNNwwiiddtthh, or XXmmNNbboorrddeerrWWiiddtthh for either a DialogShell
     or its managed child usually sets that resource to the same value in
     both the parent and the child.  When an off-the-spot input method
     exists, the height and width of the shell may be greater than those of
     the managed child in order to accommodate the input method.  In this
     case setting XXmmNNhheeiigghhtt or XXmmNNwwiiddtthh for the shell does not necessarily
     set that resource to the same value in the managed child, and setting
     XXmmNNhheeiigghhtt or XXmmNNwwiiddtthh for the child does not necessarily set that
     resource to the same value in the shell.

     For the managed child of a DialogShell, regardless of the value of the
     shell's XXmmNNaalllloowwSShheellllRReessiizzee, setting XXmmNNxx or XXmmNNyy sets the corresponding
     resource of the parent but does not change the child's position relative
     to the parent.  XXttGGeettVVaalluueess for the child's XXmmNNxx or XXmmNNyy yields the
     value of the corresponding resource in the parent.  The _x and _y coordi-
     nates of the child's upper left outside corner relative to the parent's
     upper left inside corner are both zero minus the value of XXmmNNbboorr--
     ddeerrWWiiddtthh.

     Note that the _I_n_t_e_r-_C_l_i_e_n_t _C_o_m_m_u_n_i_c_a_t_i_o_n _C_o_n_v_e_n_t_i_o_n_s _M_a_n_u_a_l allows a
     window manager to change or control the border width of a reparented
     top-level window.

     Classes

     DialogShell inherits behavior and resources from CCoorree, CCoommppoossiittee, SShheellll,
     WWMMSShheellll, VVeennddoorrSShheellll, and TTrraannssiieennttSShheellll classes.

     The class pointer is xxmmDDiiaallooggSShheellllWWiiddggeettCCllaassss.

     The class name is XXmmDDiiaallooggSShheellll.






   1-281






   XmDialogShell(3X)


     New Resources

     DialogShell defines no new resources but overrides the XXmmNNddeelleetteeRReessppoonnssee
     resource in the VVeennddoorrSShheellll class.

     Inherited Resources

     DialogShell inherits behavior and resources from the following superc-
     lasses.  For a complete description of each resource, refer to the man
     page for that superclass.

     The following table defines a set of widget resources used by the pro-
     grammer 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 XXmmNN or XXmmCC prefix and use the remaining letters.  To specify one of
     the defined values for a resource in a .Xdefaults file, remove the XXmm
     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 XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G), or is
     not applicable (N/A).
                           TTrraannssiieennttSShheellll RReessoouurrccee SSeett
          NNaammee              CCllaassss             TTyyppee     DDeeffaauulltt   AAcccceessss
          _____________________________________________________________
          XmNtransientFor   XmCTransientFor   Widget   NULL      CSG
                                 VVeennddoorrSShheellll RReessoouurrccee SSeett
   NNaammee                     CCllaassss                    TTyyppee            DDeeffaauulltt      AAcccceessss
   _____________________________________________________________________________________
   XmNaudibleWarning        XmCAudibleWarning        unsigned char   XmBELL       CSG
   XmNbuttonFontList        XmCButtonFontList        XmFontList      dynamic      CSG
   XmNdefaultFontList       XmCDefaultFontList       XmFontList      dynamic      CG
   XmNdeleteResponse        XmCDeleteResponse        unsigned char   XmUNMAP      CSG
   XmNinputMethod           XmCInputMethod           String          NULL         CSG
   XmNkeyboardFocusPolicy   XmCKeyboardFocusPolicy   unsigned char   XmEXPLICIT   CSG
   XmNlabelFontList         XmCLabelFontList         XmFontList      dynamic      CSG
   XmNmwmDecorations        XmCMwmDecorations        int             -1           CSG
   XmNmwmFunctions          XmCMwmFunctions          int             -1           CSG
   XmNmwmInputMode          XmCMwmInputMode          int             -1           CSG
   XmNmwmMenu               XmCMwmMenu               String          NULL         CSG
   XmNpreeditType           XmCPreeditType           String          dynamic      CSG
   XmNshellUnitType         XmCShellUnitType         unsigned char   XmPIXELS     CSG
   XmNtextFontList          XmCTextFontList          XmFontList      dynamic      CSG
   XmNuseAsyncGeometry      XmCUseAsyncGeometry      Boolean         False        CSG
                                WWMMSShheellll RReessoouurrccee SSeett
   NNaammee               CCllaassss              TTyyppee      DDeeffaauulltt                 AAcccceessss
   ______________________________________________________________________________
   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       -1                      CSG


   1-282






                                                            XmDialogShell(3X)


   XmNiconY           XmCIconY           int       -1                      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   True                    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
                                            SShheellll RReessoouurrccee SSeett
   NNaammee                      CCllaassss                     TTyyppee                     DDeeffaauulltt          AAcccceessss
   ____________________________________________________________________________________________________
   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                  True             CSG
   XmNvisual                 XmCVisual                 Visual *                 CopyFromParent   CSG
                              CCoommppoossiittee RReessoouurrccee SSeett
      NNaammee                CCllaassss               TTyyppee          DDeeffaauulltt   AAcccceessss
      ______________________________________________________________________
      XmNchildren         XmCReadOnly         WidgetList    NULL      G
      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
      XmNnumChildren      XmCReadOnly         Cardinal      0         G
                                                 CCoorree RReessoouurrccee SSeett
   NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                AAcccceessss
   ______________________________________________________________________________________________________________
   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        1                      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


   1-283






   XmDialogShell(3X)


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

   RELATED INFORMATION
     CCoommppoossiittee((33XX)), CCoorree((33XX)), SShheellll((33XX)), TTrraannssiieennttSShheellll((33XX)), WWMMSShheellll((33XX)),
     VVeennddoorrSShheellll((33XX)), and XXmmCCrreeaatteeDDiiaallooggSShheellll((33XX)).












































   1-284



 _
