Condividi tramite


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 CHeaderCtrl

Grafico delle gerarchie

CHeaderCtrl::SetItem