WinSize (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Functions for managing windows

WinSize

Presentation

Example

Non-resizable windows

Display mode

Buttons of title bar

Parent window/Child window

Equivalent functions

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.

Versions 16 and later

This function is now available for WINDEV applications in Linux.

New in version 16

This function is now available for WINDEV applications in Linux.

Versions 24 and later

This function is now available for Android applications.

This function is now available for iPhone/iPad applications.

New in version 24

This function is now available for Android applications.

This function is now available for iPhone/iPad applications.

This function is now available for Android applications.

This function is now available for iPhone/iPad applications.

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 window to use.
If this parameter corresponds to an empty string (""), the width and/or height of current window is modified.
Versions 24 and later
Remark: The window must not be maximized.
New in version 24
Remark: The window must not be maximized.
Remark: The window must not be maximized.

<Width>: Integer

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

<Height>: Integer

New total window height. This value must be included between the minimum height (returned by ..MinHeight) and the maximum height (returned by ..MaxHeight).
To find out the current window height, 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 window to use.
If this parameter corresponds to an empty string (""), the width and/or height of current window is modified and the current window is moved.
Versions 24 and later
Remark: The window must not be maximized.
New in version 24
Remark: The window must not be maximized.
Remark: The window must not be maximized.

<Horizontal position>: Integer

New horizontal position of window in relation to the top 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 top left corner of the screen.
To avoid modifying this parameter, use the Default constant.

<Width>: Integer

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

<Height>: Integer

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

Finding out or modifying 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.
Versions 24 and later
Not available.
New in version 24
Not available.
Not available.
NormalSize Window neither maximized, nor minimized.

<Window>: Window name

Name or alias of window to use.
If this parameter is not specified or if it corresponds to an empty string (""), the display mode of current window is returned.
Versions 24 and later
Remark: The window must not be maximized.
New in version 24
Remark: The window must not be maximized.
Remark: The window must not be maximized.

<Display mode>: Optional constant

Specifies the new window display mode:
MaxSize Maximized window.
MinSize Minimized window.
Versions 24 and later
Not available.
New in version 24
Not available.
Not available.
NormalSize Window neither maximized, nor minimized.
Versions 24 and later
This parameter is not available. It is not possible to modify the window display mode.
New in version 24
This parameter is not available. It is not possible to modify the window display mode.
This parameter is not available. It is not possible to modify 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 : wd260obj.dll