CHeaderCtrl::GetItemDropDownRect
Ruft das umschließende Rechteck der Dropdownschaltfläche für ein Headerelement im aktuellen Header-Steuerelement ab.
BOOL GetItemDropDownRect(
int iItem,
LPRECT lpRect
) const;
Parameter
Parameter |
Description |
|---|---|
[in] iItem |
Der nullbasierte Index Headerelements, dessen Format HDF_SPLITBUTTON ist.Weitere Informationen finden Sie im fmt-Member der HDITEM-Struktur. |
[out] lpRect |
Zeiger auf eine RECT-Struktur, um die Informationen des umgebenden Rechtecks zu erhalten. |
Rückgabewert
true, wenn diese Funktion erfolgreich; andernfalls false.
Hinweise
Diese Methode sendet die HDM_GETITEMDROPDOWNRECT Meldung, die im Windows SDK beschrieben wird.
Anforderungen
Header: afxcmn.h
Diese Methode wird in Windows Vista und höher unterstützt.
Zusätzliche Anforderungen für diese Methode werden in Build-Anforderungen für Windows Vista-gemeinsame Regelungen beschrieben.
Beispiel
Im folgenden Codebeispiel wird die Variable, m_headerCtrl, die verwendet wird, um auf das aktuelle Header-Steuerelement zuzugreifen.Diese Variable wird im folgenden Beispiel verwendet.
CHeaderCtrl m_headerCtrl;
CSplitButton m_splitButton;
Im folgenden Codebeispiel wird die GetItemDropDownRect-Methode veranschaulicht.In einem früheren Codeabschnitt erstellt haben, wird ein Header-Steuerelement mit fünf Spalten.Im folgenden Codebeispiel wird ein 3D-Rechteck um den Speicherort auf der ersten Spalte, die für die Headerdropdownschaltfläche reserviert ist.
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));
}
}