IWMPPlayer::get_uiMode

IWMPPlayer::get_uiMode method

The get_uiMode method retrieves a value indicating which controls are shown in the user interface.

Syntax


HRESULT get_uiMode(
  [out] BSTR *pbstrMode
);

Parameters

pbstrMode [out]

Pointer to a BSTR containing one of the following values.

Value Description Audio example Video example
invisibleWindows Media Player is embedded without any visible user interface (controls, video, or visualization window).(Nothing is displayed.)(Nothing is displayed.)
noneWindows Media Player is embedded without controls, and with only the video or visualization window displayed.uiMode="none" with audiouiMode="none" with video
miniWindows Media Player is embedded with the status window, play/pause, stop, mute, and volume controls shown in addition to the video or visualization window.uiMode="mini" with audiouiMode="mini" with video
fullDefault. Windows Media Player is embedded with the status window, seek bar, play/pause, stop, mute, next, previous, fast forward, fast reverse, and volume controls in addition to the video or visualization window.uiMode="full" with audiouiMode="full" with video
customWindows Media Player is embedded with a custom user interface. Can only be used in C++ programs.(Custom user interface is displayed.)(Custom user interface is displayed.)

 

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return codeDescription
S_OK

The method succeeded.

 

Remarks

This method retrieves the appearance of the embedded Windows Media Player. When the BSTR retrieved from get_uiMode is "none", "mini", or "full", a window is present for the display of video clips and audio visualizations. This window can be hidden in mini or full mode by setting the height attribute of the OBJECT tag to 40, which is measured from the bottom, and leaves the controls portion of the user interface visible. If no embedded interface is desired, set both the width and height attributes to zero.

If the BSTR retrieved from get_uiMode is "invisible", no user interface is displayed, but space is still reserved on the page as specified by width and height. This is useful for retaining page layout whenever the UI mode changes. Additionally, the reserved space is transparent, so any elements layered behind the control will be visible.

If the BSTR retrieved from get_uiMode is "full" or "mini", Windows Media Player displays transport controls in full-screen mode. If the BSTR retrieved from get_uiMode is "none", no controls are displayed in full-screen mode.

If the window is visible and audio content is being played, the visualization displayed will be the one most recently used in Windows Media Player.

If the BSTR retrieved from get_uiMode is "custom" in a C++ program that implements IWMPRemoteMediaServices, the skin file indicated by IWMPRemoteMediaServices::GetCustomUIMode is displayed.

During full-screen playback, Windows Media Player hides the mouse cursor when the VARIANT_BOOL received from IWMPPlayer::get_enableContextMenu equals FALSE and the BSTR received from get_uiMode equals "none".

Windows Media Player 10 Mobile: This method only retrieves a BSTR set to "none" or "full". On Smartphone devices, only playback status and a counter are displayed when uiMode is set to "full".

Requirements

Version

Windows Media Player 9 Series or later.

Header

Wmp.h

DLL

Wmp.dll

See also

IWMPPlayer Interface
IWMPPlayer::get_enableContextMenu
IWMPPlayer::put_uiMode
IWMPRemoteMediaServices Interface
IWMPRemoteMediaServices::GetCustomUIMode

 

 

Show:
© 2016 Microsoft