Windows Dev Center

DisplayRequest Class

Représente une demande d'affichage.

Syntaxe


var displayRequest = new Windows.System.Display.DisplayRequest();

Attributs

[MarshalingBehavior(None)]
[Threading(STA)]
[Version(0x06020000)]

Membres

DisplayRequestClasse possède ces types de membres :

Constructeurs

DisplayRequestClasse possède ces constructeurs.

ConstructeurDescription
DisplayRequest Creates an instance of the DisplayRequest class.

 

Méthodes

The DisplayRequest Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
RequestActive Activates a display request.
RequestRelease Deactivates a display request.

 

Remarques

Pour économiser de la puissance et prolonger l'autonomie des batteries, le système diminue la puissance de l'ordinateur s'il ne détecte aucune activité des utilisateurs pendant une certaine durée. Selon les paramètres d'alimentation, l'affichage peut d'abord être grisé, un écran de veille peut être affiché, et pour finir l'affichage peut être désactivé lorsque le système entre dans un état de veille à basse consommation.

Les applications qui affichent la vidéo ou l'exécute pendant des périodes étendues sans entrée d'utilisateur, peuvent demander que l'affichage reste activé en appelant DisplayRequest::RequestActive. Lorsqu'une demande d'affichage est activée, l'affichage du périphérique reste activé lorsque l'application est visible. Lorsque l'utilisateur déplace l'application en dehors du premier plan, le système désactive les demandes d'affichage et les réactive lorsque l'application retourne au premier plan.

Les demandes d'affichage sont cumulatives : chaque demande d'affichage doit être libérée avec un appel séparé de DisplayRequest::RequestRelease. Une application doit faire le suivi du nombre de demandes d'affichage actif et vérifier que toutes sont libérées (chacune avec un appel correspondant à DisplayRequest::RequestRelease) lorsque l'application n'a plus besoin que l'affichage reste actif. Pour plus d'informations, consultez :

L'utilisation des demandes d'affichage pour conserver l'affichage consomme beaucoup d'énergie. Utilisez ces instructions pour obtenir le meilleur comportement de l'application lorsque vous utilisez des demandes d'affichage.

  • Utilisez les demandes d'affichage uniquement en cas de besoin, autrement dit, lorsqu'aucune entrée utilisateur n'est prévue mais que l'affichage doit rester activé. Par exemple, pendant des présentations pleine page ou lorsque l'utilisateur lit un livre électronique.
  • Libérez chaque demande d'affichage dès qu'elle n'est plus nécessaire.
  • Libérez toutes les demandes d'affichage lorsque l'application est suspendue. Si l'affichage est toujours requis pour rester active, l'application peut créer une nouvelle demande d'affichage lorsqu'elle est réactivée.

Remarque  Cette classe n'est pas agile, ce qui signifie que vous devez considérer son modèle de thread et son comportement de marshaling. Pour plus d'informations, consultez les rubriques Threads et marshaling (C++/CX) et Utilisation d'objets Windows Runtime dans un environnement multithread (.NET).

Windows Phone 8

Cette API est prise en charge dans les applications natives uniquement.

Exemples

Le code suivant (tiré de l'exemple d'état d'alimentation d'affichage) indique comment activer, suivre et publier des demandes d'affichage.


var g_dispRequest = null;
var drCount = 0;

function activateRequest() {

    if (g_dispRequest === null) {
        try {
            // This call creates an instance of the displayRequest object
            g_dispRequest = new Windows.System.Display.DisplayRequest;
        } catch (e) {
            WinJS.log && WinJS.log("Failed: displayRequest object creation, error: " + e.message, "sample", "error");
        }
    }

    if (g_dispRequest) {
        try {
            // This call activates a display-required request. If successful, 
            // the screen is guaranteed not to turn off automatically due to user inactivity.
            g_dispRequest.requestActive();
            drCount += 1;
            WinJS.log && WinJS.log("Display request activated (" + drCount +")", "sample", "status");
        } catch (e) {
            WinJS.log && WinJS.log("Failed: displayRequest.requestActive, error: " + e.message, "sample", "error");
        }
    }
}

function releaseRequest() {
        
        
    if (g_dispRequest) {
        try {
            // This call de-activates the display-required request. If successful, the screen
            // might be turned off automatically due to a user inactivity, depending on the
            // power policy settings of the system. The requestRelease method throws an exception 
            // if it is called before a successful requestActive call on this object.
            g_dispRequest.requestRelease();
            drCount -= 1;
            WinJS.log && WinJS.log("Display request released (" + drCount +")", "sample", "status");
        }  catch (e) {
            WinJS.log && WinJS.log("Failed: displayRequest.requestRelease, error: " + e.message, "sample", "error");
        }
    }
}

Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Téléphone minimal pris en charge

Windows Phone 8

Espace de noms

Windows.System.Display
Windows::System::Display [C++]

Métadonnées

Windows.winmd

 

 

Afficher:
© 2015 Microsoft