CHeaderCtrl::GetItemDropDownRect

Artikel
02/26/2013

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));
    }
}