AxWindowsMediaPlayer.uiMode プロパティ

  • [アーティクル]

[このページWindows メディア プレーヤー SDK に関連付けられている機能は、レガシ機能です。 MediaPlayer に置き換わりました。 MediaPlayer は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能な場合は SDK ではなく MediaPlayerWindows メディア プレーヤー使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

uiMode プロパティは、ユーザー インターフェイスに表示されるコントロールを示す値を取得または設定します。

構文

public System.String uiMode {get; set;}


Public Property uiMode As System.String

プロパティ値

次のいずれかの値である System.String。

値 説明 オーディオの例 ビデオの例
非表示の Windows メディア プレーヤーは、表示可能なユーザー インターフェイス (コントロール、ビデオ、視覚化ウィンドウ) なしで埋め込まれます。 (何も表示されません。) (何も表示されません。)
なし Windows メディア プレーヤーはコントロールなしで埋め込まれており、ビデオウィンドウまたは視覚化ウィンドウのみが表示されます。 uimode = オーディオを含む 'none' uimode = ビデオを含む 'none'
mini Windows メディア プレーヤーは、ビデオまたは視覚化ウィンドウに加えて、状態ウィンドウ、再生/一時停止、停止、ミュート、および音量コントロールが埋め込まれています。 uimode = オーディオ付きの 'mini' uimode = ビデオ付きの 'mini'
フル 既定値。 Windows メディア プレーヤーは、ビデオまたは視覚化ウィンドウに加えて、ステータス ウィンドウ、シーク バー、再生/一時停止、停止、ミュート、次、前、早送り、巻き戻し、ボリューム コントロールに埋め込まれています。 uimode = オーディオを含む 'full' uimode = ビデオを含む 'full'
custom Windows メディア プレーヤーは、カスタム ユーザー インターフェイスに埋め込まれています。 C++ プログラムでのみ使用できます。 (カスタム ユーザー インターフェイスが表示されます)。 (カスタム ユーザー インターフェイスが表示されます)。

解説

このプロパティは、埋め込みWindows メディア プレーヤーの外観を指定します。 uiMode が "none"、"mini"、または "full" に設定されている場合、ビデオ クリップとオーディオ視覚エフェクトを表示するためのウィンドウが表示されます。 このウィンドウは、下から測定される OBJECT タグの height 属性を 40 に設定し、ユーザー インターフェイスのコントロール部分を表示のままにすることで、ミニモードまたはフル モードで非表示にすることができます。 埋め込みインターフェイスが必要ない場合は、 width 属性と height 属性の両方を 0 に設定します。

uiMode が "invisible" に設定されている場合、ユーザー インターフェイスは表示されませんが、幅と高さで指定された領域はページに引き続き予約されます。 これは、 uiMode を変更できる場合にページ レイアウトを保持する場合に便利です。 また、予約領域は透明であるため、コントロールの背後に重ねられた要素が表示されます。

uiMode が "full" または "mini" に設定されている場合、Windows メディア プレーヤーはトランスポート コントロールを全画面表示モードで表示します。 uiMode が "none" に設定されている場合、全画面表示モードではコントロールは表示されません。

ウィンドウが表示され、オーディオ コンテンツが再生されている場合、表示される視覚化は、Windows メディア プレーヤーで最後に使用されたものになります。

IWMPRemoteMediaServices を実装する C++ プログラムで uiMode が "custom" に設定されている場合、IWMPRemoteMediaServices.GetCustomUIMode によって示されるスキン ファイルが表示されます。

全画面再生中、enableContextMenu が false、uiMode が "none" と等しい場合、Windows メディア プレーヤーはマウス カーソルを非表示にします。

例

次の例では、埋め込みWindows メディア プレーヤー オブジェクトのユーザー インターフェイス モードをユーザーが変更できるようにするリスト ボックスを作成します。 AxWMPLib.AxWindowsMediaPlayer オブジェクトは、player という名前の変数によって表されます。

// Load the list box with the four UI mode options.
uiModeOptions.Items.Add("invisible");
uiModeOptions.Items.Add("none");
uiModeOptions.Items.Add("mini");
uiModeOptions.Items.Add("full");


private void uiModeOptions_OnSelectedIndexChanged(object sender, System.EventArgs e)
{
    // Get the selected UI mode in the list box as a string.
    string newMode = (string)(((System.Windows.Forms.ListBox)sender).SelectedItem);
     
    // Set the UI mode that the user selected.
    player.uiMode = newMode;            
}


' Load the list box with the four UI mode options.
uiModeOptions.Items.Add("invisible")
uiModeOptions.Items.Add("none")
uiModeOptions.Items.Add("mini")
uiModeOptions.Items.Add("full")


Public Sub uiModeOptions_OnSelectedIndexChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles uiModeOptions.SelectedIndexChanged

    ' Get the selected UI mode in the list box as a string.
    Dim lb As System.Windows.Forms.ListBox = sender
    Dim newMode As String = lb.SelectedItem

    ' Set the UI mode that the user selected.
    player.uiMode = newMode

End Sub

必要条件

要件 値
Version
 バージョン 7.0 以降Windows メディア プレーヤー。 Windows メディア プレーヤー 9 シリーズ以降の "非表示" または "カスタム"
名前空間
 AxWMPLib
アセンブリ
AxInterop.WMPLib.dll (AxInterop.WMPLib.dll.dll)

関連項目

AxWindowsMediaPlayer オブジェクト (VB および C#)

AxWindowsMediaPlayer.enableContextMenu (VB および C#)