Struttura THUMBBUTTON (shobjidl_core.h)

Articolo
08/26/2023

Usato dai metodi dell'interfaccia ITaskbarList3 per definire i pulsanti usati in una barra degli strumenti incorporata nella rappresentazione di anteprima di una finestra.

Sintassi

typedef struct THUMBBUTTON {
  THUMBBUTTONMASK  dwMask;
  UINT             iId;
  UINT             iBitmap;
  HICON            hIcon;
  WCHAR            szTip[260];
  THUMBBUTTONFLAGS dwFlags;
} THUMBBUTTON, *LPTHUMBBUTTON;

Members

dwMask

Tipo: THUMBBUTTONMASK

Combinazione di valori THUMBBUTTONMASK che specificano quali membri di questa struttura contengono dati validi; altri membri vengono ignorati, con l'eccezione di iId, che è sempre necessario.

iId

Tipo: UINT

Identificatore definito dall'applicazione del pulsante, univoco all'interno della barra degli strumenti.

iBitmap

Tipo: UINT

Indice in base zero dell'immagine del pulsante all'interno dell'elenco di immagini impostato tramite ITaskbarList3::ThumbBarSetImageList.

hIcon

Tipo: HICON

Handle di un'icona da usare come immagine del pulsante.

szTip[260]

Tipo: WCHAR[260]

Matrice di caratteri wide che contiene il testo della descrizione comando del pulsante, visualizzata quando il puntatore del mouse passa il mouse sul pulsante.

dwFlags

Tipo: THUMBBUTTONFLAGS

Combinazione di valori THUMBBUTTONFLAGS che controllano stati e comportamenti specifici del pulsante.

Commenti

Quando viene fatto clic su un pulsante, viene inviato un messaggio WM_COMMAND contenente l'ID pulsante alla finestra dell'applicazione associata. L'applicazione gestisce qualsiasi azione assegnata al pulsante.

Immagini pulsante

Quando si usa un'icona, specificata tramite il membro hIcon , la barra delle applicazioni esegue la propria copia dell'icona. È responsabilità del chiamante liberare l'handle passato in hIcon quando non è più necessario.

Se vengono specificate sia un'icona che un elenco di immagini per l'immagine di un pulsante, l'icona viene usata se possibile. Se per qualche motivo il tentativo di recuperare l'icona ha esito negativo, viene usata l'immagine dall'elenco di immagini.

Le applicazioni devono fornire queste immagini di pulsante:

Pulsante nello stato attivo predefinito.
Immagini adatte per l'uso con display con valori dpi elevati (punti per pollice).

Le immagini devono essere a 32 bit e di dimensioni GetSystemMetrics(SM_CXICON) x GetSystemMetrics(SM_CYICON). La barra degli strumenti fornisce oggetti visivi per gli stati clic, disabilitati e del puntatore del mouse di un pulsante.

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Intestazione	shobjidl_core.h (include Shobjidl.h)

Vedi anche

ITaskbarList3::ThumbBarAddButtons

ITaskbarList3::ThumbBarUpdateButtons

Estensioni della barra delle applicazioni

Esempio di barra degli strumenti di anteprima della barra delle applicazioni

Condividi tramite