WinSize (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Controls, pages and windows / Window functions

Non-resizable windows
Display mode
Buttons of title bar
Parent window/Child window
Equivalent functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

WinSize (Function)

In french: FenTaille

WinSize:

returns or modifies the window display mode (maximized, minimized or normal)
Feature not available.
modifies the window height and/or width,
moves the window and modifies a window's height and/or width.

Example

// Increase the width and height of "WIN_Edit" window
WinSize(WIN_Edit, WIN_Edit.Width + 20, WIN_Edit.Height + 30)

Syntax

Modifying the window height and/or width Hide the details

WinSize(<Window> , <Width> , <Height>)

<Window>: Window name

Name or alias of the window to be used.
If this parameter corresponds to an empty string (""), the width and/or height of current window is modified.
Remark: The window must not be maximized.

<Width>: Integer

New total window width. This value must be between the minimum and maximum width (returned by the MinWidth and MaxWidth properties).
To get the current width of a window, use Width.
To avoid modifying this parameter, use the Default constant.

<Height>: Integer

New total window height. This value must be between the minimum and maximum height (returned by the MinHeight and MaxHeight properties).
To get the current height of a window, use Height.
To avoid modifying this parameter, use the Default constant.

Moving a window and/or modifying its height and/or width Hide the details

WinSize(<Window> , <Horizontal position> , <Vertical position> , <Width> , <Height>)

<Window>: Window name

Name or alias of the window to be used.
If this parameter corresponds to an empty string (""), the width and/or height of current window is modified and the current window is moved.
Remark: The window must not be maximized.

<Horizontal position>: Integer

New horizontal position of window in relation to the upper-left corner of the screen.
To avoid modifying this parameter, use the Default constant.

<Vertical position>: Integer

New vertical position of window in relation to the upper-left corner of the screen.
To avoid modifying this parameter, use the Default constant.

<Width>: Integer

New total window width. This value must be between the minimum and maximum width (returned by the MinWidth and MaxWidth properties).
To get the current width of a window, use Width.
To avoid modifying this parameter, use the Default constant.

<Height>: Integer

New total window height. This value must be between the minimum and maximum height (returned by the MinHeight and MaxHeight properties).
To get the current height of a window, use Height.
To avoid modifying this parameter, use the Default constant.

Getting or setting the display mode of a window Hide the details

<Result> = WinSize([<Window> [, <Display mode>]])

<Result>: Constant

The window display mode corresponds to one of the following display modes:
current if <Display mode> is not specified,
before modification if <Display mode> is specified.
This parameter can take for value:
MaxSize Maximized window.
MinSize Minimized window.
Not available.
NormalSize Window neither maximized, nor minimized.

<Window>: Window name

Name or alias of the window to be used.
If this parameter is not specified or if it corresponds to an empty string (""), the display mode of current window is returned.
Remark: The window must not be maximized.

<Display mode>: Optional constant

Specifies the new window display mode:
MaxSize Maximized window.
MinSize Minimized window.
Not available.
NormalSize Window neither maximized, nor minimized.
This parameter is not available. It is not possible to change the window display mode.

Remarks

Non-resizable windows

WinSize is used to modify the window size even if this window is a "non-resizable" window.

Display mode

If the window size exceeds the scree resolution and if "Automatic scrollbars" is checked ("Style" tab in the window description), some scrollbars are automatically added to scroll the window.

For example, a window was created in 800*600 full screen (or 240*600). Some scrollbars will appear when this window is displayed in 640*480 (or 240*320).

Buttons of title bar

Only the windows containing a maximize button in their title bar can be resized with the mouse.

The windows with no maximize button in their title bar cannot be maximized. In this case, an error will be generated.

The windows with no minimize button in their title bar cannot be minimized. In this case, an error will be generated.

Parent window/Child window

When a parent window is minimized, all its child windows are minimized at the same time. Only the icon of the parent window is found in the Windows desktop.

Equivalent functions

WinSize("", MinSize) is equivalent to Iconize().
WinSize("", MaxSize) is equivalent to Maximize().
WinSize("", NormalSize) is equivalent to Restore().

Component: wd300obj.dll