CHeaderCtrl::HitTest
Détermine que l'élément d'en-tête, le cas échéant, se trouve à un point spécifié.
int HitTest(
LPHDHITTESTINFO* phdhti
);
Paramètres
Paramètre |
Description |
|---|---|
[in, out] phdhti |
Le pointeur vers une structure de HDHITTESTINFO qui spécifie le point de test et reçoit les résultats du test. |
Valeur de retour
l'index de base zéro de l'élément d'en-tête, le cas échéant, à la position spécifiée ; sinon, – 1.
Notes
Cette méthode envoie le message de HDM_HITTEST , qui est décrit dans Kit de développement logiciel Windows.
Configuration requise
en-tête : afxcmn.h
Cette méthode est prise en charge dans Windows NT 3,51 et versions ultérieures.
Exemple
l'exemple de code suivant définit la variable, m_headerCtrl, qui est utilisée pour accéder au contrôle header actuel. Cette variable est utilisée dans l'exemple suivant.
CHeaderCtrl m_headerCtrl;
CSplitButton m_splitButton;
L'exemple de code suivant illustre la méthode HitTest. Dans la première section de l'exemple de code, nous avons créé un contrôle header avec cinq colonnes. Toutefois, vous pouvez faire glisser un séparateur de colonne afin que la colonne n'est pas visible. Cet exemple stocke l'index de la colonne s'il est visible et -1 si la colonne n'est pas visible.
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"));
}