Partager via


CHeaderCtrl::GetItem

Récupère des informations sur un élément de contrôle header.

BOOL GetItem( 
   int nPos, 
   HDITEM* pHeaderItem  
) const;

Paramètres

  • nPos
    Spécifie l'index de base zéro de l'élément à récupérer.

  • pHeaderItem
    Pointeur vers une structure de HDITEM qui accepte le nouvel élément. Cette structure est utilisée avec les fonctions membres d' InsertItem et d' SetItem . Toutes les balises affectez à l'élément de MASK garantissent que des valeurs dans les éléments correspondants sont correctement fournies lors de le retour. Si l'élément de MASK a la valeur zéro, les valeurs des autres éléments de structure sont sans signification.

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon 0.

Exemple

LPCTSTR lpszmyString = _T("column 2");
LPCTSTR lpszmyString2 = _T("vertical 2");

// Find the item whose text matches lpszmyString, and  
// replace it with lpszmyString2. 
int    i, nCount = m_myHeaderCtrl.GetItemCount();
HDITEM hdi;
enum   { sizeOfBuffer = 256 };
TCHAR  lpBuffer[sizeOfBuffer];
bool   fFound = false;

hdi.mask = HDI_TEXT;
hdi.pszText = lpBuffer;
hdi.cchTextMax = sizeOfBuffer;

for (i=0; !fFound && (i < nCount); i++)
{
   m_myHeaderCtrl.GetItem(i, &hdi);

   if (_tcsncmp(hdi.pszText, lpszmyString, sizeOfBuffer) == 0)
   {
      _tcscpy_s(hdi.pszText, sizeOfBuffer, lpszmyString2);
      m_myHeaderCtrl.SetItem(i, &hdi);
      fFound = true;
   }
}

Configuration requise

Header: afxcmn.h

Voir aussi

Référence

CHeaderCtrl, classe

Graphique de la hiérarchie

CHeaderCtrl::SetItem