Win32::GUI Common Options

Back to the index


This document illustrates the options available when creating an object (in particular, windows and controls). Here you'll find the general options, the ones that apply to every window class; for class-specific options, refer to that object's HTML reference file.


Required options

-name


List of available options


-background => COLOR

[TBD]


-class => CLASS

Specifies the window class (which is different from the Perl's object class, eg. Win32::GUI::Button) for the window; all the predefined objects have hardcoded class names (eg. ``BUTTON'' for Win32::GUI::Button), so you shouldn't want to pick a different one unless you are familiar with window classes and you want to subclass an existing one. This technique is documented in the Microsoft Platform SDK Reference, and (at a lighter level) in guiclasses.pod. The CLASS parameter can be either a name or a reference to a Win32::GUI::Class object. As for many other options in Win32::GUI, its use is not recommended unless you know what you're doing.


-disabled => 0/1

Sets the initial enabled state for the control; by default this option is 0 (the control is enabled). Set it to 1 to create a control which is initially disabled.


-font => FONT

[TBD]


-foreground => COLOR

[TBD]


-group => 0/1

[TBD]


-height => NUMBER

[TBD]


-left => NUMBER

This option ...


-menu => MENU

[TBD]


-name => STRING

[TBD]


-style => NUMBER

[TBD]


-tabstop => 0/1

[TBD]


-text => STRING

Specifies the STRING that will appear on the window's caption or in the control's body (eg. a Label text, a Button caption, a Textfield content, and so on). Its use depends of course on the control type; some controls, like ProgressBars, makes no use of it at all.


-title => STRING

A synonim for -text.


-top => NUMBER

[TBD]


-visible => 0/1

Sets the initial visibility state for the control; by default this option is 1 (the control is visible). Set it to 0 to create a control which is initially hidden.


-width => NUMBER

[TBD]