IWMPPlayer::put_uiMode (Windows Embedded CE 6.0)
1/6/2010
The put_uiMode method specifies a value indicating which controls are shown in the user interface.
Syntax
HRESULT put_uiMode( BSTR bstrMode );
Parameters
- bstrMode
[in] BSTR containing one of the following values.
The following table lists the possible values for bstrMode
| Value | Description |
|---|---|
invisible |
Windows Media Player is embedded without any visible user interface (controls, video, or visualization window). |
none |
Windows Media Player is embedded without controls, and with only the video or visualization window displayed. |
mini |
Windows Media Player is embedded with the status window, play/pause, stop, mute, and volume controls shown in addition to the video or visualization window. |
full |
Default. 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. |
custom |
Windows Media Player is embedded with a custom user interface. Can only be used in C++ programs. |
Return Values
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return code | Description |
|---|---|
S_OK |
The method succeeded. |
Remarks
This method specifies the appearance of the embedded Windows Media Player. When the BSTR specified in put_uiMode is set to "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 44, which is measured from the bottom, and leaves the controls portion of the user interface visible. This value will be different if the sizes of the controls have been changed, or if you wish to display the status bar. If no embedded interface is desired, set both the width and height attributes to zero.
If the BSTR specified in put_uiMode is set to "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 specified in put_uiMode is set to "full" or "mini", Windows Media Player displays transport controls in full-screen mode. If the BSTR specified in put_uiMode is set to "none", no controls are displayed in full-screen mode.