Share via


Player.stretchToFit

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The stretchToFit property specifies or retrieves a value indicating whether video displayed by the Windows Media Player control automatically sizes to fit the video window, when the video window is larger than the dimensions of the video image.

Syntax

player.stretchToFit

Possible Values

This property is a read/write Boolean.

Value Description
true The video will stretch to fit the window.
false Default. The video will not stretch to fit the window.

Remarks

When stretchToFit is set to true, the Windows Media Player control maintains the original aspect ratio of the video. If the aspect ratio of the video does not match the aspect ratio of the video window, black mask areas may appear on either the top and the bottom, or left and right, of the video image.

This property applies to the Windows Media Player control only when embedded in a webpage.

Windows Media Player 10 Mobile: This property is not supported.

Requirements

Requirement Value
Version
Windows Media Player version 7.1 or later.
DLL
Wmp.dll

See also

Player Object