Share via


ModeChange 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 ModeChange event occurs when a mode of Windows Media Player is changed.

[C#]
private void player_ModeChange(
  object sender,
  _WMPOCXEvents_ModeChangeEvent e
)

[Visual Basic]
Private Sub player_ModeChange( 
  sender As Object,
  e As _WMPOCXEvents_ModeChangeEvent
) Handles player.ModeChange

Event Data

The handler associated with this event is of type AxWMPLib._WMPOCXEvents_ModeChangeEventHandler. This handler receives an argument of type AxWMPLib._WMPOCXEvents_ModeChangeEvent, which contains the following properties related to this event.

Property Description
modeName System.StringIndicates the mode that was changed. For possible values, see Remarks.
newValue System.BooleanIndicates the new state of the specified mode.

Remarks

The following table shows the possible values for the modeName property.

String Description
shuffle Tracks are played in random order.
loop The entire sequence of tracks is played repeatedly.

Requirements

Requirement Value
Version
Windows Media Player 9 Series or later
Namespace
AxWMPLib
Assembly
AxInterop.WMPLib.dll (AxInterop.WMPLib.dll.dll)

See also

AxWindowsMediaPlayer Object (VB and C#)

IWMPSettings.getMode (VB and C#)

IWMPSettings.setMode (VB and C#)