AxWindowsMediaPlayer 对象 (VB 和 C#)
[与此页面关联的功能(Windows 媒体播放器 SDK)是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
AxWindowsMediaPlayer 对象是 Windows 媒体播放器 控件的根对象。 它支持下表中列出的属性、方法和事件。
AxWindowsMediaPlayer 对象支持以下属性。
属性 | 描述 |
---|---|
cdromCollection | 获取 IWMPCdromCollection 接口。 |
closedCaption | 获取 IWMPClosedCaption 接口。 |
Ctlcontrols | 获取 IWMPControls 接口。 |
Ctlenabled | 获取或设置一个值,该值指示是否启用 Windows 媒体播放器 控件。 |
currentMedia | 获取或设置与当前媒体项对应的 IWMPMedia 接口。 |
currentPlaylist | 获取或设置当前 IWMPPlaylist 接口。 |
Dvd | 获取 IWMPDVD 接口。 |
enableContextMenu | 获取或设置一个值,该值指示是否启用上下文菜单,该菜单在单击鼠标右键时显示。 |
错误 | 获取 IWMPError 接口。 |
全屏 | 获取或设置一个值,该值指示视频内容是否在全屏模式下播放。 |
isOnline | 获取一个值,该值指示用户是否连接到网络。 |
isRemote | .NET 编程不支持。 |
mediaCollection | 获取 IWMPMediaCollection 接口。 |
network | 获取 IWMPNetwork 接口。 |
openState | 获取一个值,该值指示内容源的状态。 |
playerApplication | .NET 编程不支持。 |
playlistCollection | 获取 IWMPPlaylistCollection 接口。 |
playState | 获取一个值,该值指示Windows 媒体播放器操作的状态。 |
设置 | 获取 IWMPSettings 接口。 |
status | 获取一个值,该值指示Windows 媒体播放器的当前状态。 |
stretchToFit | 获取或设置一个值,该值指示视频是否拉伸以适应Windows 媒体播放器控制视频显示的大小。 |
uiMode | 获取或设置一个值,该值指示在网页中嵌入Windows 媒体播放器时用户界面中显示的控件。 |
URL | 获取或设置要播放的剪辑的名称。 |
versionInfo | 获取一个值,该值指定Windows 媒体播放器的版本。 |
windowlessVideo | 获取或设置一个值,该值指示Windows 媒体播放器控件是否以无窗口模式呈现视频。 |
AxWindowsMediaPlayer 对象支持以下方法。
方法 | 说明 |
---|---|
close | 释放Windows 媒体播放器资源。 |
launchURL | 将 URL 发送到要呈现的用户的默认浏览器。 |
newMedia | 返回新媒体项的 IWMPMedia 接口。 |
newPlaylist | 返回新播放列表的 IWMPPlaylist 接口。 |
openPlayer | 使用指定的 URL 打开Windows 媒体播放器。 |
AxWindowsMediaPlayer 对象支持以下事件。
事件 | 描述 |
---|---|
AudioLanguageChange | 在当前音频语言更改时发生。 |
缓冲 | 当Windows 媒体播放器控件开始或结束缓冲时发生。 |
CdromBurnError | 在 CD 燃烧操作期间发生泛型错误时发生。 |
CdromBurnMediaError | 将单个媒体项烧录到 CD 时出错时发生。 |
CdromBurnStateChange | 当 CD 燃烧操作更改状态时发生。 |
CdromMediaChange | 在 CD 或 DVD 驱动器中插入或弹出 CD 或 DVD 时发生。 |
CdromRipMediaError | 从 CD 中翻录单个曲目时出错时发生。 |
CdromRipStateChange | 当 CD 翻录操作更改状态时发生。 |
单击 | 当用户单击鼠标按钮时发生。 |
CreatePartnershipComplete | .NET 编程不支持。 |
CurrentItemChange | 在 IWMPControls.currentItem 更改时发生。 |
CurrentMediaItemAvailable | 当当前媒体项中的图形元数据项变为可用时发生。 |
CurrentPlaylistChange | 当当前播放列表中的某些内容发生更改时发生。 |
CurrentPlaylistItemAvailable | 当当前播放列表项变为可用时发生。 |
DeviceConnect | .NET 编程不支持。 |
DeviceDisconnect | .NET 编程不支持。 |
DeviceStatusChange | .NET 编程不支持。 |
DeviceSyncError | .NET 编程不支持。 |
DeviceSyncStateChange | .NET 编程不支持。 |
断开连接 | 保留供将来使用。 |
DomainChange | 当 DVD 域更改时发生。 |
双击 | 当用户双击鼠标按钮时发生。 |
DurationUnitChange | 保留供将来使用。 |
EndOfStream | 保留供将来使用。 |
错误 | 当Windows 媒体播放器控件具有错误条件时发生。 |
FolderScanStateChange | 当文件夹监视操作更改状态时发生。 |
KeyDown | 在按下某个键时发生。 |
KeyPress | 在按下并释放某个键时发生。 |
KeyUp | 在松开某个键时发生。 |
LibraryConnect | 库可用时发生。 |
LibraryDisconnect | 库不再可用时发生。 |
MarkerHit | 到达标记时发生。 |
MediaChange | 在媒体项更改时发生。 |
MediaCollectionAttributeStringAdded | 将属性值添加到库时发生。 |
MediaCollectionAttributeStringChanged | 更改库中的属性值时发生。 |
MediaCollectionAttributeStringRemoved | 从库中删除属性值时发生。 |
MediaCollectionChange | 当媒体集合发生更改时发生。 |
MediaCollectionMediaAdded | 将媒体项添加到本地库时发生。 |
MediaCollectionMediaRemoved | 从本地库中删除媒体项时发生。 |
MediaError | 当 Media 对象具有错误条件时发生。 |
ModeChange | 更改Windows 媒体播放器模式时发生。 |
MouseDown | 按下鼠标按钮时发生。 |
MouseMove | 移动鼠标指针时发生。 |
MouseUp | 松开鼠标按钮时发生。 |
NewStream | 保留供将来使用。 |
OpenPlaylistSwitch | 当 DVD 上的游戏开始播放时发生。 |
OpenStateChange | 当Windows 媒体播放器控件更改状态时发生。 |
PlayerDockedStateChange | .NET 编程不支持。 |
PlayerReconnect | .NET 编程不支持。 |
PlaylistChange | 在播放列表更改时发生。 |
PlaylistCollectionChange | 当播放列表集合中的某些内容发生更改时发生。 |
PlaylistCollectionPlaylistAdded | 将播放列表添加到播放列表集合时发生。 |
PlaylistCollectionPlaylistRemoved | 从播放列表集合中删除播放列表时发生。 |
PlaylistCollectionPlaylistSetAsDeleted | 保留供将来使用。 |
PlayStateChange | 当Windows 媒体播放器控件的播放状态更改时发生。 |
PositionChange | 当媒体项的当前位置已更改时发生。 |
ScriptCommand | 在收到同步的命令或 URL 时发生。 |
StatusChange | 在 status 属性更改值时发生。 |
StringCollectionChange | 在字符串集合更改时发生。 |
SwitchedToControl | .NET 编程不支持。 |
SwitchedToPlayerApplication | .NET 编程不支持。 |
警告 | 保留供将来使用。 |
相关主题
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