The Perl and Raku Conference 2025: Greenville, South Carolina - June 27-29 Learn more

NAME

Win32::GUI::Label - Create and manipulate label controls

DESCRIPTION

[TBD]

METHODS

Common methods apply to most windows, controls and resources.

new

new(PARENT, %OPTIONS)

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

Class specific %OPTIONS are:

-align => left/center/right (default left)
Set text align.
-bitmap => Win32::GUI::Bitmap object
-fill => black/gray/white/none (default none)
Fills the control rectangle ("black", "gray" and "white" are
the window frame color, the desktop color and the window
background color respectively).
-frame => black/gray/white/etched/none (default none)
Draws a border around the control. colors are the same
of -fill, with the addition of "etched" (a raised border).
-icon => Win32::GUI::Icon object
-noprefix => 0/1 (default 0)
Disables the interpretation of "&" as accelerator prefix.
-notify => 0/1 (default 0)
Enables the Click(), DblClick, etc. events.
-picture => see -bitmap
-sunken => 0/1 (default 0)
Draws a half-sunken border around the control.
-truncate => 0/1/word/path (default 0)
Specifies how the text is to be truncated:
0 the text is not truncated
1 the text is truncated at the end
path the text is truncated before the last "\"
(used to shorten paths).
-wrap => 0/1 (default 1)
The text wraps automatically to a new line.
-simple => 0/1 (default 1)
Set/Unset simple style.

See also the common options.

GetIcon

GetIcon()

Retrieve a handle to the icon associated with a LABEL that has the SS_ICON style

GetImage

GetImage(type)

Retrieve a handle to the image (icon or bitmap) associated with the button type = IMAGE_BITMAP | IMAGE_ICON | IMAGE_CURSOR

SetIcon

SetIcon(ICON)

Associate an icon with a LABEL that has the SS_ICON style

SetImage

SetImage(BITMAP)

Draws the specified BITMAP in the Label. BITMAP is assumed a Win32::GUI::Bitmap object by default.

EVENTS

Common events apply to most windows and controls.

Click

Click()

[TBD]

DblClick

DblClick()

[TBD]

Enable

Enable(State)

Sent when the enable state Label 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.