énumération QUERY_USER_NOTIFICATION_STATE (shellapi.h)

  • Article

Spécifie l’état de l’ordinateur pour l’utilisateur actuel par rapport à la capacité d’envoyer une notification. Utilisé par SHQueryUserNotificationState.

Syntax

typedef enum {
  QUNS_NOT_PRESENT = 1,
  QUNS_BUSY = 2,
  QUNS_RUNNING_D3D_FULL_SCREEN = 3,
  QUNS_PRESENTATION_MODE = 4,
  QUNS_ACCEPTS_NOTIFICATIONS = 5,
  QUNS_QUIET_TIME = 6,
  QUNS_APP = 7
} QUERY_USER_NOTIFICATION_STATE;

Constantes

 
QUNS_NOT_PRESENT
Valeur : 1
Un économiseur d’écran s’affiche, la machine est verrouillée ou une session de basculement d’utilisateur rapide non active est en cours.
QUNS_BUSY
Valeur : 2
Une application plein écran est en cours d’exécution ou les paramètres de présentation sont appliqués. Les paramètres de présentation permettent à un utilisateur de placer son ordinateur dans un état adapté à une présentation ininterrompue, par exemple un ensemble de diapositives PowerPoint, d’un simple clic.
QUNS_RUNNING_D3D_FULL_SCREEN
Valeur : 3
Une application Direct3D en mode plein écran (exclusif) est en cours d’exécution.
QUNS_PRESENTATION_MODE
Valeur : 4
L’utilisateur a activé les paramètres de présentation Windows pour bloquer les notifications et les messages contextuels.
QUNS_ACCEPTS_NOTIFICATIONS
Valeur : 5
Aucun des autres états n’est trouvé, les notifications peuvent être envoyées librement.
QUNS_QUIET_TIME
Valeur : 6
Introduit dans Windows 7. L’utilisateur actuel est en « temps calme », c’est-à-dire la première heure après qu’un nouvel utilisateur se connecte à son compte pour la première fois. Pendant ce temps, la plupart des notifications ne doivent pas être envoyées ou affichées. Cela permet à un utilisateur de s’habituer à un nouveau système informatique sans ces distractions. Le temps de silence se produit également pour chaque utilisateur après une mise à niveau ou propre installation du système d’exploitation.



Les applications doivent définir l’indicateur NIIF_RESPECT_QUIET_TIME dans leurs notifications ou info-bulle, ce qui empêche ces éléments d’être affichés pendant que l’utilisateur actuel est dans l’état en temps silencieux.

Notez que pendant le temps de silence, si l’utilisateur est dans l’un des autres modes bloqués (QUNS_NOT_PRESENT, QUNS_BUSY, QUNS_PRESENTATION_MODE ou QUNS_RUNNING_D3D_FULL_SCREEN), SHQueryUserNotificationState retourne uniquement cette valeur et ne signale pas QUNS_QUIET_TIME.
QUNS_APP
Valeur : 7
Introduit dans Windows 8. Une application du Windows Store est en cours d’exécution.

Configuration requise

   
Client minimal pris en charge Windows Vista, Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
En-tête shellapi.h