wx:button%

Superclass: wx:item%

A button is a panel item that contains a text string or bitmap, and is one of the commonest elements of a GUI. It may be placed on a wx:panel% object or a wx:dialog-box% object.

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

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

  Creates a button with a text or bitmap 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.

  If func is not null, it is used as the callback for the button when the button is pressed.

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

  The style argument is reserved for future use.

  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:

• set-default
• set-label

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-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-default
• set-focus from wx:window%
• set-label
• set-label-colour from wx:item%
• set-size from wx:window%
• show from wx:window%