Condividi tramite

Struttura TBBUTTONINFOW (commctrl.h)

  • Articolo

Contiene o riceve informazioni per un pulsante specifico in una barra degli strumenti.

Sintassi

typedef struct {
  UINT      cbSize;
  DWORD     dwMask;
  int       idCommand;
  int       iImage;
  BYTE      fsState;
  BYTE      fsStyle;
  WORD      cx;
  DWORD_PTR lParam;
  LPWSTR    pszText;
  int       cchText;
} TBBUTTONINFOW, *LPTBBUTTONINFOW;

Membri

cbSize

Tipo: UINT

Dimensioni della struttura, in byte. Questo membro deve essere compilato prima di inviare il messaggio associato.

dwMask

Tipo: DWORD

Set di flag che indicano quali membri contengono informazioni valide. Questo membro deve essere compilato prima di inviare il messaggio associato. Può trattarsi di uno o più dei valori seguenti.

Valore Significato
TBIF_BYINDEX

Versione 5.80. Il wParam inviato con un messaggio TB_GETBUTTONINFO o TB_SETBUTTONINFO è un indice, non un identificatore.
TBIF_COMMAND
 Il membro idCommand contiene informazioni valide o viene richiesto.
TBIF_IMAGE
 Il membro iImage contiene informazioni valide o viene richiesto.
TBIF_LPARAM
 Il membro lParam contiene informazioni valide o viene richiesto.
TBIF_SIZE
 Il membro cx contiene informazioni valide o viene richiesto.
TBIF_STATE
 Il membro fsState contiene informazioni valide o viene richiesto.
TBIF_STYLE
 Il membro fsStyle contiene informazioni valide o viene richiesto.
TBIF_TEXT
 Il membro pszText contiene informazioni valide o viene richiesto.

idCommand

Tipo: int

Identificatore del comando del pulsante.

iImage

Tipo: int

Indice immagine del pulsante. Impostare questo membro su I_IMAGECALLBACK e la barra degli strumenti invierà il codice di notifica TBN_GETDISPINFO per recuperare l'indice dell'immagine quando necessario.

versione 5.81. Impostare questo membro su I_IMAGENONE per indicare che il pulsante non dispone di un'immagine. Il layout del pulsante non includerà spazio per una bitmap, solo testo.

fsState

Tipo: BYTE

Flag di stato del pulsante. Può trattarsi di uno o più valori elencati in Stati pulsante barra degli strumenti.

fsStyle

Tipo: BYTE

Flag di stile del pulsante. Può trattarsi di uno o più valori elencati in Controllo barra degli strumenti e Stili pulsante.

cx

Tipo: WORD

Larghezza del pulsante, in pixel.

lParam

Tipo: DWORD_PTR

Valore definito dall'applicazione associato al pulsante.

pszText

Tipo: LPTSTR

Indirizzo di un buffer di caratteri che contiene o riceve il testo del pulsante.

cchText

Tipo: int

Dimensione del buffer in corrispondenza di pszText. Se vengono impostate le informazioni sul pulsante, questo membro viene ignorato.

Osservazioni

Nota

L'intestazione commctrl.h definisce TBBUTTONINFO come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows Vista [solo app desktop]
server minimo supportato Windows Server 2003 [solo app desktop]
intestazione commctrl.h