combobox.man

Wxpython Implemented on Windows CE, Source code

Version 1.31              20 March 1995                         4





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


              user  presses either the key "Enter" or "Activate".
              The type of the structure passed to  this  callback
              is    XXmmAAnnyyCCaallllbbaacckkSSttrruucctt   and   the   reason   is
              XXmmCCRR__AACCTTIIVVAATTEE.

       XXmmNNaalliiggnnmmeenntt
              The alignment (left to right) for the label's  text
              or    pixmap.    Possible   values   are   XXmmAALLIIGGNN--
              MMEENNTT__BBEEGGIINNNNIINNGG,  XXmmAALLIIGGNNMMEENNTT__CCEENNTTEERR,  and  XXmmAALLIIGGNN--
              MMEENNTT__EENNDD.

       XXmmNNaauuttoommaattiiccSSeelleeccttiioonn
              Indicates   whether   the  XXmmNNsseelleeccttiioonnCCaallllbbaacckk  is
              invoked each time the user moves into a new item if
              XXmmNNaauuttoommaattiiccSSeelleeccttiioonn  is  TTrruuee  and  the selection
              mode is XXmmBBRROOWWSSEE__SSEELLEECCTT.  If set to FFaallssee the XXmmNNss--
              eelleeccttiioonnCCaallllbbaacckk  is  not  invoked  until  the user
              releases the mouse button.

       XXmmNNaarrrroowwSSppaacciinnggOOnn
              Indicates whether a gap is  displayed  between  the
              arrow  button  and  the  text  input  field if this
              resource is set to TTrruuee and XXmmNNeeddiittaabbllee is also set
              to  TTrruuee.   If  this  resource  is set to FFaallssee the
              combo box widget will never display a  gab  between
              the arrow button and the text area, irrespective of
              the setting  of  XXmmNNeeddiittaabbllee.   Note  that  setting
              XXmmNNaarrrroowwSSppaacciinnggOOnn  to  FFaallssee  doesn  not conform to
              common GUI styles. And it prevents  the  user  from
              easily   recognizing   whether  the  combo  box  is
              editable or not.

       XXmmNNbblliinnkkRRaattee
              The time in milliseconds  that  the  cursor  spends
              being  visible  or invisible. A value of 0 prevents
              the cursor from blinking.

       XXmmNNbboorrddeerrWWiiddtthh
              That's no new resource but is already introduced in
              the  core  class.  This class overrides the default
              value and sets it to zero. You can however override
              it  again  if  you're  dissatisfied  with  the  new
              default setting.

       XXmmNNccoolluummnnss
              Specifies the initial width of the input field mea-
              sured   in  character  spaces.  The  default  value
              depends on the value of the width of the combo box.

       XXmmNNccuurrssoorrPPoossiittiioonn
              Indicates the position in the text where the insert
              cursor is to be located. Its position is the offset
              of  characters  and  it starts with offset 0 at the
              beginning of the text.



Version 1.31              20 March 1995                         5





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


       XXmmNNccuurrssoorrPPoossiittiioonnVViissiibbllee
              Flags whether the insert cursor position is  marked
              by a blinking cursor.

       XXmmNNddeeffaauullttAAccttiioonnCCaallllbbaacckk
              Specifies  a list of callbacks that is called every
              time an item  is  double  clicked.  The  reason  is
              XXmmCCRR__DDEEFFAAUULLTT__AACCTTIIOONN.    Please  remember  that  you
              can't use this callback if XXmmNNssttaattiiccLLiisstt  is  FFaallssee
              because  the  list  is  immediatly hidden after the
              user selected an item from the list. Thus the  user
              can't double click on any item within the list.

       XXmmNNddrrooppDDoowwnnCCaallllbbaacckk
              This  is  a list of callbacks to be called when the
              list is about to be shown or  hidden.  The  reasons
              are XXmmCCRR__SSHHOOWW__LLIISSTT or XXmmCCRR__HHIIDDEE__LLIISSTT.

       XXmmNNddrrooppDDoowwnnCCuurrssoorr
              Specifies  the cursor to be used whenever the mouse
              cursor is within the drop down list.

       XXmmNNddrrooppDDoowwnnOOffffsseett
              Specifies the distance between the left  border  of
              the  list  and  the left border of the input field.
              The default value is set to the width of the  arrow
              button.  Only  positive values are allowed for XXmmNN--
              ddrrooppDDoowwnnOOffffsseett, negative ones will be ignored.

       XXmmNNeeddiittaabbllee
              Specifies the type of combo box. If  set  to  True,
              the  combo  box  contains  an editable input field.
              Therefore, the user is free to select  entries  out
              of  the list and to enter new text or modify it. In
              the other case, with XmNeditable set to  False  the
              user can solely browse in and select entries out of
              the list.

       XXmmNNffoonnttLLiisstt
              Indicates the font list to be used  for  the  input
              field  and  the  list. If the value is NULL at ini-
              tialization, it is initialized by  looking  up  the
              parent hierarchy of the widget for an ancestor that
              is a subclass of XXmmBBuulllleettiinnBBooaarrdd, XXmmVVeennddoorrSShheellll  or
              XXmmMMeennuuSShheellll.   If  such  an ancestor is found, it's
              font list will be taken by the combo box widget.

       XXmmNNiitteemmCCoouunntt
              Specifies the total number of items in the list.

       XXmmNNiitteemmss
              Points to an array of compound strings representing
              the  items to be displayed in the list. By means of
              this a program can find out  what  items  the  list



