wx:choice%

Superclass: wx:item%

A choice item is used to select one string from a pop-up list of strings. Unlike a list box, only the selection is visible until the user pops-up the menu of choices.

Whenever the selection of a choice item is changed by the user, the choice item's callback procedure is invoked. (The callback procedure is provided as an initialization argument when the choice item is created.)

See also wx:list-box%.

• (make-object wx:choice% parent func label x y width height choices style name) -> wx:choice% object
      parent : wx:panel% object
      func : null or procedure of two arguments: a wx:choice% object and a wx:command-event% object
      label : string or null
      x = -1 : small integer
      y = -1 : small integer
      width = -1 : small integer
      height = -1 : small integer
      choices = null : list of strings
      style = 0 : small integer
      name = "choice" : string

  Creates a choice item.

  If func is not null, it is used as a callback when the choice item is changed by the user.

  If label is non-NULL, it is used as the label for the choice item. The label string can mark a character of the label as the Windows shortcut by preceding the key with an ampersand (``&''). Ampersands are stripped from label before it is used as a label. Double ampersands are converted to a single (unstripped) ampersand.

  The parameters x and y are used to specify an absolute position for the choice item within the panel; if -1 is provided, a default position will be assigned such that the choice item is placed next to the last item inserted into the panel. If width or height is -1, an appropriate size will be used for the choice item based on the longest choice string.

  The choices list specifies the list of possible values for the choice item.

  For each string in choices, ampersands (``&'') are stripped from the string. A double ampersand is converted to a single ampersand (that is not stripped).

  The style argument is reserved for future use.

  The name argument is used to associate a name with the choice item, allowing the application user to set X Windows resource values for each individual choice item.

  
  

Methods:

• append
• clear
• find-string
• get-selection
• get-string
• get-string-selection
• number
• set-selection
• set-string-selection

All methods:

• append
• center from wx:window%
• centre from wx:window%
• clear
• client-to-screen from wx:window%
• command from wx:item%
• enable from wx:window%
• find-string
• get-background-colour from wx:item%
• get-button-colour from wx:item%
• get-char-height from wx:window%
• get-char-width from wx:window%
• get-client-size from wx:window%
• get-grand-parent from wx:window%
• get-height from wx:window%
• get-label from wx:item%
• get-label-colour from wx:item%
• get-name from wx:window%
• get-parent from wx:window%
• get-position from wx:window%
• get-selection
• get-size from wx:window%
• get-string
• get-string-selection
• get-text-extent from wx:window%
• get-width from wx:window%
• get-x from wx:window%
• get-y from wx:window%
• is-shown? from wx:window%
• move from wx:window%
• number
• on-kill-focus from wx:window%
• on-set-focus from wx:window%
• on-size from wx:window%
• pre-on-char from wx:window%
• pre-on-event from wx:window%
• refresh from wx:window%
• screen-to-client from wx:window%
• set-background-colour from wx:item%
• set-button-colour from wx:item%
• set-cursor from wx:window%
• set-focus from wx:window%
• set-label from wx:item%
• set-label-colour from wx:item%
• set-selection
• set-size from wx:window%
• set-string-selection
• show from wx:window%