wx:check-box%

Superclass: wx:item%

A checkbox is a labelled box which is either on (checkmark is visible) or off (no checkmark).

Whenever a checkbox is clicked by the user, the checkbox's callback procedure is invoked. (The callback procedure is provided as an initialization argument when the checkbox is created.)

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

  Creates a checkbox with a text or bitmap label, or without a label.

  If func is not null, it is called whenever the checkbox state is changed by the user.

  If label is not null, it is used as the label for the checkbox. If label is null, the checkbox is created without a label. 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. If label is a bitmap, then the bitmap must be valid and not selected into a wx:memory-dc% object.

  The parameters x and y are used to specify an absolute position for the checkbox within the panel; if -1 is provided, a default position will be assigned such that the checkbox 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 checkbox based on the checkbox label.

  The style argument is reserved for future use.

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

  
  

Methods:

• get-value
• set-label
• set-value

All methods:

• center from wx:window%
• centre from wx:window%
• client-to-screen from wx:window%
• command from wx:item%
• enable from wx:window%
• 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-size from wx:window%
• get-text-extent from wx:window%
• get-value
• get-width from wx:window%
• get-x from wx:window%
• get-y from wx:window%
• is-shown? from wx:window%
• move from wx:window%
• 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
• set-label-colour from wx:item%
• set-size from wx:window%
• set-value
• show from wx:window%