Compartilhar via


TabCtrl_SetItemExtra macro (commctrl.h)

Define o número de bytes por guia reservado para dados definidos pelo aplicativo em um controle tab. Você pode usar essa macro ou enviar a mensagem TCM_SETITEMEXTRA explicitamente.

Sintaxe

BOOL TabCtrl_SetItemExtra(
   HWND hwndTC,
   int  cb
);

Parâmetros

hwndTC

Tipo: HWND

Manipule para o controle tab.

cb

Tipo: int

Número de bytes extras.

Valor de retorno

Tipo: BOOL

Retorna TRUE se tiver êxito ou false caso contrário.

Observações

Por padrão, o número de bytes extras é quatro. Um aplicativo que altera o número de bytes extras não pode usar a estrutura TCITEM para recuperar e definir os dados definidos pelo aplicativo para uma guia. Em vez disso, você deve definir uma nova estrutura que consiste na estrutura TCITEMHEADER seguida por membros definidos pelo aplicativo.

Um aplicativo só deve alterar o número de bytes extras quando um controle de tabulação não contiver guias.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho commctrl.h