Свойство AxWindowsMediaPlayer.uiMode

[Функция, связанная с этой страницей, Медиаплеер Windows sdk, является устаревшей функцией. Он был заменен MediaPlayer. MediaPlayer оптимизирован для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует по возможности использовать MediaPlayer вместо пакета SDK для Медиаплеер Windows. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]

Свойство uiMode получает или задает значение, указывающее, какие элементы управления отображаются в пользовательском интерфейсе.

Синтаксис

public System.String uiMode {get; set;}

Public Property uiMode As System.String

Значение свойства

Объект System.String, который является одним из следующих значений.

Значение	Описание	Пример звука	Пример видео
невидимые	Медиаплеер Windows внедряется без видимого пользовательского интерфейса (элементов управления, видео или окна визуализации).	(Ничего не отображается.)	(Ничего не отображается.)
нет	Медиаплеер Windows внедряется без элементов управления и отображается только окно видео или визуализации.
mini	Медиаплеер Windows встраивается в окно состояния, в дополнение к окну видео или визуализации отображаются элементы управления воспроизведением и приостановкой, остановкой, отключением звука и громкостью.
переполненные	По умолчанию. Медиаплеер Windows в дополнение к окну видео или визуализации встраивается в окно состояния, панель поиска, воспроизведение и приостановка, остановка, отключение звука, следующий, предыдущий, перемотка вперед, перемотка и громкость.
custom	Медиаплеер Windows внедряется с помощью пользовательского интерфейса. Может использоваться только в программах C++.	(Отображается пользовательский интерфейс.)	(Отображается пользовательский интерфейс.)

Комментарии

Это свойство указывает внешний вид внедренного Медиаплеер Windows. Если для uiMode задано значение none, mini или full, отображается окно для отображения видеоклипов и звуковых визуализаций. Это окно можно скрыть в мини- или полном режиме, задав атрибуту height тега OBJECT значение 40, которое измеряется снизу и оставляет часть элементов управления пользовательского интерфейса видимой. Если внедренный интерфейс не требуется, задайте для атрибутов ширины и высоты нулевое значение.

Если для uiMode задано значение "невидимый", пользовательский интерфейс не отображается, но пространство на странице по-прежнему зарезервировано в соответствии с шириной и высотой. Это полезно для сохранения макета страницы при изменении uiMode . Кроме того, зарезервированное пространство является прозрачным, поэтому будут видны все элементы, слоистые за элементом управления.

Если для uiMode задано значение full или mini, Медиаплеер Windows отображает элементы управления транспортировкой в полноэкранном режиме. Если для uiMode задано значение none, элементы управления не отображаются в полноэкранном режиме.

Если окно отображается и воспроизводится звуковое содержимое, отображаемая визуализация будет последней, использованной в Медиаплеер Windows.

Если uiMode имеет значение custom в программе C++, реализующей IWMPRemoteMediaServices, отображается файл обложки, указанный параметром IWMPRemoteMediaServices.GetCustomUIMode .

Во время полноэкранного воспроизведения Медиаплеер Windows скрывает курсор мыши, если параметр enableContextMenu имеет значение false, а uiMode — "none".

Примеры

В следующем примере создается список, позволяющий пользователю изменять режим пользовательского интерфейса для внедренного объекта Медиаплеер 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

Требования

Требование	Значение
Версия	Медиаплеер Windows версии 7.0 или более поздней. Медиаплеер Windows серии 9 или более поздней версии для "невидимых" или "пользовательских"
Пространство имен	AxWMPLib
Сборка	AxInterop.WMPLib.dll (AxInterop.WMPLib.dll.dll)

См. также раздел

Объект AxWindowsMediaPlayer (VB и C#)

AxWindowsMediaPlayer.enableContextMenu (VB и C#)