


     XXmmAAccttiivvaatteePPrroottooccooll((33XX))   RReeffeerreennccee PPaaggeess   XXmmAAccttiivvaatteePPrroottooccooll((33XX))



     NNAAMMEE
          XXmmAAccttiivvaatteePPrroottooccooll-A VendorShell function that activates a
          protocol

     AAEESS SSUUPPPPOORRTT LLEEVVEELL
          Trial-use

     SSYYNNOOPPSSIISS
          ##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mA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mA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;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmAAccttiivvaatteePPrroottooccooll activates a protocol.  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, and so on) to persist, even though the
          client may choose to temporarily resign from the
          interaction.  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mA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mAAccttiivvaat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 associated.

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

          _p_r_o_t_o_c_o_l
                 Specifies the protocol AAttoomm (or an iinntt type cast to
                 AAttoomm).


          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)).




     2-120                                            (printed 5/7/92)






     XXmmAAccttiivvaatteePPrroottooccooll((33XX))   RReeffeerreennccee PPaaggeess   XXmmAAccttiivvaatteePPrroottooccooll((33XX))



     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          VVeennddoorrSShheellll((33XX)), XXmmA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)).




















































     2-121                                            (printed 5/7/92)






     XXmmAAccttiivvaatteeWWMMPPrroottooccooll((33XX)) RReeffeerreennccee PPaaggeess XXmmAAccttiivvaatteeWWMMPPrroottooccooll((33XX))



     NNAAMMEE
          XXmmAAccttiivvaatteeWWMMPPrroottooccooll-A VendorShell convenience interface
          that activates a protocol

     AAEESS SSUUPPPPOORRTT LLEEVVEELL
          Trial-use

     SSYYNNOOPPSSIISS
          ##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mA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;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmA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mAAccttiivvaat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 associated.

          _p_r_o_t_o_c_o_l
                 Specifies the protocol AAttoomm (or an iinntt type cast to
                 AAttoomm).


          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)).

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          VVeennddoorrSShheellll((33XX)), XXmmA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)).



















     2-122                                            (printed 5/7/92)






     XXmmAAddddPPrroottooccoollCCaallllbbaacckk((33XX))RReeffeerreennccee PPaaggeessXXmmAAddddPPrroottooccoollCCaallllbbaacckk((33XX))



     NNAAMMEE
          XXmmAAddddPPrroottooccoollCCaallllbbaacckk-A VendorShell function that adds
          client callbacks for a protocol

     AAEESS SSUUPPPPOORRTT LLEEVVEELL
          Trial-use

     SSYYNNOOPPSSIISS
          ##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mAAddddPPrroottooccoollCCaallllbbaacckk ((_s_h_e_l_l, _p_r_o_p_e_r_t_y, _p_r_o_t_o_c_o_l, _c_a_l_l_b_a_c_k, _c_l_o_s_u_r_e))
               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;;
               XXttCCaallllbbaacckkPPrroocc_c_a_l_l_b_a_c_k;;
               XXttPPooiinntteerr   _c_l_o_s_u_r_e;;

          vvooiidd XXmmAAddddWWMMPPrroottooccoollCCaallllbbaacckk ((_s_h_e_l_l, _p_r_o_t_o_c_o_l, _c_a_l_l_b_a_c_k, _c_l_o_s_u_r_e))
               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;;
               XXttCCaallllbbaacckkPPrroocc_c_a_l_l_b_a_c_k;;
               XXttPPooiinntteerr   _c_l_o_s_u_r_e;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmAAddddPPrroottooccoollCCaallllbbaacckk adds client callbacks for a protocol.
          It checks if the protocol is registered, and if it is not,
          calls XXmmAAddddPPrroottooccoollss.  It then adds the callback to the
          internal list.  These callbacks are called when the
          corresponding client message is received.

          XXmmAAddddWWMMPPrroottooccoollCCaallllbbaacckk is a convenience interface.  It
          calls XXmmAAddddPPrroottooccoollCCaallllbbaacckk 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 associated.

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

          _p_r_o_t_o_c_o_l
                 Specifies the protocol AAttoomm (or an iinntt type cast to
                 AAttoomm).

          _c_a_l_l_b_a_c_k
                 Specifies the procedure to call when a protocol
                 message is received.

          _c_l_o_s_u_r_eSpecifies the client data to be passed to the



     2-123                                            (printed 5/7/92)






     XXmmAAddddPPrroottooccoollCCaallllbbaacckk((33XX))RReeffeerreennccee PPaaggeessXXmmAAddddPPrroottooccoollCCaallllbbaacckk((33XX))



                 callback when it is invoked.


          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)).

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          VVeennddoorrSShheellll((33XX)), XXmmAAddddPPrroottooccoollss((33XX)),
          XXmmAAddddWWMMPPrroottooccoollCCaallllbbaacckk((33XX)), and XXmmIInntteerrnnAAttoomm((33XX)).














































     2-124                                            (printed 5/7/92)






     XXmmAAddddPPrroottooccoollss((33XX))       RReeffeerreennccee PPaaggeess       XXmmAAddddPPrroottooccoollss((33XX))



     NNAAMMEE
          XXmmAAddddPPrroottooccoollss-A VendorShell function that adds the
          protocols to the protocol manager and allocates the internal
          tables

     AAEESS SSUUPPPPOORRTT LLEEVVEELL
          Trial-use

     SSYYNNOOPPSSIISS
          ##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mAAddddPPrroottooccoollss ((_s_h_e_l_l, _p_r_o_p_e_r_t_y, _p_r_o_t_o_c_o_l_s, _n_u_m__p_r_o_t_o_c_o_l_s))
               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_s;;
               CCaarrddiinnaall  _n_u_m__p_r_o_t_o_c_o_l_s;;

          vvooiidd XXmmAAddddWWMMPPrroottooccoollss ((_s_h_e_l_l, _p_r_o_t_o_c_o_l_s, _n_u_m__p_r_o_t_o_c_o_l_s))
               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_s;;
               CCaarrddiinnaall  _n_u_m__p_r_o_t_o_c_o_l_s;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmAAddddPPrroottooccoollss adds the protocols to the protocol manager
          and allocates the internal tables.

          XXmmAAddddWWMMPPrroottooccoollss is a convenience interface.  It calls
          XXmmAAddddPPrroottooccoollss 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 associated.

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

          _p_r_o_t_o_c_o_l_s   Specifies the protocol AAttoommss (or iinntt types cast
                      to AAttoomm).

          _n_u_m__p_r_o_t_o_c_o_l_s
                      Specifies the number of elements in _p_r_o_t_o_c_o_l_s.


          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)).

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          VVeennddoorrSShheellll((33XX)), XXmmAAddddWWMMPPrroottooccoollss((33XX)), and XXmmIInntteerrnnAAttoomm((33XX)).





     2-125                                            (printed 5/7/92)






     XXmmAAddddTTaabbGGrroouupp((33XX))        RReeffeerreennccee PPaaggeess        XXmmAAddddTTaabbGGrroouupp((33XX))



     NNAAMMEE
          XXmmAAddddTTaabbGGrroouupp-A function that adds a manager or a primitive
          widget to the list of tab groups

     AAEESS SSUUPPPPOORRTT LLEEVVEELL
          Full-use

     HHIISSTTOORRYY//DDIIRREECCTTIIOONN
          The XXmmAAddddTTaabbGGrroouupp function is scheduled for removal in
          revision E.

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//XXmm..hh>>

          vvooiidd XXmmAAddddTTaabbGGrroouupp ((_t_a_b__g_r_o_u_p))
               WWiiddggeett    _t_a_b__g_r_o_u_p;;


     DDEESSCCRRIIPPTTIIOONN
          This function is obsolete and its behavior is replaced by
          setting XXmmNNnnaavviiggaattiioonnTTyyppee to XXmmEEXXCCLLUUSSIIVVEE__TTAABB__GGRROOUUPP.  When
          using the keyboard to traverse through a widget hierarchy,
          primitive or manager widgets are grouped together into what
          are known as ttaabb ggrroouuppss.  Any manager or primitive widget
          can be a tab group.  Within a tab group, move the focus to
          the next widget within the tab group by using the arrow
          keys.  To move to another tab group, use KKNNeexxttFFiieelldd or
          KKPPrreevvFFiieelldd.

          Tab groups are ordinarily specified by the XXmmNNnnaavviiggaattiioonnTTyyppee
          resource.  XXmmAAddddTTaabbGGrroouupp is called to control the order of
          traversal of tab groups.  The widget specified by _t_a_b__g_r_o_u_p
          is appended to the list of tab groups to be traversed, and
          the widget's XXmmNNnnaavviiggaattiioonnTTyyppee is set to
          XXmmEEXXCCLLUUSSIIVVEE__TTAABB__GGRROOUUPP.


          _t_a_b__g_r_o_u_p
                 Specifies the manager or primitive widget ID.


     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmMMaannaaggeerr((33XX)), XXmmPPrriimmiittiivvee((33XX)), and XXmmRReemmoovveeTTaabbGGrroouupp((33XX)).












     2-126                                            (printed 5/7/92)






     XXmmAAddddWWMMPPrroottooccoollCCaallllbbaacckk((33XXRR)e)effeerreennccee PPaaggeeXXsmsmAAddddWWMMPPrroottooccoollCCaallllbbaacckk((33XX))



     NNAAMMEE
          XXmmAAddddWWMMPPrroottooccoollCCaallllbbaacckk-A VendorShell convenience interface
          that adds client callbacks for a protocol

     AAEESS SSUUPPPPOORRTT LLEEVVEELL
          Trial-use

     SSYYNNOOPPSSIISS
          ##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mAAddddWWMMPPrroottooccoollCCaallllbbaacckk ((_s_h_e_l_l, _p_r_o_t_o_c_o_l, _c_a_l_l_b_a_c_k, _c_l_o_s_u_r_e))
               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;;
               XXttCCaallllbbaacckkPPrroocc_c_a_l_l_b_a_c_k;;
               XXttPPooiinntteerr   _c_l_o_s_u_r_e;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmAAddddWWMMPPrroottooccoollCCaallllbbaacckk is a convenience interface.  It
          calls XXmmAAddddPPrroottooccoollCCaallllbbaacckk 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 associated.

          _p_r_o_t_o_c_o_l
                 Specifies the protocol AAttoomm (or an iinntt type cast to
                 AAttoomm).

          _c_a_l_l_b_a_c_k
                 Specifies the procedure to call when a protocol
                 message is received.

          _c_l_o_s_u_r_eSpecifies the client data to be passed to the
                 callback when it is invoked.


          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)).

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          VVeennddoorrSShheellll((33XX)), XXmmAAddddPPrroottooccoollCCaallllbbaacckk((33XX)), and
          XXmmIInntteerrnnAAttoomm((33XX)).










     2-127                                            (printed 5/7/92)






     XXmmAAddddWWMMPPrroottooccoollss((33XX))     RReeffeerreennccee PPaaggeess     XXmmAAddddWWMMPPrroottooccoollss((33XX))



     NNAAMMEE
          XXmmAAddddWWMMPPrroottooccoollss-A VendorShell convenience interface that
          adds the protocols to the protocol manager and allocates the
          internal tables

     AAEESS SSUUPPPPOORRTT LLEEVVEELL
          Trial-use

     SSYYNNOOPPSSIISS
          ##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mAAddddWWMMPPrroottooccoollss ((_s_h_e_l_l, _p_r_o_t_o_c_o_l_s, _n_u_m__p_r_o_t_o_c_o_l_s))
               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_s;;
               CCaarrddiinnaall  _n_u_m__p_r_o_t_o_c_o_l_s;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmAAddddWWMMPPrroottooccoollss is a convenience interface.  It calls
          XXmmAAddddPPrroottooccoollss 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 associated.

          _p_r_o_t_o_c_o_l_s   Specifies the protocol AAttoommss (or iinntt types cast
                      to AAttoomm).

          _n_u_m__p_r_o_t_o_c_o_l_s
                      Specifies the number of elements in _p_r_o_t_o_c_o_l_s.


          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)).

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          VVeennddoorrSShheellll((33XX)), XXmmAAddddPPrroottooccoollss((33XX)), and XXmmIInntteerrnnAAttoomm((33XX)).
















     2-128                                            (printed 5/7/92)






     XXmmAArrrroowwBBuuttttoonn((33XX))        RReeffeerreennccee PPaaggeess        XXmmAArrrroowwBBuuttttoonn((33XX))



     NNAAMMEE
          XXmmAArrrroowwBBuuttttoonn-The ArrowButton widget class

     AAEESS SSUUPPPPOORRTT LLEEVVEELL
          Full-use

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//AArrrroowwBB..hh>>


     DDEESSCCRRIIPPTTIIOONN
          ArrowButton consists of a directional arrow surrounded by a
          border shadow.  When it is selected, the shadow changes to
          give the appearance that the ArrowButton has been pressed
          in.  When the ArrowButton is unselected, the shadow reverts
          to give the appearance that the ArrowButton is released, or
          out.

        CCllaasssseess
          ArrowButton inherits behavior and resources from CCoorree and
          XXmmPPrriimmiittiivvee classes.

          The class pointer is xxmmAArrrroowwBBuuttttoonnWWiiddggeettCCllaassss.

          The class name is XXmmAArrrroowwBBuuttttoonn.

        NNeeww RReessoouurrcceess
          The following table defines a set of widget resources used
          by the programmer to specify data.  The programmer can also
          set the resource values for the inherited classes to set
          attributes for this widget.  To reference a resource by name
          or by class in a .Xdefaults file, remove the 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).















     2-129                                            (printed 5/7/92)






     XXmmAArrrroowwBBuuttttoonn((33XX))        RReeffeerreennccee PPaaggeess        XXmmAArrrroowwBBuuttttoonn((33XX))



                               XXmmAArrrroowwBBuuttttoonn 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
     ______________________________________________________________________________
     XmNactivateCallback   XmCCallback         XtCallbackList   NULL         C
     XmNarmCallback        XmCCallback         XtCallbackList   NULL         C
     XmNarrowDirection     XmCArrowDirection   unsigned char    XmARROW_UP   CSG
     XmNdisarmCallback     XmCCallback         XtCallbackList   NULL         C
     XmNmultiClick         XmCMultiClick       unsigned char    dynamic      CSG


          XXmmNNaaccttiivvaatteeCCaallllbbaacckk
                    Specifies a list of callbacks that is called when
                    the ArrowButton is activated.  To activate the
                    button, press and release BBSSeelleecctt while the
                    pointer is inside the ArrowButton widget.
                    Activating the ArrowButton also disarms it.  The
                    reason sent by this callback is XXmmCCRR__AACCTTIIVVAATTEE.

          XXmmNNaarrmmCCaallllbbaacckk
                    Specifies a list of callbacks that is called when
                    the ArrowButton is armed.  To arm this widget,
                    press BBSSeelleecctt while the pointer is inside the
                    ArrowButton.  The reason sent by this callback is
                    XXmmCCRR__AARRMM.

          XXmmNNaarrrroowwDDiirreeccttiioonn
                    Sets the arrow direction.  The following are
                    values for this resource:


                      +o  XXmmAARRRROOWW__UUPP.

                      +o  XXmmAARRRROOWW__DDOOWWNN.

                      +o  XXmmAARRRROOWW__LLEEFFTT.

                      +o  XXmmAARRRROOWW__RRIIGGHHTT.


          XXmmNNddiissaarrmmCCaallllbbaacckk
                    Specifies a list of callbacks that is called when
                    the ArrowButton is disarmed.  To disarm this
                    widget, press and release BBSSeelleecctt while the
                    pointer is inside the ArrowButton.  The reason for
                    this callback is XXmmCCRR__DDIISSAARRMM.

          XXmmNNmmuullttiiCClliicckk
                    If a button click is followed by another button
                    click within the time span specified by the
                    display's multi-click time, and this resource is
                    set to XXmmMMUULLTTIICCLLIICCKK__DDIISSCCAARRDD, do not process the
                    second click.  If this resource is set to



     2-130                                            (printed 5/7/92)






     XXmmAArrrroowwBBuuttttoonn((33XX))        RReeffeerreennccee PPaaggeess        XXmmAArrrroowwBBuuttttoonn((33XX))



                    XXmmMMUULLTTIICCLLIICCKK__KKEEEEPP, process the event and increment
                    _c_l_i_c_k__c_o_u_n_t in the callback structure.  When the
                    button is not in a menu, the default value is
                    XXmmMMUULLTTIICCLLIICCKK__KKEEEEPP.


        IInnhheerriitteedd RReessoouurrcceess
          ArrowButton 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mPPrriimmiittiivve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
     ________________________________________________________________________________________________
     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
     XmNhighlightOnEnter     XmCHighlightOnEnter     Boolean            False                  CSG
     XmNhighlightPixmap      XmCHighlightPixmap      Pixmap             dynamic                CSG
     XmNhighlightThickness   XmCHighlightThickness   Dimension          2                      CSG
     XmNnavigationType       XmCNavigationType       XmNavigationType   XmNONE                 CSG
     XmNshadowThickness      XmCShadowThickness      Dimension          2                      CSG
     XmNtopShadowColor       XmCTopShadowColor       Pixel              dynamic                CSG
     XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap             dynamic                CSG
     XmNtraversalOn          XmCTraversalOn          Boolean            True                   CSG
     XmNuserData             XmCUserData             XtPointer          NULL                   CSG

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







     2-131                                            (printed 5/7/92)






     XXmmAArrrroowwBBuuttttoonn((33XX))        RReeffeerreennccee PPaaggeess        XXmmAArrrroowwBBuuttttoonn((33XX))



     XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
     XmNx                            XmCPosition                     Position         0                      CSG
     XmNy                            XmCPosition                     Position         0                      CSG

        CCaallllbbaacckk IInnffoorrmmaattiioonn
          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;;
            iinntt      _c_l_i_c_k__c_o_u_n_t;;
          }} XXmmAArrrroowwBBuuttttoonnC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.

          _c_l_i_c_k__c_o_u_n_t
                 This value is valid only when the reason is
                 XXmmCCRR__AACCTTIIVVAATTEE.  It contains the number of clicks in
                 the last multiclick sequence if the XXmmNNmmuullttiiCClliicckk
                 resource is set to XXmmMMUULLTTIICCLLIICCKK__KKEEEEPP; otherwise it
                 contains 11.  The activate callback is invoked for
                 each click if XXmmNNmmuullttiiCClliicckk is set to
                 XXmmMMUULLTTIICCLLIICCKK__KKEEEEPP.



























     2-132                                            (printed 5/7/92)






     XXmmAArrrroowwBBuuttttoonn((33XX))        RReeffeerreennccee PPaaggeess        XXmmAArrrroowwBBuuttttoonn((33XX))



        AAccttiioonn RRoouuttiinneess
          The XmArrowButton action routines are described below:


          AAccttiivvaattee(()):
                    Draws the shadow in the unselected state.  If the
                    pointer is within the ArrowButton, calls the
                    callbacks for XXmmNNaaccttiivvaatteeCCaallllbbaacckk.

          AArrmm(()):    Draws the shadow in the selected state and calls
                    the callbacks for XXmmNNaarrmmCCaallllbbaacckk.

          AArrmmAAnnddAAccttiivvaattee(()):
                    Draws the shadow in the selected state and calls
                    the callbacks for XXmmNNaarrmmCCaallllbbaacckk.  Arranges for
                    the shadow to be drawn in the unselected state and
                    the callbacks for XXmmNNaaccttiivvaatteeCCaallllbbaacckk and
                    XXmmNNddiissaarrmmCCaallllbbaacckk to be called, either immediately
                    or at a later time.

          DDiissaarrmm(()): Draws the shadow in the unselected state and calls
                    the callbacks for XXmmNNddiissaarrmmCCaallllbbaacckk.

          HHeellpp(()):   Calls the callbacks for XXmmNNhheellppCCaallllbbaacckk if any
                    exist.  If there are no help callbacks for this
                    widget, this action calls the help callbacks for
                    the nearest ancestor that has them.

          MMuullttiiAAccttiivvaattee(()):
                    If XXmmNNmmuullttiiCClliicckk is XXmmMMUULLTTIICCLLIICCKK__DDIISSCCAARRDD, this
                    action does nothing.

                    If XXmmNNmmuullttiiCClliicckk is XXmmMMUULLTTIICCLLIICCKK__KKEEEEPP, this action
                    does the following:  Increments _c_l_i_c_k__c_o_u_n_t in the
                    callback structure.  Draws the shadow in the
                    unselected state.  If the pointer is within the
                    ArrowButton, calls the callbacks for
                    XXmmNNaaccttiivvaatteeCCaallllbbaacckk.  Calls the callbacks for
                    XXmmNNddiissaarrmmCCaallllbbaacckk.

          MMuullttiiAArrmm(()):
                    If XXmmNNmmuullttiiCClliicckk is XXmmMMUULLTTIICCLLIICCKK__DDIISSCCAARRDD, this
                    action does nothing.  If XXmmNNmmuullttiiCClliicckk is
                    XXmmMMUULLTTIICCLLIICCKK__KKEEEEPP, this action draws the shadow in
                    the selected state and calls the callbacks for
                    XXmmNNaarrmmCCaallllbbaacckk.









     2-133                                            (printed 5/7/92)






     XXmmAArrrroowwBBuuttttoonn((33XX))        RReeffeerreennccee PPaaggeess        XXmmAArrrroowwBBuuttttoonn((33XX))



     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          CCoorree((33XX)), XXmmCCrreeaatteeAArrrroowwBBuuttttoonn((33XX)), and XXmmPPrriimmiittiivvee((33XX)).





















































     2-134                                            (printed 5/7/92)






     XXmmAArrrroowwBBuuttttoonnGGaaddggeett((33XX))  RReeffeerreennccee PPaaggeess  XXmmAArrrroowwBBuuttttoonnGGaaddggeett((33XX))



     NNAAMMEE
          XXmmAArrrroowwBBuuttttoonnGGaaddggeett-The ArrowButtonGadget widget class

     AAEESS SSUUPPPPOORRTT LLEEVVEELL
          Full-use

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//AArrrroowwBBGG..hh>>


     DDEESSCCRRIIPPTTIIOONN
          ArrowButtonGadget consists of a directional arrow surrounded
          by a border shadow.  When it is selected, the shadow changes
          to give the appearance that the ArrowButtonGadget has been
          pressed in.  When it is unselected, the shadow reverts to
          give the appearance that the button is released, or out.

        CCllaasssseess
          ArrowButtonGadget inherits behavior and resources from
          OObbjjeecctt, RReeccttOObbjj, and XXmmGGaaddggeett classes.

          The class pointer is xxmmAArrrroowwBBuuttttoonnGGaaddggeettCCllaassss.

          The class name is XXmmAArrrroowwBBuuttttoonnGGaaddggeett.

        NNeeww RReessoouurrcceess
          The following table defines a set of widget resources used
          by the programmer to specify data.  The programmer can also
          set the resource values for the inherited classes to set
          attributes for this widget.  To reference a resource by name
          or by class in a .Xdefaults file, remove the 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).

                             AArrrroowwBBuuttttoonnGGaaddggeett 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
     ______________________________________________________________________________
     XmNactivateCallback   XmCCallback         XtCallbackList   NULL         C
     XmNarmCallback        XmCCallback         XtCallbackList   NULL         C
     XmNarrowDirection     XmCArrowDirection   unsigned char    XmARROW_UP   CSG
     XmNdisarmCallback     XmCCallback         XtCallbackList   NULL         C
     XmNmultiClick         XmCMultiClick       unsigned char    dynamic      CSG







     2-135                                            (printed 5/7/92)






     XXmmAArrrroowwBBuuttttoonnGGaaddggeett((33XX))  RReeffeerreennccee PPaaggeess  XXmmAArrrroowwBBuuttttoonnGGaaddggeett((33XX))



          XXmmNNaaccttiivvaatteeCCaallllbbaacckk
                    Specifies a list of callbacks that is called when
                    the ArrowButtonGadget is activated.  To activate
                    the button, press and release BBSSeelleecctt while the
                    pointer is inside the ArrowButtonGadget.
                    Activating the ArrowButtonGadget also disarms it.
                    The reason sent by this callback is XXmmCCRR__AACCTTIIVVAATTEE.

          XXmmNNaarrmmCCaallllbbaacckk
                    Specifies a list of callbacks that is called when
                    the ArrowButtonGadget is armed.  To arm this
                    widget, press BBSSeelleecctt while the pointer is inside
                    the ArrowButtonGadget.  The reason sent by this
                    callback is XXmmCCRR__AARRMM.

          XXmmNNaarrrroowwDDiirreeccttiioonn
                    Sets the arrow direction.  The values for this
                    resource are:


                      +o  XXmmAARRRROOWW__UUPP.

                      +o  XXmmAARRRROOWW__DDOOWWNN.

                      +o  XXmmAARRRROOWW__LLEEFFTT.

                      +o  XXmmAARRRROOWW__RRIIGGHHTT.


          XXmmNNddiissaarrmmCCaallllbbaacckk
                    Specifies a list of callbacks that is called when
                    the ArrowButtonGadget is disarmed.  To disarm this
                    widget, press and release BBSSeelleecctt while the
                    pointer is inside the ArrowButtonGadget.  The
                    reason sent by this callback is XXmmCCRR__DDIISSAARRMM.

          XXmmNNmmuullttiiCClliicckk
                    If a button click is followed by another button
                    click within the time span specified by the
                    display's multi-click time, and this resource is
                    set to XXmmMMUULLTTIICCLLIICCKK__DDIISSCCAARRDD, do not process the
                    second click.  If this resource is set to
                    XXmmMMUULLTTIICCLLIICCKK__KKEEEEPP, process the event and increment
                    _c_l_i_c_k__c_o_u_n_t in the callback structure.  When the
                    ArrowButtonGadget is not in a menu, the default
                    value is XXmmMMUULLTTIICCLLIICCKK__KKEEEEPP.









     2-136                                            (printed 5/7/92)






     XXmmAArrrroowwBBuuttttoonnGGaaddggeett((33XX))  RReeffeerreennccee PPaaggeess  XXmmAArrrroowwBBuuttttoonnGGaaddggeett((33XX))



        IInnhheerriitteedd RReessoouurrcceess
          ArrowButtonGadget 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mGGaaddggeett 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
     ___________________________________________________________________________________
     XmNhelpCallback         XmCCallback             XtCallbackList     NULL      C
     XmNhighlightOnEnter     XmCHighlightOnEnter     Boolean            False     CSG
     XmNhighlightThickness   XmCHighlightThickness   Dimension          2         CSG
     XmNnavigationType       XmCNavigationType       XmNavigationType   XmNONE    CSG
     XmNshadowThickness      XmCShadowThickness      Dimension          2         CSG
     XmNtraversalOn          XmCTraversalOn          Boolean            True      CSG
     XmNuserData             XmCUserData             XtPointer          NULL      CSG

                              RReeccttOObbjj 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
      ____________________________________________________________________
      XmNancestorSensitive   XmCSensitive     Boolean     dynamic   G
      XmNborderWidth         XmCBorderWidth   Dimension   0         CSG
      XmNheight              XmCHeight        Dimension   dynamic   CSG
      XmNsensitive           XmCSensitive     Boolean     True      CSG
      XmNwidth               XmCWidth         Dimension   dynamic   CSG
      XmNx                   XmCPosition      Position    0         CSG
      XmNy                   XmCPosition      Position    0         CSG

                              OObbjjeecctt 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
      ____________________________________________________________________
      XmNdestroyCallback   XmCCallback   XtCallbackList   NULL      C

        CCaallllbbaacckk IInnffoorrmmaattiioonn
          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;;
            iinntt      _c_l_i_c_k__c_o_u_n_t;;
          }} XXmmAArrrroowwBBuuttttoonnC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.

          _c_l_i_c_k__c_o_u_n_t
                 This value is valid only when the reason is
                 XXmmCCRR__AACCTTIIVVAATTEE.  It contains the number of clicks in
                 the last multiclick sequence if the XXmmNNmmuullttiiCClliicckk



     2-137                                            (printed 5/7/92)






     XXmmAArrrroowwBBuuttttoonnGGaaddggeett((33XX))  RReeffeerreennccee PPaaggeess  XXmmAArrrroowwBBuuttttoonnGGaaddggeett((33XX))



                 resource is set to XXmmMMUULLTTIICCLLIICCKK__KKEEEEPP, otherwise it
                 contains 11.  The activate callback is invoked for
                 each click if XXmmNNmmuullttiiCClliicckk is set to
                 XXmmMMUULLTTIICCLLIICCKK__KKEEEEPP.


     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          OObbjjeecctt((33XX)), RReeccttOObbjj((33XX)), 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((33XX)), and
          XXmmGGaaddggeett((33XX)).














































     2-138                                            (printed 5/7/92)






     XXmmBBuulllleettiinnBBooaarrdd((33XX))      RReeffeerreennccee PPaaggeess      XXmmBBuulllleettiinnBBooaarrdd((33XX))



     NNAAMMEE
          XXmmBBuulllleettiinnBBooaarrdd-The BulletinBoard widget class

     AAEESS SSUUPPPPOORRTT LLEEVVEELL
          Full-use

     HHIISSTTOORRYY//DDIIRREECCTTIIOONN
          The XXmmNNtteexxttTTrraannssllaattiioonnss resource is scheduled for removal in
          revision D.

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//BBuulllleettiinnBB..hh>>


     DDEESSCCRRIIPPTTIIOONN
          BulletinBoard is a composite widget that provides simple
          geometry management for children widgets.  It does not force
          positioning on its children, but can be set to reject
          geometry requests that result in overlapping children.
          BulletinBoard is the base widget for most dialog widgets and
          is also used as a general container widget.

          Modal and modeless dialogs are implemented as collections of
          widgets that include a DialogShell, a BulletinBoard (or
          subclass) child of the shell, and various dialog components
          (buttons, labels, etc.) that are children of BulletinBoard.
          BulletinBoard defines callbacks useful for dialogs (focus,
          map, unmap), which are available for application use.  If
          its parent is a DialogShell, BulletinBoard passes title and
          input mode (based on dialog style) information to the
          parent, which is responsible for appropriate communication
          with the window manager.

        CCllaasssseess
          BulletinBoard inherits behavior and resources from CCoorree,
          CCoommppoossiittee, CCoonnssttrraaiinntt, and XXmmMMaannaaggeerr classes.

          The class pointer is xxmmBBuulllleettiinnBBooaarrddWWiiddggeettCCllaassss.

          The class name is XXmmBBuulllleettiinnBBooaarrdd.

        NNeeww RReessoouurrcceess
          The following table defines a set of widget resources used
          by the programmer to specify data.  The programmer can also
          set the resource values for the inherited classes to set
          attributes for this widget.  To reference a resource by name
          or by class in a .Xdefaults file, remove the 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



     2-139                                            (printed 5/7/92)






     XXmmBBuulllleettiinnBBooaarrdd((33XX))      RReeffeerreennccee PPaaggeess      XXmmBBuulllleettiinnBBooaarrdd((33XX))



          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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          True           CG
     XmNbuttonFontList     XmCButtonFontList    XmFontList       dynamic        CSG
     XmNcancelButton       XmCWidget            Widget           NULL           SG
     XmNdefaultButton      XmCWidget            Widget           NULL           SG
     XmNdefaultPosition    XmCDefaultPosition   Boolean          True           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_ANY   CSG
     XmNshadowType         XmCShadowType        unsigned char    XmSHADOW_OUT   CSG
     XmNtextFontList       XmCTextFontList      XmFontList       dynamic        CSG
     XmNtextTranslations   XmCTranslations      XtTranslations   NULL           C
     XmNunmapCallback      XmCCallback          XtCallbackList   NULL           C


          XXmmNNaalllloowwOOvveerrllaapp
                    Controls the policy for overlapping children
                    widgets.  If True, BulletinBoard allows geometry
                    requests that result in overlapping children.

          XXmmNNaauuttooUUnnmmaannaaggee
                    Controls whether or not BulletinBoard is
                    automatically unmanaged after a button is
                    activated.  If this resource is True on
                    initialization and if the BulletinBoard's parent
                    is a DialogShell, BulletinBoard adds a callback to
                    button children (PushButtons, PushButtonGadgets,
                    and DrawnButtons) that unmanages the BulletinBoard
                    when a button is activated.  If this resource is
                    False on initialization or if the BulletinBoard's
                    parent is not a DialogShell, the BulletinBoard is
                    not automatically unmanaged.  For BulletinBoard
                    subclasses with Apply or Help buttons, activating
                    those buttons does not automatically unmanage the
                    BulletinBoard.

          XXmmNNbbuuttttoonnFFoonnttLLiisstt
                    Specifies the font list used for BulletinBoard's
                    button descendants.  If this value is NULL at



     2-140                                            (printed 5/7/92)






     XXmmBBuulllleettiinnBBooaarrdd((33XX))      RReeffeerreennccee PPaaggeess      XXmmBBuulllleettiinnBBooaarrdd((33XX))



                    initialization, the font list is initialized by
                    looking up the parent hierarchy of the widget for
                    an ancestor that is a subclass of the
                    XmBulletinBoard, VendorShell, or XmMenuShell
                    widget class.  If such an ancestor is found, the
                    font list is initialized to the XXmmNNbbuuttttoonnFFoonnttLLiisstt
                    of the ancestor widget.  If no such ancestor is
                    found, the default is implementation dependent.
                    Refer to XXmmFFoonnttLLiisstt((33XX)) for more information on
                    the creation and structure of a font list.

          XXmmNNccaanncceellBBuuttttoonn
                    Specifies the widget ID of the CCaanncceell button.
                    BulletinBoard's subclasses, which define a CCaanncceell
                    button, set this resource.  BulletinBoard does not
                    directly provide any behavior for that button.

          XXmmNNddeeffaauullttBBuuttttoonn
                    Specifies the widget ID of the default button.
                    Some BulletinBoard subclasses, which define a
                    default button, set this resource.  BulletinBoard
                    defines translations and installs accelerators
                    that activate that button when KKAAccttiivvaattee is
                    pressed and the keyboard focus is not in another
                    button.

          XXmmNNddeeffaauullttPPoossiittiioonn
                    Controls whether or not the BulletinBoard is
                    automatically positioned by its parent.  If True,
                    and the parent of the BulletinBoard is a
                    DialogShell, the BulletinBoard is centered within
                    or around the parent of the DialogShell when the
                    BulletinBoard is mapped and managed.  If False,
                    the BulletinBoard is not automatically positioned.

          XXmmNNddiiaallooggSSttyyllee
                    Indicates the dialog style associated with the
                    BulletinBoard.  If the parent of the BulletinBoard
                    is a DialogShell, the parent's XXmmNNmmwwmmIInnppuuttMMooddee is
                    set according to the value of this resource.  This
                    resource can be set only if the BulletinBoard is
                    unmanaged.  Possible values for this resource
                    include the following:


                      +o  XXmmDDIIAALLOOGG__SSYYSSTTEEMM__MMOODDAALL-used for dialogs that
                         must be responded to before any other
                         interaction in any application

                      +o  XXmmDDIIAALLOOGG__PPRRIIMMAARRYY__AAPPPPLLIICCAATTIIOONN__MMOODDAALL-used for
                         dialogs that must be responded to before some
                         other interactions in ancestors of the widget



     2-141                                            (printed 5/7/92)






     XXmmBBuulllleettiinnBBooaarrdd((33XX))      RReeffeerreennccee PPaaggeess      XXmmBBuulllleettiinnBBooaarrdd((33XX))



                      +o  XXmmDDIIAALLOOGG__AAPPPPLLIICCAATTIIOONN__MMOODDAALL-used for dialogs
                         that must be responded to before some other
                         interactions in ancestors of the widget.
                         This value is the same as
                         XXmmDDIIAALLOOGG__PPRRIIMMAARRYY__AAPPPPLLIICCAATTIIOONN__MMOODDAALL, and
                         remains for compatibility.

                      +o  XXmmDDIIAALLOOGG__FFUULLLL__AAPPPPLLIICCAATTIIOONN__MMOODDAALL-used for
                         dialogs that must be responded to before some
                         other interactions in the same application

                      +o  XXmmDDIIAALLOOGG__MMOODDEELLEESSSS-used for dialogs that do
                         not interrupt interaction of any application.
                         This is the default when the parent of the
                         BulletinBoard is a DialogShell.

                      +o  XXmmDDIIAALLOOGG__WWOORRKK__AARREEAA-used for BulletinBoard
                         widgets whose parents are not DialogShells.
                         XXmmNNddiiaallooggSSttyyllee is forced to have this value
                         when the parent of the BulletinBoard is not a
                         DialogShell.


          XXmmNNddiiaallooggTTiittllee
                    Specifies the dialog title.  If this resource is
                    not NULL, and the parent of the BulletinBoard is a
                    subclass of WMShell, BulletinBoard sets the
                    XXmmNNttiittllee and XXmmNNttiittlleeEEnnccooddiinngg of its parent.  If
                    the only character set in XXmmNNddiiaallooggTTiittllee is
                    ISO8859-1, XXmmNNttiittllee is set to the string of the
                    title, and XXmmNNttiittlleeEEnnccooddiinngg is set to SSTTRRIINNGG.  If
                    XXmmNNddiiaallooggTTiittllee contains character sets other than
                    ISO8859-1, XXmmNNttiittllee is set to the string of the
                    title converted to a compound text string, and
                    XXmmNNttiittlleeEEnnccooddiinngg is set to CCOOMMPPOOUUNNDD__TTEEXXTT.

          XXmmNNffooccuussCCaallllbbaacckk
                    Specifies the list of callbacks that is called
                    when the BulletinBoard widget or one of its
                    descendants accepts the input focus.  The callback
                    reason is XXmmCCRR__FFOOCCUUSS.














     2-142                                            (printed 5/7/92)






     XXmmBBuulllleettiinnBBooaarrdd((33XX))      RReeffeerreennccee PPaaggeess      XXmmBBuulllleettiinnBBooaarrdd((33XX))



          XXmmNNllaabbeellFFoonnttLLiisstt
                    Specifies the font list used for BulletinBoard's
                    label descendants (Labels and LabelGadgets).  If
                    this value is NULL at initialization, the font
                    list is initialized by looking up the parent
                    hierarchy of the widget for an ancestor that is a
                    subclass of the XmBulletinBoard, VendorShell, or
                    XmMenuShell widget class.  If such an ancestor is
                    found, the font list is initialized to the
                    XXmmNNllaabbeellFFoonnttLLiisstt of the ancestor widget.  If no
                    such ancestor is found, the default is
                    implementation dependent.  Refer to XXmmFFoonnttLLiisstt((33XX))
                    for more information on the creation and structure
                    of a font list.

          XXmmNNmmaappCCaallllbbaacckk
                    Specifies the list of callbacks that is called
                    only when the parent of the BulletinBoard is a
                    DialogShell; in which case, this callback list is
                    invoked when the BulletinBoard widget is mapped.
                    The callback reason is XXmmCCRR__MMAAPP.  DialogShells are
                    usually mapped when the DialogShell is managed.

          XXmmNNmmaarrggiinnHHeeiigghhtt
                    Specifies the minimum spacing in pixels between
                    the top or bottom edge of BulletinBoard and any
                    child widget.

          XXmmNNmmaarrggiinnWWiiddtthh
                    Specifies the minimum spacing in pixels between
                    the left or right edge of BulletinBoard and any
                    child widget.

          XXmmNNnnooRReessiizzee
                    Controls whether or not resize controls are
                    included in the window manager frame around the
                    BulletinBoard's parent.  If set to True, the mmwwmm
                    does not include resize controls in the window
                    manager frame containing the parent of the
                    BulletinBoard if the parent is a subclass of
                    VendorShell.  If set to False, the window manager
                    frame does include resize controls.  Other
                    controls provided by mmwwmm can be included or
                    excluded through the mmwwmm resources provided by
                    VendorShell.










     2-143                                            (printed 5/7/92)






     XXmmBBuulllleettiinnBBooaarrdd((33XX))      RReeffeerreennccee PPaaggeess      XXmmBBuulllleettiinnBBooaarrdd((33XX))



          XXmmNNrreessiizzeePPoolliiccyy
                    Controls the policy for resizing BulletinBoard
                    widgets.  Possible values include the following:


                      +o  XXmmRREESSIIZZEE__NNOONNEE-fixed size

                      +o  XXmmRREESSIIZZEE__AANNYY-shrink or grow as needed

                      +o  XXmmRREESSIIZZEE__GGRROOWW-grow only


          XXmmNNsshhaaddoowwTTyyppee
                    Describes the shadow drawing style for
                    BulletinBoard.  This resource can have the
                    following values:


                      +o  XXmmSSHHAADDOOWW__IINN-draws the BulletinBoard shadow so
                         that it appears inset.  This means that the
                         bottom shadow visuals and top shadow visuals
                         are reversed.

                      +o  XXmmSSHHAADDOOWW__OOUUTT-draws the BulletinBoard shadow
                         so that it appears outset

                      +o  XXmmSSHHAADDOOWW__EETTCCHHEEDD__IINN-draws the BulletinBoard
                         shadow using a double line giving the effect
                         of a line etched into the window, similar to
                         the Separator widget

                      +o  XXmmSSHHAADDOOWW__EETTCCHHEEDD__OOUUTT-draws the BulletinBoard
                         shadow using a double line giving the effect
                         of a line coming out of the window, similar
                         to the Separator widget




















     2-144                                            (printed 5/7/92)






     XXmmBBuulllleettiinnBBooaarrdd((33XX))      RReeffeerreennccee PPaaggeess      XXmmBBuulllleettiinnBBooaarrdd((33XX))



          XXmmNNtteexxttFFoonnttLLiisstt
                    Specifies the font list used for BulletinBoard's
                    Text and List descendants.  If this value is NULL
                    at initialization, the font list is initialized by
                    looking up the parent hierarchy of the widget for
                    an ancestor that is a subclass of the
                    XmBulletinBoard or VendorShell widget class.  If
                    such an ancestor is found, the font list is
                    initialized to the XXmmNNtteexxttFFoonnttLLiisstt of the ancestor
                    widget.  If no such ancestor is found, the default
                    is implementation  dependent.  Refer to
                    XXmmFFoonnttLLiisstt((33XX)) for more information on the
                    creation and structure of a font list.

          XXmmNNtteexxttTTrraannssllaattiioonnss
                    This resource is scheduled for removal in revision
                    D.  Adds translations to any Text widget or Text
                    widget subclass that is added as a child of
                    BulletinBoard.

          XXmmNNuunnmmaappCCaallllbbaacckk
                    Specifies the list of callbacks that is called
                    only when the parent of the BulletinBoard is a
                    DialogShell.  In that case, this callback list is
                    invoked when the BulletinBoard widget is unmapped.
                    The callback reason is XXmmCCRR__UUNNMMAAPP.  DialogShells
                    are usually unmapped when the DialogShell is
                    unmanaged.


        IInnhheerriitteedd RReessoouurrcceess
          BulletinBoard 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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
     XmNnavigationType       XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
     XmNshadowThickness      XmCShadowThickness      Dimension           dynamic                CSG
     XmNstringDirection      XmCStringDirection      XmStringDirection   dynamic                CG
     XmNtopShadowColor       XmCTopShadowColor       Pixel               dynamic                CSG







     2-145                                            (printed 5/7/92)






     XXmmBBuulllleettiinnBBooaarrdd((33XX))      RReeffeerreennccee PPaaggeess      XXmmBBuulllleettiinnBBooaarrdd((33XX))



     XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap              dynamic                CSG
     XmNtraversalOn          XmCTraversalOn          Boolean             True                   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

        CCaallllbbaacckk IInnffoorrmmaattiioonn
          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;;
          }} XXmmAAnnyyC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.


     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          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)),



     2-146                                            (printed 5/7/92)






     XXmmBBuulllleettiinnBBooaarrdd((33XX))      RReeffeerreennccee PPaaggeess      XXmmBBuulllleettiinnBBooaarrdd((33XX))



          XXmmCCrreeaatteeBBuulllleettiinnBBooaarrdd((33XX)), 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((33XX)),
          XXmmDDiiaallooggSShheellll((33XX)),, and XXmmMMaannaaggeerr((33XX))..





















































     2-147                                            (printed 5/7/92)



 Z
