macro TabCtrl_SetItemExtra (commctrl.h)

Imposta il numero di byte per scheda riservati ai dati definiti dall'applicazione in un controllo struttura a schede. È possibile utilizzare questa macro o inviare il messaggio di TCM_SETITEMEXTRA in modo esplicito.

Sintassi

BOOL TabCtrl_SetItemExtra(
   HWND hwndTC,
   int  cb
);

Parametri

hwndTC

Tipo: HWND

Handle per il controllo struttura a schede.

cb

Tipo: int

Numero di byte aggiuntivi.

Valore restituito

Tipo: BOOL

Restituisce TRUE in caso di esito positivo oppure FALSE in caso contrario.

Osservazioni

Per impostazione predefinita, il numero di byte aggiuntivi è quattro. Un'applicazione che modifica il numero di byte aggiuntivi non può utilizzare la struttura TCITEM per recuperare e impostare i dati definiti dall'applicazione per una scheda. È invece necessario definire una nuova struttura costituita dalla struttura TCITEMHEADER seguita dai membri definiti dall'applicazione.

Un'applicazione deve modificare solo il numero di byte aggiuntivi quando un controllo struttura a schede non contiene schede.

Fabbisogno

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