Funzione SHAppBarMessage (shellapi.h)

Articolo
03/01/2024

Invia un messaggio della barra delle app al sistema.

Sintassi

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

Parametri

[in] dwMessage

Tipo: DWORD

Valore del messaggio appbar da inviare. Questo parametro può avere uno dei valori seguenti.

ABM_NEW (0x00000000)

Registra una nuova barra delle app e specifica l'identificatore del messaggio che il sistema deve usare per inviare messaggi di notifica alla barra delle app.

ABM_REMOVE (0x00000001)

Annulla la registrazione di una barra delle app, rimuovendo la barra dall'elenco interno del sistema.

ABM_QUERYPOS (0x00000002)

Richiede una dimensione e una posizione dello schermo per una barra delle app.

ABM_SETPOS (0x00000003)

Imposta le dimensioni e la posizione dello schermo di una barra delle app.

ABM_GETSTATE (0x00000004)

Recupera gli stati autoide e always-on-top della barra delle applicazioni di Windows.

ABM_GETTASKBARPOS (0x00000005)

Recupera il rettangolo di delimitazione della barra delle applicazioni di Windows. Si noti che questo vale solo per la barra delle applicazioni di sistema. Possono essere presenti anche altri oggetti, in particolare le barre degli strumenti fornite con software di terze parti. Di conseguenza, alcune aree dello schermo non coperte dalla barra delle applicazioni di Windows potrebbero non essere visibili all'utente. Per recuperare l'area dello schermo non coperta sia dalla barra delle applicazioni che da altre barre dell'app, ovvero l'area di lavoro disponibile per l'applicazione, usare la funzione GetMonitorInfo .

ABM_ACTIVATE (0x00000006)

Notifica al sistema di attivare o disattivare una barra delle app. Il membro lParamdell'APPBARDATA a cui fa riferimento pData è impostato su TRUE per attivare o FALSE per disattivare.

ABM_GETAUTOHIDEBAR (0x00000007)

Recupera l'handle sulla barra delle app dell'ambiente automatico associata a un bordo specifico dello schermo.

ABM_SETAUTOHIDEBAR (0x00000008)

Registra o annulla la registrazione di una barra delle app per l'ide automatico per un bordo dello schermo.

ABM_WINDOWPOSCHANGED (0x00000009)

Notifica al sistema quando la posizione di una barra delle app è cambiata.

ABM_SETSTATE (0x0000000A)

Windows XP e versioni successive: Imposta lo stato dell'ide automatico e degli attributi always-on-top della barra delle app.

ABM_GETAUTOHIDEBAREX (0x0000000B)

Windows XP e versioni successive: Recupera l'handle sulla barra delle app dell'ambiente di visualizzazione automatica associata a un bordo specifico di un determinato monitor.

ABM_SETAUTOHIDEBAREX (0x0000000C)

Windows XP e versioni successive: Registra o annulla la registrazione di una barra delle app per un bordo di un determinato monitor.

[in, out] pData

Tipo: PAPPBARDATA

Puntatore a una struttura APPBARDATA . Il contenuto della struttura all'ingresso e all'uscita dipende dal valore impostato nel parametro dwMessage . Per informazioni specifiche, vedere le singole pagine dei messaggi.

Valore restituito

Tipo: UINT_PTR

Questa funzione restituisce un valore dipendente dal messaggio. Per altre informazioni, vedere la documentazione Windows SDK per il messaggio della barra delle app specifico inviato. Nella sezione Vedere anche i collegamenti a tali documenti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shellapi.h
Libreria	Shell32.lib
DLL	Shell32.dll (versione 4.0 o successiva)
Set di API	ext-ms-win-shell-shell32-l1-2-1 (introdotto in Windows 10, versione 10.0.10240)