## Win32::GUI Common Options

Back to the index

- Win32::GUI Common Options
  - Required options
  - List of available options
    - -background => COLOR
    - -class => CLASS
    - -disabled => 0/1
    - -font => FONT
    - -foreground => COLOR
    - -group => 0/1
    - -height => NUMBER
    - -left => NUMBER
    - -menu => MENU
    - -name => STRING
    - -style => NUMBER
    - -tabstop => 0/1
    - -text => STRING
    - -title => STRING
    - -top => NUMBER
    - -visible => 0/1
    - -width => NUMBER

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]