CHeaderCtrl::GetItem

Artigo
08/25/2010

Recupera informações sobre um item de controle de cabeçalho.

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

Parâmetros

nPos
Especifica o índice do item para recuperar com base em zero.
pHeaderItem
Ponteiro para um HDITEMestrutura de recebe o novo item.Essa estrutura é usada com o InsertItem e SetItem funções de membro. Os sinalizadores conjunto no máscara elemento Certifique-se de que valores nos elementos correspondentes são preenchidos corretamente após retornar.Se o máscara elemento é conjunto como zero, valores de outros elementos de estrutura são sem sentido.

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário, 0.

Exemplo

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