MCIWindowSize (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

MCI functions

MCIWindowSize (Function)

In french: MCITailleFenêtre

Modify the size and position of display window of a multimedia file that was opened beforehand (MCIOpen).

Caution: During the opening, the name of container window must have been specified beforehand.

Example

MCIOpen("Film.avi", "MyFilm", MciStyleChild, IMG_Image)
...
MCIWindowSize("MyFilm", MciModeStretched)

MCIPlay("MyFilm")
...
MCIClose("MyFilm")

Syntax

Resizing the display window Hide the details

<Result> = MCIWindowSize(<Multimedia File or Alias> , <X Position> , <Y Position> , <Width> , <Height> [, <Parameters> [, <Name of message window>]])

<Result>: Boolean

True if the modification was performed,
False otherwise. To find out the error number, use MCIErr.
To find out the error details, use MCIMsgErr or ErrorInfo associated with the errMessage constant.
The status report of command is returned by MCIRetrieve.

<Multimedia File or Alias>: Character string

Name of multimedia file to use (AVI, MP3, ...) or alias defined when opening the file (MCIOpen).

<X Position>: Integer

New horizontal position (X coordinate) of display window.

<Y Position>: Integer

New vertical position (Y coordinate) of display window.

<Width>: Integer

New width of display window.

<Height>: Integer

New height of display window.

<Parameters>: Optional character string (with quotes)

Additional parameters if necessary. These parameters can be known by checking the documentation of Windows MCI function named "open".
The MciWait constant can be added to this string. This constant is used to indicate that the program must wait for the end of the MCI command to run the rest of application.

<Name of message window>: Optional character string (with or without quotes)

Name of window used to intercept and manage the different messages sent by MMSYSTEM.DLL. These messages are in MM_xxxxxx format and they can be retrieved by Event. You can for example get messages regarding the management of CD ROM or Joystick.

Modifying the display mode Hide the details

<Result> = MCIWindowSize(<Multimedia File or Alias> , <Display mode> [, <Parameters> [, <Name of message window>]])

<Result>: Character string

Position in the file. This position is expressed in the format specified by MCIPositionFormat.

<Multimedia File or Alias>: Character string

Name of multimedia file to use (AVI, MP3, ...) or alias defined when opening the file (MCIOpen).

<Display mode>: Constant

Mode for displaying the file in the window:
MciModeCentered Image centered in the window
MciModeStretched Image stretched to occupy the entire surface
MciModeHomotheticCentered
(Default value) Image proportionally stretched
MciModeNormal Display at 100%

<Parameters>: Optional character string (with quotes)

Additional parameters if necessary. These parameters can be known by checking the documentation of Windows MCI function named "open".
The MciWait constant can be added to this string. This constant is used to indicate that the program must wait for the end of the MCI command to run the rest of application.

<Name of message window>: Optional character string (with or without quotes)

Name of window used to intercept and manage the different messages sent by MMSYSTEM.DLL. These messages are in MM_xxxxxx format and they can be retrieved via Event. You can for example get messages regarding the management of CD ROM or Joystick.

Component : wd250std.dll