Share via


CHeaderCtrl::GetItem

Recupera informazioni su un elemento del controllo intestazione.

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

Parametri

  • nPos
    Specifica l'indice in base zero dell'elemento da recuperare.

  • pHeaderItem
    Puntatore a una struttura HDITEM che riceve il nuovo elemento.Questa struttura viene utilizzata con le funzioni membro SetItem e InsertItem.Qualsiasi contrassegna il set nell'elemento della maschera garantisce che i valori negli elementi corrispondenti correttamente sono riempiti da restituire.Se l'elemento della maschera è impostato su zero, i valori di altri elementi della struttura non sono necessari.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Esempio

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

Requisiti

Header: afxcmn.h

Vedere anche

Riferimenti

Classe di CHeaderCtrl

Grafico della gerarchia

CHeaderCtrl::SetItem