Traits(file formats)                                   Traits(file formats)




 NAME    [Toc]    [Back]
      Traits - Lists the traits used by the Motif Toolkit.

 DESCRIPTION    [Toc]    [Back]
      A trait is a characteristic of a widget. A widget holding a particular
      trait is announcing a particular ability to other widgets.  The
      following table summarizes the standard Motif traits.

      ___________________________________________________________
                         Purpose of Each Trait
       Trait Name               A Widget Holding This Trait Can
                                Do The Following:
      ___________________________________________________________
       XmQTaccessTextual        Display one primary text parcel.
      ___________________________________________________________
       XmQTactivatable          Become a command button in a
                                dialog box.
      ___________________________________________________________
       XmQTcareParentVisual     Borrow its parent's visual
                                information.
      ___________________________________________________________
       XmQTcontainer            Manage container item children.
      ___________________________________________________________
       XmQTcontainerItem        Become a child of a container
                                widget.
      ___________________________________________________________
       XmQTdialogShellSavvy     Become a child of a DialogShell.
      ___________________________________________________________
       XmQTjoinSide             Attach itself to one side of a
                                suitable parent.
      ___________________________________________________________
       XmQTmenuSavvy            Become a menu child.
      ___________________________________________________________
       XmQTmenuSystem           Manage a menu system.
      ___________________________________________________________
       XmQTnavigator            Act as a navigator to a
                                scrollable widget.
      ___________________________________________________________
       XmQTscrollFrame          Handle one or more navigator
                                widgets.
      ___________________________________________________________
       XmQTspecifyRenderTable   Supply the names of its default
                                render tables.
      ___________________________________________________________
       XmQTtakesDefault         Change its appearance to show
                                that it is the default button.
      ___________________________________________________________
       XmQTtransfer             Transfer data to other widgets
                                and/or receive data from other
                                widgets
      ___________________________________________________________



                                    - 1 -       Formatted:  January 24, 2005






 Traits(file formats)                                   Traits(file formats)




      ___________________________________________________________
      |                       |                                  |
      Traits are not often used in Motif application programs.  However,
      traits are very important to widget writers.  For complete details on
      traits, see the Motif Widget Writer's Guide.               |
      |                       |                                  |
      The following table lists the names of all widgets and gadgets in the
      standard Motif widget set that hold a particular trait.  For example,
      the following table shows that the XmQTcontainerItem trait is held by
      the XmIconGadget.  As the table suggests, some traits are held by many
      of the standard Motif widgets.

      ___________________________________________________________
               Trait Installation in Standard Widget Set
       Trait Name               Is Installed on The Following
                                Widgets:
      ___________________________________________________________
       XmQTaccessTextual        XmLabel and all its subclasses;
                                XmLabelGadget and all its
                                subclasses; XmText; XmTextField
      ___________________________________________________________
       XmQTactivatable          XmArrowButton;
                                XmArrowButtonGadget;
                                XmDrawnButton; XmPushButton;
                                XmPushButtonGadget
      ___________________________________________________________
       XmQTcareParentVisual     All the subclasses of XmGadget
                                (but not XmGadget itself);
                                XmPrimitive and all its
                                subclasses
      ___________________________________________________________
       XmQTcontainer            XmContainer
      ___________________________________________________________
       XmQTcontainerItem        XmIconGadget
      ___________________________________________________________
       XmQTdialogShellSavvy     XmBulletinBoard
      ___________________________________________________________
       XmQTjoinSide             No widgets install this trait
      ___________________________________________________________
       XmQTmenuSavvy            XmLabel; XmDrawnButton;
                                XmCascadeButton; XmPushButton;
                                XmToggleButton; XmLabelGadget;
                                XmCascadeButtonGadget;
                                XmPushButtonGadget;
                                XmToggleButtonGadget
      ___________________________________________________________
       XmQTmenuSystem           XmRowColumn
      ___________________________________________________________
       XmQTnavigator            XmScrollBar; XmSpinBox
      ___________________________________________________________
       XmQTscrollFrame          XmNotebook; XmScrolledWindow



                                    - 2 -       Formatted:  January 24, 2005






 Traits(file formats)                                   Traits(file formats)




      ___________________________________________________________
       XmQTspecifyRenderTable   XmBulletinBoard and all its
                                subclasses; XmMenuShell;
                                XmVendorShell
      ___________________________________________________________
       XmQTtakesDefault         XmPushButton; XmPushButtonGadget
      ___________________________________________________________
       XmQTtransfer             XmContainer; XmLabel and all its
                                subclasses; XmLabelGadget and
                                all its subclasses; XmList;
                                XmScale; XmText; XmTextField
      ___________________________________________________________
      ___________________________________________________________
                              |
                              |
      The following table lists the traits installed on each widget.  For
      example, the following table indicates that the XmArrowButton widget
      holds both the XmQTactivatable and XmQTcareParentVisual traits.




































                                    - 3 -       Formatted:  January 24, 2005






 Traits(file formats)                                   Traits(file formats)




      _____________________________________________________________
                              Trait Use by
       Widget
       Widget Name             Installs These Traits
      _____________________________________________________________
       =
      _____________________________________________________________
       XmArrowButton           XmQTactivatable,
                               XmQTcareParentVisual
      _____________________________________________________________
       XmArrowButtonGadget     XmQTactivatable,
                               XmQTcareParentVisual
      _____________________________________________________________
       XmBulletinBoard         XmQTdialogShellSavvy,
                               XmQTspecifyRenderTable
      _____________________________________________________________
       XmCascadeButton         XmQTaccessTextual,
                               XmQTcareParentVisual,
                               XmQTmenuSavvy, XmQTtransfer
      _____________________________________________________________
       XmCascadeButtonGadget   XmQTaccessTextual,
                               XmQTcareParentVisual,
                               XmQTmenuSavvy, XmQTtransfer
                               XmComboBox
      _____________________________________________________________
       XmCommand               XmQTspecifyRenderTable
      _____________________________________________________________
       XmContainer             XmQTcontainer, XmQTtransfer
      _____________________________________________________________
       XmDialogShell           None
      _____________________________________________________________
       XmDisplay               None
      _____________________________________________________________
       XmDragContext           None
      _____________________________________________________________
       XmDragIcon              None
      _____________________________________________________________
       XmDrawingArea           None
      _____________________________________________________________
       XmDrawnButton           XmQTaccessTextual, XmQTactivatable,
                               XmQTcareParentVisual,
                               XmQTmenuSavvy, XmQTtransfer
      _____________________________________________________________
       XmDropTransfer          None
      _____________________________________________________________
       XmFileSelectionBox      XmQTspecifyRenderTable
      _____________________________________________________________
       XmForm                  XmQTspecifyRenderTable
      _____________________________________________________________
       XmFrame                 None
      _____________________________________________________________



                                    - 4 -       Formatted:  January 24, 2005






 Traits(file formats)                                   Traits(file formats)




       XmGadget                None
      _____________________________________________________________
       XmIconGadget            XmQTcareParentVisual,
                               XmQTcontainerItem
      _____________________________________________________________
       XmLabel                 XmQTaccessTextual,
                               XmQTcareParentVisual,
                               XmQTmenuSavvy, XmQTtransfer
      _____________________________________________________________
       XmLabelGadget           XmQTaccessTextual,
                               XmQTcareParentVisual,
                               XmQTmenuSavvy, XmQTtransfer
      _____________________________________________________________
       XmList                  XmQTcareParentVisual, XmQTtransfer
      _____________________________________________________________
       XmMainWindow
      _____________________________________________________________
       XmManager
      _____________________________________________________________
       XmMenuShell             XmQTspecifyRenderTable
      _____________________________________________________________
       XmMessageBox            XmQTspecifyRenderTable
      _____________________________________________________________
       XmNotebook              XmQTscrollFrame
      _____________________________________________________________
       XmPanedWindow
      _____________________________________________________________
       XmPrimitive             XmQTcareParentVisual
      _____________________________________________________________
       XmPushButton            XmQTaccessTextual, XmQTactivatable,
                               XmQTcareParentVisual,
                               XmQTmenuSavvy, XmQTtakesDefault,
                               XmQTtransfer
      _____________________________________________________________
       XmPushButtonGadget      XmQTaccessTextual, XmQTactivatable,
                               XmQTcareParentVisual,
                               XmQTmenuSavvy, XmQTtakesDefault,
                               XmQTtransfer
      _____________________________________________________________
       XmRowColumn             XmQTmenuSystem
      _____________________________________________________________
       XmScale                 XmQTtransfer
      _____________________________________________________________
       XmScreen
      _____________________________________________________________
       XmScrollbar             XmQTcareParentVisual, XmQTnavigator
      _____________________________________________________________
       XmScrolledWindow        XmQTscrollFrame
      _____________________________________________________________
       XmSelectionBox          XmQTspecifyRenderTable
      _____________________________________________________________



                                    - 5 -       Formatted:  January 24, 2005






 Traits(file formats)                                   Traits(file formats)




       XmSeparator             XmQTcareParentVisual
      |____________________________________________________________|
      |XmSeparatorGadget       XmQTcareParentVisual                |
      |______________________|_____________________________________|
      |XmSpinBox             | XmQTnavigator                       |
      |______________________|_____________________________________|
      |XmText                | XmQTaccessTextual,                  |
      |                      | XmQTcareParentVisual, XmQTtransfer  |
      |______________________|_____________________________________|
      |XmTextField           | XmQTaccessTextual,                  |
      |                      | XmQTcareParentVisual, XmQTtransfer  |
      |______________________|_____________________________________|
      |XmToggleButton        | XmQTaccessTextual,                  |
      |                      | XmQTcareParentVisual, XmQTtransfer  |
      |______________________|_____________________________________|
      |XmToggleButtonGadget  | XmQTaccessTextual,                  |
      |                      | XmQTcareParentVisual, XmQTtransfer  |
      |______________________|_____________________________________|
      |VendorShell           | XmQTspecifyRenderTable              |
      |______________________|_____________________________________|
      |______________________|_____________________________________|

      The following table summarizes how the standard Motif widgets access
      traits. There are two general ways for a widget to access the traits
      of another widget.

      One way is for a widget to ask another widget if it holds a particular
      trait.  For example, XmBulletinBoard asks each of its children widgets
      if they hold the XmQTtakesDefault trait.  XmBulletinBoard calls none
      of the trait methods of XmQTtakesDefault.

      Another kind of access is when one widget calls another widget's trait
      method(s).  For example, XmBulletinBoard calls the getRenderTable
      trait method of the XmQTspecifyRenderTable trait.




















                                    - 6 -       Formatted:  January 24, 2005






 Traits(file formats)                                   Traits(file formats)




      ______________________________________________________________________________________
                                         Trait Access By
       Widget
       Widget                  Accesses These Traits:   Calls These Trait Methods:
      ______________________________________________________________________________________
       XmArrowButton           None                     None
      ______________________________________________________________________________________
       XmArrowButtonGadget     None                     None
      ______________________________________________________________________________________
       XmBulletinBoard         XmQTtakesDefault         None
      ______________________________________________________________________________________
       XmBulletinBoard         XmQTspecifyRenderTable   getRenderTable
      ______________________________________________________________________________________
       XmCascadeButton         XmQTmenuSystem           Many
      ______________________________________________________________________________________
       XmCascadeButton         XmQTspecifyRenderTable   getRenderTable
      ______________________________________________________________________________________
       XmCascadeButtonGadget   XmQTmenuSystem           Many
      ______________________________________________________________________________________
       XmCascadeButtonGadget   XmQTspecifyRenderTable   getRenderTable
      ______________________________________________________________________________________
       XmComboBox              XmQTaccessTextual        getValue, setValue
      ______________________________________________________________________________________
       XmCommand               None                     None
      ______________________________________________________________________________________
       XmContainer             XmQTcontainerItem        getValues, setValues
      ______________________________________________________________________________________
       XmContainer             XmQTscrollFrame          getInfo
      ______________________________________________________________________________________
       XmDialogShell           XmQTdialogShellSavvy     callMapUnmapCB
      ______________________________________________________________________________________
       XmDisplay               None                     None
      ______________________________________________________________________________________
       XmDragContext           None                     None
      ______________________________________________________________________________________
       XmDragIcon              None                     None
      ______________________________________________________________________________________
       XmDrawingArea           None                     None
      ______________________________________________________________________________________
       XmDrawnButton           XmQTmenuSystem           Many
      ______________________________________________________________________________________
       XmDrawnButton           XmQTspecifyRenderTable   getRenderTable
      ______________________________________________________________________________________
       XmDropTransfer          None                     None
      ______________________________________________________________________________________
       XmFileSelectionBox      XmQTactivatable          None
      ______________________________________________________________________________________
       XmForm                  None                     None
      ______________________________________________________________________________________
       XmFrame                 None                     None
      ______________________________________________________________________________________



                                    - 7 -       Formatted:  January 24, 2005






 Traits(file formats)                                   Traits(file formats)




       XmGadget                None                     None
      ______________________________________________________________________________________
       XmIconGadget            XmQTcontainer            getValues
      ______________________________________________________________________________________
       XmIconGadget            XmQTspecifyRenderTable   getRenderTable
      ______________________________________________________________________________________
       XmLabel                 XmQTmenuSystem           various methods
      ______________________________________________________________________________________
       XmLabel                 XmQTspecifyRenderTable   getRenderTable
      ______________________________________________________________________________________
       XmLabelGadget           XmQTmenuSystem           various methods
      ______________________________________________________________________________________
       XmLabelGadget           XmQTspecifyRenderTable   getRenderTable
      ______________________________________________________________________________________
       XmList                  XmQTnavigator            getValues
      ______________________________________________________________________________________
       XmList                  XmQTscrollFrame          getInfo, init
      ______________________________________________________________________________________
       XmList                  XmQTspecifyRenderTable   getRenderTable
      ______________________________________________________________________________________
       XmMainWindow            XmQTmenuSystem           various methods
      ______________________________________________________________________________________
       XmManager               None                     None
      ______________________________________________________________________________________
       XmMenuShell             XmQTmenuSystem           various methods
      ______________________________________________________________________________________
       XmMenuShell             XmQTspecifyRenderTable   getRenderTable
      ______________________________________________________________________________________
       XmMessageBox            XmQTactivatable          None
      ______________________________________________________________________________________
       XmNotebook              XmQTscrollFrame          init, addNavigator, removeNavigator
      ______________________________________________________________________________________
       XmNotebook              XmQTnavigator            getValue
      ______________________________________________________________________________________
       XmNotebook              XmQTactivatable          changeCB
      ______________________________________________________________________________________
       XmNotebook              XmQTaccessTextual        None
      ______________________________________________________________________________________
       XmPanedWindow           None                     None
      ______________________________________________________________________________________
       XmPrimitive             None                     None
      ______________________________________________________________________________________
       XmPushButton            XmQTmenuSystem           various methods
      ______________________________________________________________________________________
       XmPushButton            XmQTspecifyRenderTable   getRenderTable
      ______________________________________________________________________________________
       XmPushButtonGadget      XmQTmenuSystem           various methods
      ______________________________________________________________________________________
       XmPushButtonGadget      XmQTspecifyRenderTable   getRenderTable
      ______________________________________________________________________________________




                                    - 8 -       Formatted:  January 24, 2005






 Traits(file formats)                                   Traits(file formats)




       XmRowColumn             XmQTmenuSavvy            getAccelerator, getMnemonic,
      |                                                 getActivateCBName                   |
      |_____________________________________________________________________________________|
      |XmRowColumn           | XmQTmenuSystem         | various methods                     |
      |______________________|________________________|_____________________________________|
      |XmScale               | XmQTspecifyRenderTable | getRenderTable                      |
      |______________________|________________________|_____________________________________|
      |XmScreen              | None                   | None                                |
      |______________________|________________________|_____________________________________|
      |XmScrollbar           | None                   | None                                |
      |______________________|________________________|_____________________________________|
      |XmScrolledWindow      | XmQTnavigator          | getValue                            |
      |______________________|________________________|_____________________________________|
      |XmScrolledWindow      | XmQTscrollFrame        | init, addNavigator                  |
      |______________________|________________________|_____________________________________|
      |XmSelectionBox        | XmQTaccessTextual      | setValue;                           |
      |______________________|________________________|_____________________________________|
      |XmSelectionBox        | XmQTactivatable        | None                                |
      |______________________|________________________|_____________________________________|
      |XmSeparator           | None                   | None                                |
      |______________________|________________________|_____________________________________|
      |XmSeparatorGadget     | None                   | None                                |
      |______________________|________________________|_____________________________________|
      |XmSpinBox             | XmQTaccessTextual      | setValue                            |
      |______________________|________________________|_____________________________________|
      |XmText                | XmQTaccessTextual      | getValue, setValue                  |
      |______________________|________________________|_____________________________________|
      |XmText                | XmQTnavigator          | getValue                            |
      |______________________|________________________|_____________________________________|
      |XmText                | XmQTscrollFrame        | getInfo, init                       |
      |______________________|________________________|_____________________________________|
      |XmText                | XmQTspecifyRenderTable | getRenderTable                      |
      |______________________|________________________|_____________________________________|
      |XmTextField           | XmQTspecifyRenderTable | getRenderTable                      |
      |______________________|________________________|_____________________________________|
      |XmToggleButton        | XmQTmenuSystem         | various methods                     |
      |______________________|________________________|_____________________________________|
      |XmToggleButton        | XmQTspecifyRenderTable | getRenderTable                      |
      |______________________|________________________|_____________________________________|
      |XmToggleButtonGadget  | XmQTmenuSystem         | various methods                     |
      |______________________|________________________|_____________________________________|
      |XmToggleButtonGadget  | XmQTspecifyRenderTable | getRenderTable                      |
      |______________________|________________________|_____________________________________|
      |VendorShell           | XmQTspecifyRenderTable | getRenderTable                      |
      |______________________|________________________|_____________________________________|
      |______________________|________________________|_____________________________________|

 RELATED    [Toc]    [Back]
      The following reference pages are documented in the Motif Widget
      Writer's Guide: XmeTraitSet(3), XmeTraitGet(3), XmQTaccessTextual(3),
      XmQTactivatable(3), XmQTcareParentVisual(3), XmQTcontainer(3),



                                    - 9 -       Formatted:  January 24, 2005






 Traits(file formats)                                   Traits(file formats)




      XmQTcontainerItem(3), XmQTdialogShellSavvy(3), XmQTjoinSide(3),
      XmQTmenuSavvy(3), XmQTmenuSystem(3), XmQTnavigator(3),
      XmQTscrollFrame(3), XmQTspecifyRenderTable(3), and
      XmQTtakesDefault(3).


                                   - 10 -       Formatted:  January 24, 2005