SizeWindow

InstallShield 2019 » InstallScript Language Reference

Use the SizeWindow function to change the size of a specific user interface element. Specify the new size in pixels.

The installation may run under many different screen resolutions. To account for this, you need to use the GetExtents function to determine the overall size of the screen; then use ratios in the parameters of your SizeWindow function call to specify the size of your user interface object.

Note • This function is recommended for advanced developers only.

Syntax

SizeWindow (nObject, nDx, nDy);

Parameters

SizeWindow Parameters

Parameter

Description

nObject

Specifies the object to resize. Pass one of the following predefined constants in this parameter:

•

BACKGROUND—Indicates the main background window.

•

METAFILE—Indicates a billboard used during the file transfer process. SizeWindow does not support bitmap (.bmp) files.

Note • This parameter does not have any effect on metafiles that are displayed with SdBitmap function. SdBitmap automatically resizes metafiles when they are displayed.

In addition, this parameter does not have any effect on the type of billboard that is displayed on a progress dialog when Enable(BBRD) is called.

•

MMEDIA_AVI—Sets the window size for next AVI file to be played. All the AVI videos are displayed with a default size. Changing the size may change the resolution and crispness of the video.

•

MMEDIA_SWF—Sets the window size for the Adobe Flash application file (.swf) to be played.

nDx

Specifies the horizontal size of the object in pixels.

nDy

Specifies the vertical size of the object in pixels.

Return Values

SizeWindow Return Values
Return Value	Description
0	The function successfully changed the size of the window.
< 0	The function was unable to change the size of the window.

Additional Information

Use the PlayMMedia function if you want your installation to play an Adobe Flash application file (.swf) or an AVI file.

SizeWindow

InstallShield 2019 Help Library

April 2019