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