CHeaderCtrl::GetItem

Ruft Informationen über ein Header-Steuerelement-Element ab.

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

Parameter

• nPos
  Gibt den nullbasierten Index des Elements an, um abzurufen.

• pHeaderItem
  Zeiger auf eine HDITEM-Struktur, die den neuen Artikel empfängt.Diese Struktur wird mit den InsertItem und SetItem-Memberfunktionen verwendet.Alle kennzeichnet Satz im mask-Element sicherstellen, dass Werte in den entsprechenden Elementen ordnungsgemäß nach Rückgabe gefüllt werden.Wenn das Element mask auf Null angegeben wird, sind Werte in den anderen Strukturelementen bedeutungslos.

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; 0 andernfalls.

Beispiel

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;
   }
}

Anforderungen

Header: afxcmn.h

Siehe auch

Referenz

CHeaderCtrl-Klasse

Hierarchien-Diagramm

CHeaderCtrl::SetItem