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
TBIF_BYINDEX

Versione 5.80. WParam inviato con un messaggio di 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à 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