macro TabCtrl_InsertItem (commctrl.h)

Inserta una nueva pestaña en un control de pestaña. Puede usar esta macro o enviar el mensaje TCM_INSERTITEM explícitamente.

Sintaxis

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

Parámetros

hwnd

Tipo: HWND

Control para el control de tabulación.

iItem

Tipo: int

Índice de la nueva pestaña.

pitem

Tipo: const LPTCITEM

Puntero a una estructura de TCITEM que especifica los atributos de la pestaña. El dwState y dwStateMask miembros de esta estructura se omiten mediante este mensaje.

Valor devuelto

Tipo: int

Devuelve el índice de la nueva pestaña si se ejecuta correctamente o -1 de lo contrario.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	commctrl.h