macro TabCtrl_InsertItem (commctrl.h)

Insère un nouvel onglet dans un contrôle Tab. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_INSERTITEM.

Syntaxe

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

Paramètres

hwnd

Type : HWND

Gérez le contrôle Tab.

iItem

Type : int

Index du nouvel onglet.

pitem

Type : const LPTCITEM

Pointeur vers une structure TCITEM qui spécifie les attributs de l’onglet. Les dwState et dwStateMask membres de cette structure sont ignorés par ce message.

Valeur de retour

Type : int

Retourne l’index du nouvel onglet en cas de réussite, ou -1 sinon.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	commctrl.h