MediaChange Event of the AxWindowsMediaPlayer Object
[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 MediaChange event occurs when a media item changes.
[C#]
private void player_MediaChange(
object sender,
_WMPOCXEvents_MediaChangeEvent e
)
[Visual Basic]
Private Sub player_MediaChange(
sender As Object,
e As _WMPOCXEvents_MediaChangeEvent
) Handles player.MediaChange
Event Data
The handler associated with this event is of type AxWMPLib._WMPOCXEvents_MediaChangeEventHandler. This handler receives an argument of type AxWMPLib._WMPOCXEvents_MediaChangeEvent, which contains the following property related to this event.
| Property | Description |
|---|---|
| Item | System.ObjectThe media item that changed. You can cast this to an IWMPMedia interface to access it. |
Examples
The following example uses a label to display the name of the current media item. The code updates the text in the label with each occurrence of the MediaChange Event. The AxWMPLib.AxWindowsMediaPlayer object is represented by the variable named player.
// Add a delegate for the MediaChange event.
player.MediaChange += new AxWMPLib._WMPOCXEvents_MediaChangeEventHandler(player_MediaChange);
private void player_MediaChange(object sender, AxWMPLib._WMPOCXEvents_MediaChangeEvent e)
{
// Get an interface to the changed media item that is returned in the event data.
WMPLib.IWMPMedia3 changedItem = (WMPLib.IWMPMedia3)e.item;
// Display the name of the changed media item.
mediaName.Text = changedItem.name;
}
Public Sub player_MediaChange(ByVal sender As Object, ByVal e As AxWMPLib._WMPOCXEvents_MediaChangeEvent) Handles player.MediaChange
' Get an interface to the changed media item that is returned in the event data.
Dim changedItem As WMPLib.IWMPMedia3 = e.item
' Display the name of the changed media item.
mediaName.Text = changedItem.name
End Sub
Requirements
| Requirement | Value |
|---|---|
| Version |
Windows Media Player 9 Series or later |
| Namespace |
AxWMPLib |
| Assembly |
|