Struttura TBBUTTONINFOA (commctrl.h)
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;
LPSTR pszText;
int cchText;
} TBBUTTONINFOA, *LPTBBUTTONINFOA;
Members
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 |
---|---|
|
Versione 5.80. WParam inviato con un messaggio di TB_GETBUTTONINFO o TB_SETBUTTONINFO è un indice, non un identificatore. |
|
Il membro idCommand contiene informazioni valide o viene richiesto. |
|
Il membro iImage contiene informazioni valide o viene richiesto. |
|
Il membro lParam contiene informazioni valide o viene richiesto. |
|
Il membro cx contiene informazioni valide o viene richiesto. |
|
Il membro fsState contiene informazioni valide o viene richiesto. |
|
Il membro fsStyle contiene informazioni valide o viene richiesto. |
|
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à alcuno 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
Dimensioni del buffer in corrispondenza di pszText. Se vengono impostate le informazioni sul pulsante, questo membro viene ignorato.
Commenti
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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
Client minimo supportato | Windows Vista [solo app desktop] |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Intestazione | commctrl.h |