Controls.isAvailable

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é isAvailable indique si un type d’informations spécifié est disponible ou si une action spécifiée peut être effectuée.

player.controls.isAvailable(
        name
        )

Paramètres

name

Chaîne contenant l’une des valeurs suivantes.

String	Description
Currentitem	Détermine si l’utilisateur peut définir la propriété currentItem .
currentMarker	Détermine si l’utilisateur peut rechercher un marqueur spécifique.
currentPosition	Détermine si l’utilisateur peut rechercher une position spécifique dans le fichier. Certains fichiers ne prennent pas en charge la recherche.
Fastforward	Détermine si le fichier prend en charge le transfert rapide et si cette fonctionnalité peut être appelée. De nombreux types de fichiers (ou flux en direct) ne prennent pas en charge fastForward.
fastReverse	Détermine si le fichier prend en charge fastReverse et si cette fonctionnalité peut être appelée. De nombreux types de fichiers (ou flux en direct) ne prennent pas en charge fastReverse.
Suivant	Détermine si l’utilisateur peut rechercher l’entrée suivante dans une playlist.
pause	Détermine si la méthode pause est disponible.
play	Détermine si la méthode play est disponible.
previous	Détermine si l’utilisateur peut rechercher l’entrée précédente dans une playlist.
étape	Détermine si la méthode step est disponible pendant la lecture.
stop	Détermine si la méthode stop est disponible.

Valeurs de retour

Cette méthode retourne une valeur booléenne .

Exemples

L’exemple suivant crée un élément HTML BUTTON qui recherche la position de départ de l’élément multimédia actif. Le code JScript utilise isAvailable pour vérifier que le fichier prend en charge l’opération de recherche. L’objet Player a été créé avec l’ID = « Player ».

<INPUT TYPE = "BUTTON"  ID = "START"  NAME = "START"  VALUE = "Seek To Zero"

    /* If supported, seek to position zero. */
    onClick = "if (Player.controls.isAvailable('CurrentPosition'))
        Player.controls.currentPosition = 0;
">

Configuration requise

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

Voir aussi

Controls, objet

Partager via