Поделиться через


CHeaderCtrl::GetItem

Извлекает сведения об элементе управления заголовка.

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

Параметры

  • nPos
    Определяет нулевой- на основе индекс извлекаемого элемента.

  • pHeaderItem
    Указатель на структуру HDITEM, которая получает новый элемент.Эта структура используется с функции-членами InsertItem и SetItem.Любое пометит задано в элементе MASK гарантирует, что значения в соответствующих элементах правильно заполняются при возврате.Если элемент MASK устанавливается равным нулю, то значения в других элементах структуры несмысловы.

Возвращаемое значение

Ненулевой, если успешно; в противном случае – значение 0.

Пример

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

Требования

Header: afxcmn.h

См. также

Ссылки

Класс CHeaderCtrl

Диаграмма иерархии

CHeaderCtrl::SetItem