CHeaderCtrl::GetOverflowRect
Ruft das umschließende Rechteck der Überlaufschaltfläche des aktuellen Zeilen- ab.
BOOL GetOverflowRect(
LPRECT lpRect
) const;
Parameter
Parameter |
Description |
|---|---|
[out] lpRect |
Zeiger auf eine RECT-Struktur, die die Informationen des umgebenden Rechtecks abruft. |
Rückgabewert
true, wenn diese Funktion erfolgreich; andernfalls false.
Hinweise
Wenn das Header-Steuerelement mehr Elemente enthält, als gleichzeitig angezeigt werden kann, kann das Steuerelement eine Überlaufschaltfläche anzeigen, die den Elementen durch Vergrößern, die nicht sichtbar sind.Das Header-Steuerelement muss die HDS_OVERFLOW und HDF_SPLITBUTTON Formate aufweisen, um die Überlaufschaltfläche anzuzeigen.Das umschließende Rechteck enthält die Überlaufschaltfläche ein und ist nur, wenn die Überlaufschaltfläche angezeigt wird.Weitere Informationen finden Sie unter Header Control Styles.
Diese Methode sendet die HDM_GETOVERFLOWRECT Meldung, die im Windows SDK beschrieben wird.
Anforderungen
Header: afxcmn.h
Dieses Steuerelement 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 GetOverflowRect-Methode veranschaulicht.In einem früheren Codeabschnitt erstellt haben, wird ein Header-Steuerelement mit fünf Spalten.Sie können jedoch ein Spaltentrennzeichen ziehen, damit die Spalte nicht sichtbar ist.Wenn einige Spalten nicht sichtbar sind, zeichnet das Header-Steuerelement eine Überlaufschaltfläche angezeigt.Im folgenden Codebeispiel wird ein 3D-Rechteck um den Speicherort der angezeigt.
void CNVC_MFC_CHeaderCtrl_s4Dlg::OnXGetoverflowrect()
{
if (controlCreated == FALSE) {
MessageBox(_T("Header control has not been created yet."));
return;
}
CRect rect;
// Get the overflow rectangle.
BOOL bRetVal = m_headerCtrl.GetOverflowRect(&rect);
// Get the device context.
CDC* pDC = m_headerCtrl.GetDC();
// Draw around the overflow rect a rectangle that has red
// left and top sides, and green right and bottom sides.
pDC->Draw3dRect(rect, RGB(255, 0, 0), RGB(0, 255, 0));
}