Version 1.31              20 March 1995                         6





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


              contains.  It  is also possible to set the contents
              of the  list  box  in  one  step  by  setting  this
              resource to a new array of compound strings. Please
              remember:  always  set  XXmmNNiitteemmss  and  XXmmNNiitteemmCCoouunntt
              together   in  the  same  call  to  XXttSSeettVVaalluueess  or
              XXttVVaaSSeettVVaalluueess.  If you ignore this rule  the  combo
              box  will  ignore you and your attempt to set these
              resources.

       XXmmNNllaabbeellIInnsseennssiittiivveePPiixxmmaapp
              Specifies a pixmap used as the button face if  XXmmNN--
              llaabbeellTTyyppee is set to XXmmPPIIXXMMAAPP and the combo box wid-
              get is insensitive.

       XXmmNNllaabbeellPPiixxmmaapp
              Specifies a pixmap to be displayed to the  left  of
              the  input  field  if  XXmmNNllaabbeellTTyyppee is XXmmPPIIXXMMAAPP and
              XXmmNNsshhoowwLLaabbeell is True (of course).

       XXmmNNllaabbeellSSttrriinngg
              Specifies the the compound string to  be  displayed
              if XXmmNNllaabbeellTTyyppee is set to XXmmSSTTRRIINNGG and XXmmNNsshhoowwLLaabbeell
              is True.

       XXmmNNllaabbeellTTyyppee
              The type of label (either string or pixmap). Possi-
              ble values are XXmmPPIIXXMMAAPP and XXmmSSTTRRIINNGG.

       XXmmNNllaabbeellMMaarrggiinnTToopp,, XXmmNNllaabbeellMMaarrggiinnBBoottttoomm
       XXmmNNllaabbeellMMaarrggiinnLLeefftt,, XXmmNNllaabbeellMMaarrggiinnRRiigghhtt
              The  amount  of space between one side of the label
              and the nearest margin.

       XXmmNNllaabbeellMMaarrggiinnHHeeiigghhtt,, XXmmNNllaabbeellMMaarrggiinnWWiiddtthh
              The spacing between one side of the label  and  the
              nearest edge of a shadow.

       XXmmNNlliissttMMaarrggiinnHHeeiigghhtt,, XXmmNNlliissttMMaarrggiinnWWiiddtthh
              The  height or width of the margin between the bor-
              der of the list and the items in the list.

       XXmmNNlliissttSSiizzeePPoolliiccyy
              Controls the reaction of  the  list  when  an  item
              grows  horizontally beyond the current width of the
              list and XXmmNNssttaattiiccLLiisstt is set to TTrruuee.  If  set  to
              XXmmCCOONNSSTTAANNTT,  the list does not grow, and a horizon-
              tal scroll bar is shown. If this resource is set to
              XXmmVVAARRIIAABBLLEE, the list instead trys to grow such that
              it match the size of the longest item, thus no hor-
              izontal  scroll  bar  will  appear.   When XXmmNNlliisstt--
              SSiizzeePPoolliiccyy is the list will again try to  grow  but
              in  case  the width of the longest item in the list
              is wider than the viewing area of the list a  hori-
              zontal scroll bar appears.



Version 1.31              20 March 1995                         7





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


       XXmmNNlliissttSSppaacciinngg
              The spacing between items in the list.

       XXmmNNmmaarrggiinnHHeeiigghhtt
              Specifies the distance between the top and the bot-
              tom of the widget window and the text displayed  in
              the input field.

       XXmmNNmmaarrggiinnWWiiddtthh
              Like  XmNmarginHeight  this  resource specifies the
              distance between the left and the right  border  of
              the widget window and the text.

       XXmmNNmmaaxxLLeennggtthh
              Specifies  the  maximum  length  of the text string
              that can be entered  from  the  keyboard  into  the
              input  field of the combo box. Strings that are put
              into  the  input  field  using  XXmmCCoommbbooBBooxxSSeettSSttrriinngg
              ignore this resource.

       XXmmNNmmooddiiffyyVVeerriiffyyCCaallllbbaacckk
              Contains  a list of callbacks called before text is
              deleted from or inserted into the text area of  the
              combo  box widget. The callbacks are called only if
              XXmmNNeeddiittaabbllee  is  set  to  TTrruuee.   The   reason   is
              XXmmCCRR__MMOODDIIFFYYIINNGG__TTEEXXTT__VVAALLUUEE  and  the  type  of   the
              structure passed to this  callback  is  XXmmCCoommbbooBBooxx--
              TTeexxttVVeerriiffyyCCaallllbbaacckkSSttrruucctt.

       XXmmNNmmoottiioonnVVeerriiffyyCCaallllbbaacckk
              Specifies  the  list  of  callbacks  that is called
              before the insert  cursor  gets  moved  to  another
              position.  The  reason is XXmmCCRR__MMOOVVIINNGG__IINNSSEERRTT__CCUURRSSOORR
              and the type of  the  structure  whose  address  is
              passed to the callback is XXmmCCoommbbooBBooxxTTeexxttVVeerriiffyyCCaallll--
              bbaacckk--SSttrruucctt.

       XXmmNNssccrroollllBBaarrDDiissppllaayyPPoolliiccyy
              Controls the display of the vertical scroll bar  in
              the  list  when  XXmmNNssttaattiiccLLiisstt  is set to TTrruuee..When
              XXmmNNssccrroollllBBaarrDDiissppllaayyPPoolliiccyy is  set  to  XXmmAASS__NNEEEEDDEEDD,
              the  vertical scroll bar is displayed only when the
              list contains more items than can be currently dis-
              played.  If set to XXmmSSTTAATTIICC the vertical scroll bar
              is always displayed.

       XXmmNNppeerrssiisstteennttDDrrooppDDoowwnn
              Welcome to the sad  section  in  the  life  of  X11