Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ruft das umschließende Rechteck für eine angegebene Gruppe im aktuellen Listenansicht-Steuerelement ab.
BOOL GetGroupRect(
int iGroupId,
LPRECT lpRect,
int iCoords = LVGGR_GROUP
) const;
Parameter
Parameter |
Description |
|---|---|
[in] iGroupId |
Gibt eine Gruppe an. |
[in, out] lpRect |
Zeiger auf eine Struktur RECT.Wenn diese Methode erfolgreich ist, empfängt die Struktur die Rechteckkoordinaten der Gruppe, die von iGroupId angegeben wird. |
[in] iCoords |
Gibt die Rechteckkoordinaten an, um abzurufen.Verwendung einer dieser Werte:
|
Rückgabewert
true, wenn diese Methode erfolgreich ist; andernfalls false.
Hinweise
Der Aufrufer ist für die Zuordnung der RECT-Struktur verantwortlich, die von dem pRect-Parameter angezeigt wird.
Diese Methode sendet die LVM_GETGROUPRECT 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 eine Variable, m_listCtrl, die verwendet wird, um auf das aktuelle Listenansicht-Steuerelement zuzugreifen.Diese Variable wird im folgenden Beispiel verwendet.
public:
// Variable used to access the list control.
CListCtrl m_listCtrl;
Im folgenden Codebeispiel wird die GetGroupRect-Methode veranschaulicht.In einem früheren Abschnitt dieses Codebeispiels erstellt haben, wird ein ListView-Steuerelement, das Anzeigen zwei Spalten "ClientID" und "Grad" in einer Berichtsansicht Titel.Im folgenden Codebeispiel wird ein 3D-Rechteck um die Gruppe, deren Index 0, wenn eine Gruppe vorhanden ist.
// GetGroupRect
// Get the graphics rectangle that surrounds group 0.
CRect rect;
BOOL bRet = m_listCtrl.GetGroupRect( 0, &rect, LVGGR_GROUP);
// Draw a blue rectangle around group 0.
if (bRet == TRUE) {
m_listCtrl.GetDC()->Draw3dRect( &rect, RGB(0, 0, 255), RGB(0, 0, 255));
}
else {
AfxMessageBox(_T("No group information was retrieved."), MB_ICONINFORMATION);
}