CHeaderCtrl::GetItem

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ヘッダーコントロールの項目についての情報を取得します。

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

パラメータ

nPos
取得する項目の 0 から始まるインデックスを指定します。
pHeaderItem
新しい項目を受け取る HDITEM 構造体へのポインタ。この構造体は、InsertItem メンバ関数および SetItem メンバ関数でも使います。mask 要素にフラグを設定すると、対応する要素の値が正しく返されます。mask 要素を 0 に設定すると、ほかの構造体要素の値が無意味になります。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 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;
   }
}