combobox.man

Wxpython Implemented on Windows CE, Source code

              applications.  This resource and the inherent prob-
              lems are due to the focus policy of the window man-
              ager  you're  using. See the further details in the
              later sections.





Version 1.31              20 March 1995                         8





XmComboBox(3Xm)        Harry's Motif Tools        XmComboBox(3Xm)


       XXmmNNsseelleeccttiioonnCCaallllbbaacckk
              Specifies a list of callbacks that is  called  when
              an    item    is    selected.     The   reason   is
              XXmmCCRR__SSIINNGGLLEE__SSEELLEECCTT.  The callbacks are  NOT  called
              when  the  user  browses  through  the items in the
              list.

       XXmmNNsseelleeccttiioonnPPoolliiccyy
              This resource controls whether the user  can  dese-
              lect  the  currently  selected  item within a combo
              box.  The  default  value  is  XXmmBBRROOWWSSEE__SSEELLEECCTT,  so
              always  one  item gets selected if the combo box is
              editable. In the case of XXmmSSIINNGGLLEE__SSEELLEECCTT  the  user
              may deselect the current item either by clicking on
              it in the  drop  down  list  or  pressing  the  key
              "Delete".  Other  values for XXmmNNsseelleeccttiioonnPPoolliiccyy are
              currently not allowed. (Multiple selections will be
              probably availabe with the next release.)

       XXmmNNsseelleeccttTThhrreesshhoolldd
              Specifies  the amount of pixels the mouse must move
              until the selection of text is recognized in  click
              and drag mode.

       XXmmNNsshhoowwLLaabbeell
              Specifies,  whether  a  label  containing text or a
              pixmap should be displayed on the left side of  the
              combo box. This resource can only be specified dur-
              ing the creation of the combo  box,  afterwards  it
              will have no effect.

       XXmmNNssoorrtteedd
              Specifies  whether the items in the list are sorted
              or not In an unsorted list, the items are shown  in
              the  order in which they're put into the list. When
              adding an item to a sorted list, this item will  be
              put at the right place (alphabetically sorted).

       XXmmNNssoorrttiinnggCCaallllbbaacckk
              Contains  a  list of callbacks that is called when-
              ever a new item is added to the  combo  box  widget
              and  XXmmNNssoorrtteedd is TTrruuee.  The reason is XXmmCCRR__SSOORRTTIINNGG
              and the type of  the  structure  whose  address  is
              passed  to  the  callback is XXmmCCoommbbooBBooxxSSoorrttiinnggCCaallll--
              bbaacckk--SSttrruucctt.  For detailed information see the fol-
              lowing sections.

       XXmmNNssqquuaarreeAArrrrooww
              Controls  the  width of the arrow button in respect
              to its height. If this resource is TTrruuee  the  arrow
              button  is  always  layed out square. Otherwise the
              arrow button's width will be approximatly 4/5th  of
              its height.




Version 1.31              20 March 1995                         9





XmComboBox(3Xm)        Harry's Motif Tools        XmComboBox(3Xm)


       XXmmNNssttaattiiccLLiisstt
              Controls whether the list is always statically dis-
              played right below the text input area of the combo
              box  if  set  to TTrruuee.  If you use a combo box with
              XXmmNNssttaattiiccLLiisstt set to TTrruuee and  XXmmNNeeddiittaabbllee  set  to
              FFaallssee  you should consider using a simple list wid-
              get instead.

       XXmmNNssttrriinnggDDiirreeccttiioonn
              Specifies the initial direction to draw the  string
              (from  the  left  to  the  right or in the opposite
              direction). The whole story seems to  be  incompre-
              hensible... therefore this resource is provided for
              completeness only.

       XXmmNNttwwmmHHaannddlliinnggOOnn
              If  you  have  trouble  with  the  list  then  this
              resource may help you.  Set it to True, if the list
              gets hidden at the moment the mouse  cursor  enters
              the list.

       XXmmNNttooppIItteemmPPoossiittiioonn
              This  resource  is intended as an informal hint. It
              specifies the index of the item which is  displayed
              at the visible top of the list.

       XXmmNNvvaalluuee
              Contains  the  text  of  the input field. This also
              concerns combo  boxes  which  are  not  editable  (
              XXmmNNeeddiittaabbllee set to False).

       XXmmNNuunnsseelleeccttiioonnCCaallllbbaacckk
              Specifies  a list of callbacks that is called when-
              ever the currently selected item is deselected  and
              no other item gets selected. This callback is acti-
              vated  only  when  XXmmNNsseelleeccttiioonnPPoolliiccyy   is   XXmmSSIINN--
              GGLLEE__SSEELLEECCTT.  The reason is XXmmCCRR__UUNNSSEELLEECCTT.  The type
              of the structure whose address is  passed  to  this
              callback is XXmmAAnnyyCCaallllbbaacckkSSttrruucctt.

       XXmmNNvvaalluuee
              Contains  the  text  of  the input field. This also
              concerns combo  boxes  which  are  not  editable  (
              XXmmNNeeddiittaabbllee set to FFaallssee).

       XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk
              Specifies  a  list  of callbacks to be called after
              text is deleted from or inserted into the text area
              of   the   combo   box   widget.   The   reason  is
              XXmmCCRR__VVAALLUUEE__CCHHAANNGGEEDD.   The  type  of  the  structure
              whose  address is passed to this callback is XXmmAAnnyy--
              CCaallllbbaacckkSSttrruucctt.





