Fonction SHAppBarMessage (shellapi.h)
Envoie un message de barre d’application au système.
Syntaxe
UINT_PTR SHAppBarMessage(
[in] DWORD dwMessage,
[in, out] PAPPBARDATA pData
);
Paramètres
[in] dwMessage
Type : DWORD
Valeur du message de la barre d’application à envoyer. Ce paramètre peut prendre les valeurs suivantes.
ABM_NEW (0x00000000)
Inscrit une nouvelle barre d’application et spécifie l’identificateur de message que le système doit utiliser pour envoyer des messages de notification à la barre d’application.
ABM_REMOVE (0x00000001)
Annule l’inscription d’une barre d’applications, en supprimant la barre de la liste interne du système.
ABM_QUERYPOS (0x00000002)
Demande une taille et une position d’écran pour une barre d’application.
ABM_SETPOS (0x00000003)
Définit la taille et la position de l’écran d’une barre d’application.
ABM_GETSTATE (0x00000004)
Récupère les états d’autohide et de toujours en haut de la barre des tâches Windows.
ABM_GETTASKBARPOS (0x00000005)
Récupère le rectangle englobant de la barre des tâches Windows. Notez que cela s’applique uniquement à la barre des tâches système. D’autres objets, en particulier les barres d’outils fournies avec des logiciels tiers, peuvent également être présents. Par conséquent, une partie de la zone d’écran non couverte par la barre des tâches Windows peut ne pas être visible par l’utilisateur. Pour récupérer la zone de l’écran non couverte à la fois par la barre des tâches et d’autres barres d’application( la zone de travail disponible pour votre application), utilisez la fonction GetMonitorInfo .
ABM_ACTIVATE (0x00000006)
Avertit le système d’activer ou de désactiver une barre d’application. Le membre lParam de l’APPBARDATA pointé vers par pData a la valeur TRUE pour activer ou FALSE à désactiver.
ABM_GETAUTOHIDEBAR (0x00000007)
Récupère le handle de la barre d’application autohide associée à un bord particulier de l’écran.
ABM_SETAUTOHIDEBAR (0x00000008)
Inscrit ou annule l’inscription d’une barre d’application automatique pour un bord de l’écran.
ABM_WINDOWPOSCHANGED (0x00000009)
Avertit le système lorsque la position d’une barre d’applications a changé.
ABM_SETSTATE (0x0000000A)
Windows XP et versions ultérieures : Définit l’état des attributs autohide et always-on-top de la barre d’application.
ABM_GETAUTOHIDEBAREX (0x0000000B)
Windows XP et versions ultérieures : Récupère le handle de la barre d’application autohide associée à un bord particulier d’un moniteur particulier.
ABM_SETAUTOHIDEBAREX (0x0000000C)
Windows XP et versions ultérieures : Inscrit ou annule l’inscription d’une barre d’application automatique pour un bord d’un moniteur particulier.
[in, out] pData
Type : PAPPBARDATA
Pointeur vers une structure APPBARDATA . Le contenu de la structure à l’entrée et à la sortie dépend de la valeur définie dans le paramètre dwMessage . Pour plus d’informations, consultez les pages de message individuelles.
Valeur retournée
Type : UINT_PTR
Cette fonction retourne une valeur dépendante du message. Pour plus d’informations, consultez la documentation SDK Windows pour connaître le message de barre d’application spécifique envoyé. Les liens vers ces documents sont fournis dans la section Voir aussi.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shellapi.h |
| Bibliothèque | Shell32.lib |
| DLL | Shell32.dll (version 4.0 ou ultérieure) |
| Ensemble d’API | ext-ms-win-shell-shell32-l1-2-1 (introduit dans Windows 10, version 10.0.10240) |