CHeaderCtrl::GetItem

检索有关标头控制的项的信息。

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

参数

  • nPos
    指定项的从零开始的索引检索。

  • pHeaderItem
    用于接收新项目的 HDITEM 结构的指针。 此机制用于 InsertItemSetItem 成员函数。 在 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