AmbientAttributes.passThrough

[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 passThrough attribute specifies or retrieves a value indicating whether the control will pass all mouse events through to the control under it.

        elementID.passThrough

Possible Values

This attribute is a read/write Boolean.

Value Description
true Control passes events through to the control under it.
false Default. Control does not pass events through.

Remarks

This attribute is useful if, for example, a text control sits on top of a button control only to provide labeling. In this case, clicks on the text control must be passed through to the button control.

The passThrough attribute is not supported by the VIEW, SUBVIEW, and PLAYLIST elements. It will not work with the VIDEO element if VIDEO.windowless is set to false, nor with the EFFECTS element if EFFECTS.windowed is set to true.

Requirements

Requirement Value
Version
Windows Media Player version 7.0 or later

See also

Ambient Attributes