Player.uiMode

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La propriété uiMode spécifie ou récupère une valeur indiquant les contrôles affichés dans l’interface utilisateur.

Syntaxe

player . uiMode

Valeurs possibles

Cette propriété est une chaîne en lecture/écriture.

Valeur	Description	Exemple audio	Exemple vidéo
invisibles	Lecteur multimédia Windows est incorporé sans interface utilisateur visible (contrôles, fenêtre vidéo ou visualisation).	(Rien n’est affiché.)	(Rien n’est affiché.)
aucun	Lecteur multimédia Windows est incorporé sans contrôles et avec uniquement la vidéo ou la fenêtre de visualisation affichée.
mini	Lecteur multimédia Windows est incorporé avec les contrôles de fenêtre de status, de lecture/pause, d’arrêt, de muet et de volume affichés en plus de la fenêtre vidéo ou de visualisation.
complet	Par défaut. Lecteur multimédia Windows est incorporé avec la fenêtre status, la barre de recherche, la lecture/pause, l’arrêt, le son, le suivant, le précédent, l’avance rapide, l’inversion rapide et les contrôles de volume en plus de la fenêtre vidéo ou de visualisation.
custom	Lecteur multimédia Windows est incorporé avec une interface utilisateur personnalisée. Ne peut être utilisé que dans les programmes C++.	(L’interface utilisateur personnalisée s’affiche.)	(L’interface utilisateur personnalisée s’affiche.)

Notes

Cette propriété spécifie l’apparence du Lecteur multimédia Windows incorporé. Lorsque uiMode est défini sur « none », « mini » ou « full », une fenêtre est présente pour l’affichage des clips vidéo et des visualisations audio. Cette fenêtre peut être masquée en mode mini ou complet en définissant l’attribut height de la balise OBJECT sur 40, qui est mesuré à partir du bas, et laisse la partie contrôles de l’interface utilisateur visible. Si aucune interface incorporée n’est souhaitée, définissez les attributs width et height sur zéro.

Si uiMode est défini sur « invisible », aucune interface utilisateur n’est affichée, mais l’espace est toujours réservé sur la page, comme spécifié par largeur et hauteur. Cela est utile pour conserver la mise en page lorsque uiMode peut changer. En outre, l’espace réservé étant transparent, tous les éléments superposés derrière le contrôle seront visibles.

Si uiMode est défini sur « full » ou « mini », Lecteur multimédia Windows affiche les contrôles de transport en mode plein écran. Si uiMode est défini sur « none », aucun contrôle n’est affiché en mode plein écran.

Si la fenêtre est visible et que du contenu audio est lu, la visualisation affichée est celle utilisée le plus récemment dans Lecteur multimédia Windows.

Si uiMode est défini sur « personnalisé » dans un programme C++ qui implémente IWMPRemoteMediaServices, le fichier d’apparence indiqué par IWMPRemoteMediaServices::GetCustomUIMode s’affiche.

Pendant la lecture en plein écran, Lecteur multimédia Windows masque le curseur de la souris lorsque enableContextMenu est égal à false et que uiMode est égal à « none ».

Exemples

L’exemple suivant crée un élément HTML SELECT qui permet à l’utilisateur de modifier l’interface utilisateur d’un objet Player incorporé. L’objet Player a été créé avec 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>

Lecteur multimédia Windows 10 Mobile : cette propriété accepte ou retourne uniquement les valeurs « none » ou « full ». Sur les appareils smartphone, seuls les status de lecture et un compteur s’affichent lorsque uiMode est défini sur « full ».

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows version 7.0 ou ultérieure. Lecteur multimédia Windows série 9 ou ultérieure pour « invisible » ou « personnalisé ».
DLL	Wmp.dll

Voir aussi

IWMPRemoteMediaServices, interface

IWMPRemoteMediaServices::GetCustomUIMode

Player, objet