Player.fullScreen

Article
06/21/2023

[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é fullScreen spécifie ou récupère une valeur indiquant si le contenu vidéo est lu en mode plein écran.

Syntaxe

player . Fullscreen

Valeurs possibles

Cette propriété est une valeur booléenne en lecture/écriture.

Valeur	Description
true	Le contenu vidéo est lu en mode plein écran.
false	Par défaut. Le contenu vidéo n’est pas lu en mode plein écran.

Notes

Pour que le mode plein écran fonctionne correctement lors de l’incorporation du contrôle Lecteur multimédia Windows, la zone d’affichage vidéo doit avoir une hauteur et une largeur d’au moins un pixel. Si uiMode est défini sur « mini » ou « full », la hauteur du contrôle lui-même doit être supérieure ou égale à 65 pour prendre en charge la zone d’affichage vidéo en plus de l’interface utilisateur.

Si uiMode est défini sur « invisible », le fait de définir cette propriété sur true génère une erreur et n’affecte pas le comportement du contrôle.

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

Si uiMode est défini sur « full » ou « mini », Lecteur multimédia Windows affiche les contrôles de transport en mode plein écran lorsque le curseur de la souris se déplace. Après un bref intervalle d’absence de déplacement de la souris, les contrôles de transport sont masqués. Si uiMode a la valeur « none », aucun contrôle n’est affiché en mode plein écran.

Remarque

L’affichage des contrôles de transport en mode plein écran nécessite le système d’exploitation Windows XP.

Si les contrôles de transport ne sont pas affichés en mode plein écran, Lecteur multimédia Windows quitte automatiquement le mode plein écran lorsque la lecture s’arrête.

Remarque

Veillez toujours à indiquer à l’utilisateur comment revenir du mode plein écran.

Exemples

L’exemple suivant crée un bouton d’entrée HTML qui utilise Player. fullScreen pour basculer un objet de lecteur incorporé en mode plein écran. L’objet Player a été créé avec l’ID = « Player ».

<INPUT type = button 
       value = "Full Screen" 
       name = FSBUTTON
       onclick = "
               /* Check to be sure the player is playing. */
               if (Player.playState == 3) 
                  Player.fullScreen = 'true';
               ">

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows version 7.0 ou ultérieure.
DLL	Wmp.dll

Voir aussi

Player, objet