Compartilhar via


TabCtrl_InsertItem macro (commctrl.h)

Insere uma nova guia em um controle de tabulação. Você pode usar essa macro ou enviar a mensagem TCM_INSERTITEM explicitamente.

Sintaxe

int TabCtrl_InsertItem(
         HWND     hwnd,
         int      iItem,
   const LPTCITEM pitem
);

Parâmetros

hwnd

Tipo: HWND

Manipule para o controle tab.

iItem

Tipo: int

Índice da nova guia.

pitem

Tipo: const LPTCITEM

Ponteiro para uma estrutura TCITEM que especifica os atributos da guia. Os dwState e dwStateMask membros dessa estrutura são ignorados por esta mensagem.

Valor de retorno

Tipo: int

Retorna o índice da nova guia se tiver êxito ou -1 caso contrário.

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