Version 1.31              20 March 1995                        10





XmComboBox(3Xm)        Harry's Motif Tools        XmComboBox(3Xm)


       XXmmNNvviissiibblleeIItteemmCCoouunntt
              Specifies the number of items that can fit  in  the
              visible  space of the list. The combo box uses this
              value to determine the height of its list.

     IInnhheerriitteedd RReessoouurrcceess
       XmComboBox inherits behaviour and resources from the  fol-
       lowing  superclasses.  For  a complete description of each
       resource, refer to the man page for that superclass.

     CCaallllbbaacckk IInnffoorrmmaattiioonn
       A pointer to the following  structure  is  passed  to  the
       XXmmNNddrrooppDDoowwnnCCaallllbbaacckk callback:

       ttyyppeeddeeff ssttrruucctt {{
         iinntt            _r_e_a_s_o_n;;
         XXEEvveenntt         **_e_v_e_n_t;;
       }} XXmmCCoommbbooBBooxxDDrrooppDDoowwnnCCaallllbbaacckkSSttrruucctt;;

       _r_e_a_s_o_n         Within this structure, _r_e_a_s_o_n indicates the
                      reason why the callback was activated. This
                      can    be   XXmmCCRR__SSHHOOWW__LLIISSTT   as   well   as
                      XXmmCCRR__HHIIDDEE__LLIISSTT.  A callback is called  with
                      the  reason  XXmmCCRR__SSHHOOWW__LLIISSTT just before the
                      list is dropped down, whereas the  callback
                      is  called  with  XXmmCCRR__HHIIDDEE__LLIISSTT  after the
                      list is hidden.


       _e_v_e_n_t          Points to the XXEEvveenntt, which  triggered  the
                      callback.  May  be  NNUULLLL if the callback is
                      triggered by a call  to  XXmmCCoommbbooBBooxxSShhoowwLLiisstt
                      or XXmmCCoommbbooBBooxxHHiiddeeLLiisstt.

       A  pointer  to  the  following  structure is passed to the
       XXmmNNaaccttiivvaatteeCCaallllbbaacckk callback:

       ttyyppeeddeeff ssttrruucctt {{
         iinntt            _r_e_a_s_o_n;;
         XXEEvveenntt         **_e_v_e_n_t;;
       }} XXmmAAnnyyCCaallllbbaacckkSSttrruucctt;;

       _r_e_a_s_o_n         Indicates why  the  callback  was  invoked.
                      This  is XXmmCCRR__AACCTTIIVVAATTEE for XXmmNNaaccttiivvaatteeCCaallll--
                      bbaacckk.

       _e_v_e_n_t          Points to the XXEEvveenntt, which  triggered  the
                      callback.

       A  pointer  to  the  following  structure is passed to the
       XXmmNNsseelleeccttiioonnCCaallllbbaacckk and XXmmNNddeeffaauullttAAccttiioonnCCaallllbbaacckk:

       ttyyppeeddeeff ssttrruucctt {{
         iinntt            _r_e_a_s_o_n;;



Version 1.31              20 March 1995                        11





XmComboBox(3Xm)        Harry's Motif Tools        XmComboBox(3Xm)


         XXEEvveenntt         **_e_v_e_n_t;;
         XXmmSSttrriinngg       _v_a_l_u_e;;
         iinntt            _i_n_d_e_x;;
       }} XXmmCCoommbbooBBooxxSSeelleeccttiioonnCCaallllbbaacckkSSttrruucctt,,  XXmmCCoommbbooBBooxxDDeeffaauullttAAcc--
       ttiioonnCCaallllbbaacckkSSttrruucctt;;

       _r_e_a_s_o_n         Within this structure, _r_e_a_s_o_n indicates the
                      reason why the callback was  activated.  At
                      this   time,   the  reason  can  be  either
                      XXmmCCRR__SSIINNGGLLEE__SSEELLEECCTT or XXmmCCRR__BBRROOWWSSEE__SSEELLEECCTT
                      depending  on  the setting of XXmmNNsseelleeccttiioonn--
                      PPoolliiccyy.   It  indicates   that   the   user
                      selected  a  (potentially  new) item in the
                      list.  Whether this callback  is  activated
                      every  time  the user moves into a new item
                      of the list or only when the user  releases
                      the  mouse button is controlled through the
                      setting of XXmmNNaauuttoommaattiiccSSeelleeccttiioonn.

       _e_v_e_n_t          Points to the XXEEvveenntt, which  triggered  the
                      callback.

       _v_a_l_u_e          Points  to  a  XXmmSSttrriinngg, which contains the
                      text of the current  selected  item.   This
                      XXmmSSttrriinngg  must never be freed or changed by
                      the called program code!

       _i_n_d_e_x          Index (starting from 1)  of  the  currently
                      selected item in the list.

       A  pointer  to  the  following  structure is passed to the
       XXmmNNuunnsseelleeccttiioonnCCaallllbbaacckk callback:

       ttyyppeeddeeff ssttrruucctt {{
         iinntt            _r_e_a_s_o_n;;
         XXEEvveenntt         **_e_v_e_n_t;;
       }} XXmmCCoommbbooBBooxxUUnnsseelleeccttiioonnCCaallllbbaacckkSSttrruucctt;;

       _r_e_a_s_o_n         Indicates why  the  callback  was  invoked.
                      This is XXmmCCRR__UUNNSSEELLEECCTT.

       _e_v_e_n_t          Points  to  the XXEEvveenntt, which triggered the