Compartilhar via

CHeaderCtrl::GetItem

  • Artigo

Recupera informações sobre um item de controle header.

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

Parâmetros

  • nPos
    Especifica o índice com base zero de item para recuperar.

  • pHeaderItem
    Ponteiro a estrutura de HDITEM que recebe o novo item.Essa estrutura é usada com as funções de membro de InsertItem e de SetItem .Todos os sinalizadores definidos no elemento de mask garantem que os valores nos elementos correspondentes estão preenchidos corretamente em cima de retorno.Se o elemento de mask é definido como zero, os valores nos outros elementos de estrutura não possuem sentido.

Valor de retorno

Diferente de zero se com êxito; se não 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;
   }
}

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

Classe de CHeaderCtrl

Gráfico de hierarquia

CHeaderCtrl::SetItem