NAME

Win32::GUI::Button - Create and manipulate button controls

DESCRIPTION

[TBD]

METHODS

Common methods apply to most windows, controls and resources.

new

new(PARENT, %OPTIONS)

Creates a new Button object; can also be called as PARENT->AddButton(%OPTIONS).

Class specific %OPTIONS are:

-align   => left/center/right (default left)
  specify horizontal text align.
-valign  => top/center/bottom
  specify vertical text align.
-default => 0/1 (default 0)
  Set/Unset default push button style. A default Button has a black
  border drawn around it.
-ok      => 0/1 (default 0)
  Set/Unset button id to ID_OK. If 1, the button will correspond to the OK
  action of a dialog, and its Click event will be fired by pressing the ENTER key.
-cancel  => 0/1 (default 0)
  Set/Unset button id to ID_CANCEL. If 1, the button will correspond to the CANCEL
  action of a dialog, and its Click event will be fired by pressing the ESC key.
-bitmap  => Win32::GUI::Bitmap object
  Create a bitmap button.
-picture => see -bitmap
-icon    => Win32::GUI::Icon object
  Create a icon button.
-3state  => 0/1 (default 0)
  Set/Unset 3 state style.
-flat  => 0/1 (default 0)
  Set/Unset flat style.
-multiline  => 0/1 (default 0)
  Set/Unset multiline style.
-notify  => 0/1 (default 0)
  Set/Unset notify style.
-pushlike  => 0/1 (default 0)
  Set/Unset pushlike style.
-rightbutton  => 0/1 (default 0)
  Set/Unset rightbutton style.

See also the common options.

Click

Click()

Simulate the user clicking a button.

GetImage

GetImage(TYPE)

Retrieve a handle to the image (icon or bitmap) associated with the button.

TYPE = IMAGE_BITMAP | IMAGE_ICON

SetImage

SetImage(BITMAP)

Draws the specified BITMAP, a Win32::GUI::Bitmap or Win32::GUI::Icon object, in the Button.

EVENTS

Common events apply to most windows and controls.

Click

Click()

Sent when the control is selected (eg. the button pushed, the checkbox checked, etc.).

DblClick

DblClick()

Sent when the user double clicks on the control.

Disable

Disable()

Sent when the button is disabled

GotFocus

GotFocus()

Sent when the control is activated.

LostFocus

LostFocus()

Sent when the control is deactivated.

Push

Push(State)

Sent when the state button change.

VERSION

Documentation for Win32::GUI v1.14 created 01 Jun 2017

This document is autogenerated by the build process. Edits made here will be lost. Edit docs/per_package.tpl instead.

SUPPORT

Homepage: http://perl-win32-gui.sourceforge.net/.

For further support join the users mailing list from the website at http://lists.sourceforge.net/lists/listinfo/perl-win32-gui-users. There is a searchable list archive at http://sourceforge.net/p/perl-win32-gui/mailman/perl-win32-gui-users/.

COPYRIGHT and LICENCE

Copyright (c) 1997..2017 Aldo Calpini. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.