すべてのヘッダー項目がある場合、指定した位置によって決まります。
int HitTest(
LPHDHITTESTINFO* phdhti
);
パラメーター
パラメーター |
説明 |
|---|---|
[入力、出力] phdhti |
テストするポイントを指定するテストの結果を受け取り、HDHITTESTINFO 構造体へのポインター。 |
戻り値
指定した位置のヘッダー項目のインデックス (存在する場合) ; それ以外の場合は、– 1。
解説
このメソッドは Windows SDKで説明する HDM_HITTEST のメッセージを送信します。
必要条件
ヘッダー: afxcmn.h
このメソッドは、Windows NT 3.51 以降でサポートされます。
使用例
次のコード例は、現在のヘッダー コントロールへのアクセスに使用される変数、m_headerCtrlを定義します。この変数は次のように使用されます。
CHeaderCtrl m_headerCtrl;
CSplitButton m_splitButton;
HitTest メソッドのコード例を次に示します。このコード例では、前のセクションでは、5 列のヘッダー コントロールを作成しました。ただし列が表示されないように、列の区分線をドラッグできます。この例では、列が表示されていない場合は表示され、-1 で、列のインデックスを取得します。
void CNVC_MFC_CHeaderCtrl_s4Dlg::OnXHittest()
{
if (controlCreated == FALSE) {
MessageBox(_T("Header control has not been created yet."));
return;
}
// Initialize HDHITTESTINFO structure.
HDHITTESTINFO hdHitIfo;
memset(&hdHitIfo, 0, sizeof(HDHITTESTINFO));
CString str;
CRect rect;
int iRetVal = -1;
for(int i = 0; i < m_headerCtrl.GetItemCount(); i++)
{
m_headerCtrl.GetItemRect(i, &rect);
hdHitIfo.pt = rect.CenterPoint();
// The hit test depends on whether the header item is visible.
iRetVal = m_headerCtrl.HitTest(&hdHitIfo);
str.AppendFormat(_T("Item = %d, Hit item = %d\n"), i, iRetVal);
}
MessageBox(str, _T("Hit test results"));
}