ArrangeIconicWindows()

Arranges all the minimized child windows of the specified parent window.

[TBD]

Brings the window to the foreground.

Displays the standard "Browse For Folder" dialog box. Returns the selected item's name, or undef if no item was selected or an error occurred. Allowed %OPTIONS are: -computeronly => 0/1 (default 0)

only enable computers to be selected

-domainonly => 0/1 (default 0)

only enable computers in the current domain or workgroup

-driveonly => 0/1 (default 0)

only enable drives to be selected

-editbox => 0/1 (default 0)

if 1, the dialog will include an edit field in which
the user can type the name of an item

-folderonly => 0/1 (default 0)

only enable folders to be selected

-includefiles => 0/1 (default 0)

the list will include files as well folders

-owner => WINDOW

[TBD]

-printeronly => 0/1 (default 0)

only enable printers to be selected

-root => PATH or CONSTANT

	the root directory for browsing; this can be either a
      path or one of the CSIDL_* constants for special folders
	(see the Win32::FileOp module by Jenda for a list of
	such constants)

-title => STRING

the title for the dialog

Change most of the options used when the object was created.

Changes the default cursor for a window to CURSOR (a Win32::GUI::Cursor object). Returns the handle of the previous default cursor.

Changes the default icon for a window to ICON (a Win32::GUI::Icon object). Returns the handle of the previous default icon.

Changes the default small icon for a window to ICON (a Win32::GUI::Icon object). Returns the handle of the previous default small icon.

Allowed %OPTIONS are:

-owner
-color

Allowed %OPTIONS are:

-owner
-size
-height
-width
-escapement
-orientation
-weight
-bold
-italic
-underline
-strikeout
-charset
-outputprecision
-clipprecision
-quality
-family
-name
-face (== -name)
-color
-ttonly
-fixedonly
-effects
-script
-minsize
-maxsize

Confines the cursor to the specified screen rectangle. Call it without parameters to release the cursor. Returns nonzero on success,

[TBD]

Minimizes a window.

Returns the common dialog library error code.

[TBD]

[TBD]

