wx:radio-box%

Superclass: wx:item%

A wx:radio-box% item is used to select one of number of mutually exclusive choices. It is displayed as a vertical column or horizontal row of labelled radio buttons.

Whenever the selected radio button of a radio box is changed by the user, the radio box's callback procedure is invoked. (The callback procedure is provided as an initialization argument when the radio box is created.)

• (make-object wx:radio-box% parent func label x y width height choices major-dim style name) -> wx:radio-box% object
      parent : wx:panel% object
      func : null or procedure of two arguments: a wx:radio-box% 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 or wx:bitmap% objects
      major-dim = 0 : small integer
      style = wx:const-vertical : small integer
      name = "radioBox" : string

  Creates a radio button set with text or bitmap labels. The choices list specifies the radio button labels.

  For each string in choices, ampersands (``&'') are stripped from the string. A double ampersand is converted to a single ampersand (that is not stripped). If choices is a list of bitmaps, then the bitmaps must be valid and not selected into a wx:memory-dc% object.

  If func is not null, it is used as the callback for the radio box when the selected radio button is changed.

  If label is not null, it will be used to label the radio box, otherwise no label is used. 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 radio box within the panel; if -1 is provided, a default position will be assigned such that the radio box 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 radio box based on the number and labels of the radio buttons.

  The style argument can be wx:const-vertical for a collection of radio buttons vertically arranged, or wx:const-horizontal for a horizontal arrangement.

  The major-dim specifies the number of rows (if style is wx:const-vertical) or columns (if style is wx:const-horizontal) for a two-dimensional radiobox. If major-dim is 0, each buttons is put in a separate row or column.

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

  
  

Methods:

• enable
• find-string
• get-selection
• get-string
• get-string-selection
• number
• set-selection
• set-string-selection
• show

All methods:

• center from wx:window%
• centre from wx:window%
• client-to-screen from wx:window%
• command from wx:item%
• enable
• 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