Funzione SHAppBarMessage (shellapi.h)

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

Vedi anche

ABM_ACTIVATE

ABM_GETAUTOHIDEBAR

ABM_GETAUTOHIDEBAREX

ABM_GETSTATE

ABM_GETTASKBARPOS

ABM_NEW

ABM_QUERYPOS

ABM_REMOVE

ABM_SETAUTOHIDEBAR

ABM_SETAUTOHIDEBAREX

ABM_SETPOS

ABM_SETSTATE

ABM_WINDOWPOSCHANGED