CTabCtrl::GetItem

BOOL GetItem ( int nItem, TCITEM * pTabCtrlItem ) const ;

Valeur de retour

Retourne TRUE en cas de succès ; FALSE sinon.

Paramètres

nItem

Index de base zéro de l'onglet.

pTabCtrlItem

Pointeur vers un TCITEM structure, utilisée pour spécifier les informations à récupérer. Également utilisé pour recevoir des informations sur l'onglet. Cette structure est utilisée avec les fonctions de membre InsertItem GetItemet SetItem.

Remarques

Appelez cette fonction pour récupérer des informations sur un onglet dans un contrôle onglet.

Lorsque le message est envoyé, le membre de masque spécifie quels attributs à retourner. Si le membre masque spécifie la valeur TCIF_TEXT , le membre pszText doit contenir l'adresse de la mémoire tampon qui reçoit le texte de l'élément et le membre cchTextMax doit spécifier la taille de la mémoire tampon.

masque

Valeur spécifiant les membres de la structure TCITEM pour récupérer ou définir. Ce membre peut être zéro ou une combinaison des valeurs suivantes:

• TCIF_TEXT  ;  Le membre pszText est valide.
  
  
• TCIF_IMAGE  ;  Membre de l'iImage est valide.
  
  
• TCIF_PARAM  ;  Le membre lParam est valide.
  
  
• TCIF_RTLREADI&NGnbsp ;  Le texte de pszText est affiché à l'aide de l'ordre de lecture de droite à gauche sur les systèmes de l'hébreu ou l'arabe.
  
  
• TCIF_STATE  ;  Le membre dwState est valide.

pszText

Pointeur vers une chaîne terminée par null, contenant le texte de l'onglet si la structure contient des informations sur un onglet. Si la structure est recevoir de l'information, ce membre spécifie l'adresse de la mémoire tampon qui reçoit le texte de l'onglet.

cchTextMax

Taille de la mémoire tampon pointé par pszText. Ce membre est ignoré si la structure ne reçoit pas d'informations.

iImage

I&ndex dans la liste d'images du contrôle onglet, ornbsp ; – 1 si il n'y a aucune image de l'onglet.

lParam

Données définies par l'application associées à l'onglet. Si il n'y a plus de quatre octets de données définie par l'application par onglet, une application doit définir une structure et l'utiliser au lieu de la structure TCITEM . Le premier membre de la structure définie par l'application doit être une structure TCITEMHEADER . La structure TCITEMHEADER est identique à la structure TCITEM , mais sans le membre lParam . La différence entre la taille de votre structure et la taille de la structure TCITEMHEADER doit être égal au nombre d'octets supplémentaires par onglet.

CTabCtrl aperçu |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CTabCtrl::InsertItem, CTabCtrl::SetItem