SHAppBarMessage-Funktion (shellapi.h)

Artikel
03/09/2024

Sendet eine App-Leiste-Nachricht an das System.

Syntax

UINT_PTR SHAppBarMessage(
  [in]      DWORD       dwMessage,
  [in, out] PAPPBARDATA pData
);

Parameter

[in] dwMessage

Art: DWORD

Appbar-Nachrichtenwert, der gesendet werden soll. Dieser Parameter kann einen der folgenden Werte annehmen.

ABM_NEW (0x00000000)

Registriert eine neue App-Leiste und gibt den Nachrichtenbezeichner an, den das System zum Senden von Benachrichtigungsnachrichten an die App-Leiste verwenden soll.

ABM_REMOVE (0x00000001)

Hebt die Registrierung einer App-Leiste auf, und entfernt die Leiste aus der internen Liste des Systems.

ABM_QUERYPOS (0x00000002)

Fordert eine Größe und Bildschirmposition für eine App-Leiste an.

ABM_SETPOS (0x00000003)

Legt die Größe und Bildschirmposition einer App-Leiste fest.

ABM_GETSTATE (0x00000004)

Ruft die automatischen Und Always-On-Top-Zustände der Windows-Taskleiste ab.

ABM_GETTASKBARPOS (0x00000005)

Ruft das umgebende Rechteck der Windows-Taskleiste ab. Beachten Sie, dass dies nur für die Taskleiste des Systems gilt. Andere Objekte, insbesondere Symbolleisten, die mit Software von Drittanbietern geliefert werden, können ebenfalls vorhanden sein. Daher ist ein Teil des Bildschirmbereichs, der nicht von der Windows-Taskleiste abgedeckt ist, für den Benutzer möglicherweise nicht sichtbar. Verwenden Sie die GetMonitorInfo-Funktion , um den Bereich des Bildschirms abzurufen, der nicht von der Taskleiste und anderen App-Balken abgedeckt ist – dem Arbeitsbereich, der für Ihre Anwendung verfügbar ist.

ABM_ACTIVATE (0x00000006)

Benachrichtigt das System, eine App-Leiste zu aktivieren oder zu deaktivieren. Das lParam-Element des APPBARDATA-Elements , auf das von pData verwiesen wird, ist auf TRUE festgelegt, um zu aktivieren oder FALSE zu deaktivieren.

ABM_GETAUTOHIDEBAR (0x00000007)

Ruft den Ziehpunkt zur automatischen App-Leiste ab, die einem bestimmten Bildschirmrand zugeordnet ist.

ABM_SETAUTOHIDEBAR (0x00000008)

Registriert oder hebt die Registrierung einer automatischen App-Leiste für einen Bildschirmrand auf.

ABM_WINDOWPOSCHANGED (0x00000009)

Benachrichtigt das System, wenn sich die Position einer Appbar geändert hat.

ABM_SETSTATE (0x0000000A)

Windows XP und höher: Legt den Status der Automatischbesetzungs- und Always-on-Top-Attribute der Appbar fest.

ABM_GETAUTOHIDEBAREX (0x0000000B)

Windows XP und höher: Ruft den Handle zur automatischen App-Leiste ab, die einem bestimmten Rand eines bestimmten Monitors zugeordnet ist.

ABM_SETAUTOHIDEBAREX (0x0000000C)

Windows XP und höher: Registriert oder hebt die Registrierung einer automatischen App-Leiste für einen Edge eines bestimmten Monitors auf.

[in, out] pData

Typ: PAPPBARDATA

Ein Zeiger auf eine APPBARDATA-Struktur . Der Inhalt der Struktur für den Eintrag und das Beenden hängt vom Wert ab, der im dwMessage-Parameter festgelegt ist. Einzelheiten finden Sie auf den einzelnen Nachrichtenseiten.

Rückgabewert

Typ: UINT_PTR

Diese Funktion gibt einen nachrichtenabhängigen Wert zurück. Weitere Informationen finden Sie in der Windows SDK-Dokumentation für die gesendete App-Leiste.For more information, see the Windows SDK documentation for the specific appbar message sent. Links zu diesen Dokumenten finden Sie im Abschnitt Siehe auch.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shellapi.h
Bibliothek	Shell32.lib
DLL	Shell32.dll (Version 4.0 oder höher)
APIs	ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240)