Propiedad AxWindowsMediaPlayer.uiMode

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

La propiedad uiMode obtiene o establece un valor que indica qué controles se muestran en la interfaz de usuario.

Sintaxis

public System.String uiMode {get; set;}

Public Property uiMode As System.String

Valor de propiedad

System.String que es uno de los valores siguientes.

Value	Descripción	Ejemplo de audio	Ejemplo de vídeo
invisibles	Reproductor multimedia de Windows se inserta sin ninguna interfaz de usuario visible (controles, ventana de vídeo o visualización).	(No se muestra nada).	(No se muestra nada).
ninguno	Reproductor multimedia de Windows está incrustado sin controles y solo se muestra la ventana de vídeo o visualización.
mini	Reproductor multimedia de Windows se incrusta con la ventana de estado, reproducir o pausar, detener, silenciar y controles de volumen que se muestran además de la ventana de vídeo o visualización.
full	Predeterminada. Reproductor multimedia de Windows se inserta con la ventana de estado, la barra de búsqueda, la reproducción/pausa, la detención, la silenciación, siguiente, anterior, avance rápido, rebobinado y controles de volumen además de la ventana de vídeo o visualización.
custom	Reproductor multimedia de Windows se inserta con una interfaz de usuario personalizada. Solo se puede usar en programas de C++.	(Se muestra la interfaz de usuario personalizada).	(Se muestra la interfaz de usuario personalizada).

Observaciones

Esta propiedad especifica la apariencia del Reproductor multimedia de Windows incrustado. Cuando uiMode se establece en "none", "mini" o "full", existe una ventana para la visualización de clips de vídeo y visualizaciones de audio. Esta ventana se puede ocultar en modo mini o completo estableciendo el atributo height de la etiqueta OBJECT en 40, que se mide desde la parte inferior, y deja visible la parte de controles de la interfaz de usuario. Si no se desea ninguna interfaz incrustada, establezca los atributos width y height en cero.

Si uiMode está establecido en "invisible", no se muestra ninguna interfaz de usuario, pero el espacio todavía está reservado en la página según lo especificado por ancho y alto. Esto es útil para conservar el diseño de página cuando uiMode puede cambiar. Además, el espacio reservado es transparente, por lo que los elementos superpuestas detrás del control serán visibles.

Si uiMode está establecido en "full" o "mini", Reproductor multimedia de Windows muestra controles de transporte en modo de pantalla completa. Si uiMode está establecido en "none", no se muestran controles en modo de pantalla completa.

Si la ventana está visible y se reproduce el contenido de audio, la visualización que se muestra será la que se usó más recientemente en Reproductor multimedia de Windows.

Si uiMode está establecido en "personalizado" en un programa de C++ que implementa IWMPRemoteMediaServices, se muestra el archivo de máscara indicado por IWMPRemoteMediaServices.GetCustomUIMode .

Durante la reproducción de pantalla completa, Reproductor multimedia de Windows oculta el cursor del mouse cuando enableContextMenu es igual a false y uiMode es igual a "none".

Ejemplos

En el ejemplo siguiente se crea un cuadro de lista que permite al usuario cambiar el modo de interfaz de usuario de un objeto Reproductor multimedia de Windows incrustado. El objeto AxWMPLib.AxWindowsMediaPlayer se representa mediante la variable denominada 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

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows versión 7.0 o posterior. Reproductor multimedia de Windows serie 9 o posterior para "invisible" o "personalizado"
Espacio de nombres	AxWMPLib
Ensamblado	AxInterop.WMPLib.dll (AxInterop.WMPLib.dll.dll)

Consulte también

Objeto AxWindowsMediaPlayer (VB y C#)

AxWindowsMediaPlayer.enableContextMenu (VB y C#)