CTabCtrl::GetItem

Article
06/10/2015

Récupère des informations sur un onglet dans un contrôle onglet.

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

Paramètres

nItem
Index de base zéro de la table.
pTabCtrlItem
Pointeur vers une structure de TCITEM , 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 InsertItem, GetItemles fonctions membres, et d' SetItem .

Valeur de retour

Retourne TRUE si l'opération a réussi ; FALSE sinon.

Notes

Lorsque le message est envoyé, le membre de MASK spécifie que l'attribut au retour. Si le membre de MASK spécifie la valeur d' TCIF_TEXT , le membre de pszText doit contenir l'adresse de la mémoire tampon qui accepte le texte de l'élément et le membre de cchTextMax doit spécifier la taille de la mémoire tampon.

masque
Évaluez spécifier les membres de structures d' TCITEM à récupérer ou définir. Ce membre peut être zéro ou une combinaison des valeurs suivantes :
- TCIF_TEXT le membre de pszText est valide.
- TCIF_IMAGE le membre d' iImage est valide.
- TCIF_PARAM le membre de LPARAM est valide.
- TCIF_RTLREADING le texte de pszText est restitué à l'aide de l'ordre de lecture de droite à gauche sur les systèmes hébreux ou arabes.
- TCIF_STATE le membre de dwState est valide.
pszText
Pointeur vers une chaîne terminée par le caractère NULL qui contient le texte de l'onglet si la structure contient des informations sur une table. Si la structure accepte les informations, ce membre spécifie l'adresse de la mémoire tampon qui accepte le texte d'onglet.
cchTextMax
La taille de la mémoire tampon a globale pointe vers pszText. Ce membre est ignoré si la structure n'accepte pas les informations.
iImage
Index dans la liste d'images du contrôle onglet, ou – 1 s'il n'existe aucune image pour la table.
lParam
Données définies par l'application associées à la table. s'il y a plus de quatre octets de données définies par l'application par onglet, une application doit définir une structure et l'utiliser au lieu de la structure d' TCITEM . Le premier membre de la structure définie par l'application doit être une structure de TCITEMHEADER. La structure de TCITEMHEADER identique à la structure d' TCITEM , mais sans membre de LPARAM . La différence entre la taille de votre structure et la taille de la structure de TCITEMHEADER doit être égal au nombre d'octets supplémentaires par table.

Exemple

// In this example a CTabCtrl data member, m_TabCtrl, changes the 
// text of the tabs in the tab control.  A call to GetItem is used 
// to get the current text, and then the text is changed.  A call  
// to SetItem is used to update the tab with the new text. 

void CTabDlg::OnChangeItem()
{
   TCITEM tcItem;
   CString pszString;

   //  Get text for the tab item.
   GetDlgItemText(IDC_ITEM_TEXT, pszString);

   //  Get the current tab item text.
   TCHAR buffer[256] = {0};
   tcItem.pszText = buffer;
   tcItem.cchTextMax = 256;
   tcItem.mask = TCIF_TEXT;
   m_TabCtrl.GetItem(0, &tcItem);
   TRACE(_T("Changing item text from %s to %s..."), tcItem.pszText, pszString);

   //  Set the new text for the item.
   tcItem.pszText = pszString.LockBuffer();

   //  Set the item in the tab control.
   m_TabCtrl.SetItem(0, &tcItem);

   pszString.UnlockBuffer();
}