check-box%

A check box is a labelled box which is either checked or unchecked.

Whenever a check box is clicked by the user, the check box's value is toggled and its callback procedure is invoked. A callback procedure is provided as an initialization argument when each check box is created.

• (make-object check-box% label parent callback style) -> check-box% object
      label : string or bitmap% object
      parent : frame%, dialog%, panel%, or pane% object
      callback : procedure of two arguments: a check-box% object and a control-event% object
      style = null : an empty list of symbols

  Creates a check box with a string or bitmap label. If label is a bitmap, then the bitmap must be valid (see ok? in bitmap%) and not installed in a bitmap-dc% object; otherwise, an exn:application:mismatch exception is raised.

  If an ampersand (``&'') occurs in label (when label is a string), it is specially parsed; under Windows and X, the character following an ampersand is underlined in the displayed control to indicate a keyboard mnemonic. (Under MacOS, mnemonic underlines are not shown.) The underlined menumonic character must be a letter or a digit. The user can effectively click the check box by typing the mnemonic when the control's top-level-window contains the keyboard focus. The user must also hold down the Meta or Alt key if the keyboard focus is currently in a control that handles normal alphanumeric input. The ampersand itself is removed from label before it is displayed for the control; a double-ampersand in label is converted to a single ampersand (with no mnemonic underlining). Menumonic keyboard events are handled by on-traverse-char (but not under MacOS).

  The callback procedure is called (with the event type 'check) whenever the user clicks the check box.

  The style argument is provided for future extensions. Currently, style must be the empty list.

  
  

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

• accept-drop-files from window<%>
• client->screen from window<%>
• command from control<%>
• enable from window<%>
• focus from window<%>
• get-client-size from window<%>
• get-cursor from window<%>
• get-graphical-min-size from area<%>
• get-height from window<%>
• get-label from window<%>
• get-parent from area<%>
• get-plain-label from window<%>
• get-size from window<%>
• get-top-level-window from area<%>
• get-value from check-box%
• get-width from window<%>
• get-x from window<%>
• get-y from window<%>
• has-focus? from window<%>
• horiz-margin from subarea<%>
• is-enabled? from window<%>
• is-shown? from window<%>
• min-height from area<%>
• min-width from area<%>
• on-drop-file from window<%>
• on-focus from window<%>
• on-move from window<%>
• on-size from window<%>
• on-subwindow-char from window<%>
• on-subwindow-event from window<%>
• refresh from window<%>
• screen->client from window<%>
• set-cursor from window<%>
• set-label from check-box%
  overrides set-label from window<%>
• set-value from check-box%
• show from window<%>
• stretchable-height from area<%>
• stretchable-width from area<%>
• vert-margin from subarea<%>