Player.uiMode

Artículo
06/21/2023

[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 especifica o recupera un valor que indica qué controles se muestran en la interfaz de usuario.

Sintaxis

player . uiMode

Valores posibles

Esta propiedad es una cadena de lectura y escritura.

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 se incrusta sin controles y solo se muestra la ventana de vídeo o visualización.
mini	Reproductor multimedia de Windows se inserta 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, inverso rápido y los 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", hay una ventana presente 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 se establece en "invisible", no se muestra ninguna interfaz de usuario, pero el espacio todavía se reserva 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 estará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 muestra ningún control 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 se establece en "custom" 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 elemento SELECT HTML que permite al usuario cambiar la interfaz de usuario de un objeto Player incrustado. El objeto Player se creó con id. = "Player".

<!-- Create an HTML SELECT element. -->
<SELECT  ID = UI  LANGUAGE="JScript"

         /* Specify the UI mode the user selects. */
         onChange = "Player.uiMode = UI.value">

/* These are the four UI mode options. */
<OPTION VALUE="invisible">Invisible
<OPTION VALUE="none">No Controls
<OPTION VALUE="mini">Mini Player
<OPTION VALUE="full">Full Player
</SELECT>

Reproductor multimedia de Windows 10 Mobile: esta propiedad solo acepta o devuelve valores de "none" o "full". En los dispositivos Smartphone, solo se muestra el estado de reproducción y un contador cuando uiMode está establecido en "full".

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".
Archivo DLL	Wmp.dll

Consulte también

IWMPRemoteMediaServices (Interfaz)
IWMPRemoteMediaServices::GetCustomUIMode
Player (objeto)