CHeaderCtrl::GetItemDropDownRect
Obtient le rectangle englobant du bouton déroulant pour un élément d'en-tête dans le contrôle header actuel.
BOOL GetItemDropDownRect(
int iItem,
LPRECT lpRect
) const;
Paramètres
Paramètre |
Description |
|---|---|
[in] iItem |
Index de base zéro d'un élément d'en-tête dont le style est HDF_SPLITBUTTON. Pour plus d'informations, consultez le membre d' fmt de la structure de HDITEM . |
[out] lpRect |
Pointeur vers une structure de RECT pour recevoir les informations du rectangle englobant. |
Valeur de retour
true si cette fonction est réussie ; sinon, false.
Notes
Cette méthode envoie le message de HDM_GETITEMDROPDOWNRECT , qui est décrit dans Kit de développement logiciel Windows.
Configuration requise
en-tête : afxcmn.h
Cette méthode est prise en Windows Vista et versions ultérieures.
Les spécifications supplémentaires pour cette méthode sont décrites dans Spécifications pour la génération des contrôles communs Windows Vista.
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 GetItemDropDownRect. Dans la première section de code, nous avons créé un contrôle header avec cinq colonnes. L'exemple de code suivant dessine un rectangle 3D autour de l'emplacement dans la première colonne qui est réservée le bouton déroulant d'en-tête.
void CNVC_MFC_CHeaderCtrl_s4Dlg::OnXGetitemdropdownrect()
{
if (controlCreated == FALSE) {
MessageBox(_T("Header control has not been created yet."));
return;
}
// Get the dropdown rect for the first column.
CRect rect;
BOOL bRetVal = m_headerCtrl.GetItemDropDownRect(0, &rect);
if (bRetVal == TRUE) {
// Draw around the dropdown rect a rectangle that has red
// left and top sides, and blue right and bottom sides.
CDC* pDC = m_headerCtrl.GetDC();
pDC->Draw3dRect(rect, RGB(255, 0, 0), RGB(0, 0, 255));
}
}