Enter the GUI dialog phase: the script halts, the user can interact with the created windows and events subroutines are triggered as necessary; note that this function must be called without ANY parameter or instantiation (eg. don't call it as method of a created object):

Win32::GUI::Dialog(); # correct
$Window->Dialog();    # !!!WRONG!!!

Disables a window.

Just like Dialog(), but returns when there are no more events to process

Forces redrawing of the menu bar.

Enables a window (or disables it if FLAG is FALSE).

Returns the handle of the window whose class name and window name match the specified strings; both strings can be empty. Note that the function does not search child windows, only top level windows. If no matching windows is found, the return value is zero.

Returns the handle of the active window.

Returns the classname of the specified window (undef on errors). See new Win32::GUI::Class.

Returns a four elements array defining the windows client area rectangle (left, top, right, bottom) or undef on errors.

Returns the handle of the current cursor.

Returns a two elements array containing the x and y position of the cursor, or undef on errors.

Returns the handle of the desktop window.

Returns the handle of a control in the dialog box given its ID.

[TBD]

Returns the handle of the window that has the keyboard focus.

Gets the font of the window (returns an handle; use

$Font = $W->GetFont();
%details = Win32::GUI::Font::Info( $Font );

to get font details).

Returns the name of the font used in the window.

Returns the handle of the foreground window.

Returns the handle of the menu associated with the window.

Retrieves a message sent to the window, optionally considering only messages identifiers in the range MIN..MAX; if a message is found, the function returns a 7 elements array containing:

- the result code of the message
- the message identifier
- the wParam argument
- the lParam argument
- the time when message occurred
- the x coordinate at which message occurred
- the y coordinate at which message occurred

If the result code of the message was -1 the function returns undef. Note that this function should not be normally used unless you know very well what you're doing.

Allowed %OPTIONS are:

-owner => WINDOW
    [TBD]
-title => STRING
    the title for the dialog
-directory => STRING
    specifies the initial directory
-file => STRING
    specifies a name that will appear on the dialog's edit field
-filter => ARRAY REFERENCE
    [TBD]

Returns the handle of the DOS Prompt window your perl script is running in; if called in an array context, returns the handle and the HINSTANCE of your perl process.

Returns the handle of the specified predefined system object (pen, brush or font). OBJECT can have one of the following values:

 0 WHITE_BRUSH
 1 GRAY_BRUSH
 2 LTGRAY_BRUSH
 3 DKGRAY_BRUSH
 4 BLACK_BRUSH
 5 NULL_BRUSH (also HOLLOW_BRUSH)
 6 WHITE_PEN
 7 BLACK_PEN
 8 NULL_PEN
10 OEM_FIXED_FONT
11 ANSI_FIXED_FONT
12 ANSI_VAR_FONT
13 SYSTEM_FONT
14 DEVICE_DEFAULT_FONT
15 DEFAULT_PALETTE
16 SYSTEM_FIXED_FONT
17 DEFAULT_GUI_FONT

The returned handle can be referenced as if it was a Win32::GUI object (eg. a Win32::GUI::Brush or Win32::GUI::Font), but note that it is not blessed, so you can't directly invoke methods on it:

$Font = Win32::GUI::GetStockObject(17);    # DEFAULT_GUI_FONT
print $Font->GetMetrics();                 # !!!WRONG!!!
print Win32::GUI::Font::GetMetrics($Font); # correct
$Window->SetFont($Font);                   # correct

[TBD]

Returns a two elements array containing the x and y size of the specified text in the window (eventually with the speficied FONT), or undef on errors.

Returns the handle of the foreground window.

Returns handle of the window that has the specified relationship (given by COMMAND) with the specified window. Available COMMANDs are:

GW_CHILD
GW_HWNDFIRST
GW_HWNDLAST
GW_HWNDNEXT
GW_HWNDPREV
GW_OWNER

Example:

$Button->GetWindow(GW_OWNER);

Retrieves a windows property; for more info consult the original API documentation.

Returns a four elements array defining the windows rectangle (left, top, right, bottom) or undef on errors.

Returns a two elements array containing the thread and the process identifier for the specified window.

Gets or sets the window height.

Hides a window.

Forces a refresh of a window, or a rectangle of it. The parameters can be (FLAG) for the whole area of the window, or (LEFT, TOP, RIGHT, BOTTOM, [FLAG]) to specify a rectangle. If the FLAG parameter is set to TRUE, the background is erased before the window is refreshed (this is the default).

Returns TRUE if the window is enabled, FALSE otherwise.

Returns TRUE if the window is minimized, FALSE otherwise.

Returns TRUE if the window is visible, FALSE otherwise.

Returns TRUE if the window is a window, FALSE otherwise.

Returns TRUE if the window is maximized, FALSE otherwise.

Gets or sets the window x coordinate.

Maximizes a window.

[TBD]

Moves the window to the specified position.

Restores a minimized window.

Inspects the window's message queue and eventually returns data about the message it contains; it can optionally check only for message identifiers in the range MIN..MAX; the last MESSAGE parameter, if specified, must be an array reference. If a message is found, the function puts in that array 7 elements containing:

- the handle of the window to which the message is addressed
- the message identifier
- the wParam argument
- the lParam argument
- the time when message occurs
- the x coordinate at which message occurs
- the y coordinate at which message occurs

[TBD]

[TBD]

Posts a message to a window.

Sends a quit message to a window, optionally with an EXITCODE; if no EXITCODE is given, it defaults to 0.

Releases the mouse capture.

Resizes the window to the specified dimension.

(preliminary) Saves the window content to a BMP file.

Returns the windows client area height.

Returns the windows client area width.

Sends a message to a window.

Sends a message to a window and wait for it to be processed or until the specified TIMEOUT (number of milliseconds) elapses; returns the result code of the processed message or undef on errors. If undef is returned and a call to Win32::GetLastError() returns 0, then the window timed out processing the message. The FLAGS parameter is optional, possible values are:

0 SMTO_NORMAL
  (the calling thread can process other requests while waiting;
  this is the default setting)
1 SMTO_BLOCK
  (the calling thread does not process other requests)
2 SMTO_ABORTIFHUNG
  (returns without waiting if the receiving process seems to be "hung")

Assigns the mouse capture to a window.

Moves the cursor to the specified coordinates.

Activates a window.

Sets the font of the window (FONT is a Win32::GUI::Font object).

Brings the window to the foreground.

Sets the icon of the window; TYPE can be 0 for the small icon, 1 for the big icon. Default is the same icon for small and big.

Associates the specified MENU to a window.

Determines if a window is automatically redrawn when its content changes. FLAG can be a true value to allow redraw, false to prevent it.

Sets a windows property; for more info consult the original API documentation.

Shows a window (or change its showing state to COMMAND); available COMMANDs are:

SW_HIDE
SW_MAXIMIZE
SW_MINIMIZE
SW_RESTORE
SW_SHOW
SW_SHOWDEFAULT
SW_SHOWMAXIMIZED
SW_SHOWMINIMIZED
SW_SHOWMINNOACTIVE
SW_SHOWNA
SW_SHOWNOACTIVATE
SW_SHOWNORMAL

The default COMMAND, if none specified, is SW_SHOWNORMAL.

Gets or sets the text of a window.

Gets or sets the window y coordinate.

[TBD]

Refreshes the content of a window.

Returns the module version number.

Gets or sets the window width.

Returns the handle of the window at the specified screen position.