CListCtrl::GetItemIndexRect

Ruft das umschließende Rechteck für alle oder nur einen Teil eines Unterelements im aktuellen Listenansicht-Steuerelement ab.

BOOL GetItemIndexRect(
     PLVITEMINDEX pItemIndex, 
     int iColumn, 
     int rectType, 
     LPRECT pRect
) const;

Parameter

Parameter

Description

[in] pItemIndex

Zeiger auf eine Struktur LVITEMINDEX für das übergeordnete Element des Unterelements.

Der Aufrufer ist für das Zuordnen und Festlegen der Member der Struktur LVITEMINDEX zuständig.Dieser Parameter darf nicht NULL sein.

[in] iColumn

Der nullbasierte Index einer Spalte im - Steuerelement.

[in] rectType

Teil des Listenansichtsunterelements, für das das umschließende Rechteck abgerufen wird.Geben Sie einen der folgenden Werte an:

LVIR_BOUNDS - EINGABETASTE das umschließende Rechteck des gesamten Unterelements, einschließlich das Symbol und die Bezeichnung.

LVIR_ICON - EINGABETASTE des umschließenden Rechtecks des Symbols oder des Symbols kleinen des Unterelements.

LVIR_LABEL - EINGABETASTE des umschließenden Rechtecks des Unterelementtexts.

[out] pRect

Zeiger auf eine RECT-Struktur, die Informationen über das umschließende Rechteck des Unterelements abruft.

Der Aufrufer ist für die Zuordnung der RECT-Struktur zuständig.Dieser Parameter darf nicht NULL sein.

Rückgabewert

true, wenn diese Methode erfolgreich ist; andernfalls false.

Hinweise

Diese Methode sendet die LVM_GETITEMINDEXRECT Meldung, die im Windows SDK beschrieben wird. Weitere Informationen finden Sie unter ListView_GetItemIndexRect-Makro

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.Vor dem Eingeben des Codebeispiels erstellt haben wir ein ListView-Steuerelement, das Anzeigen zwei Spalten "ClientID" und "Grad" in einer Berichtsansicht Titel.Im folgenden Codebeispiel wird ein 3D-Rechteck um das zweite Unterelement in beiden Spalten.

    // GetItemIndexRect
    // Get the rectangle that bounds the second item in the first group.
    LVITEMINDEX lvItemIndex;
    lvItemIndex.iGroup = 0;
    lvItemIndex.iItem = 1;
    CRect rect;
    BOOL bRet = m_listCtrl.GetItemIndexRect(
        &lvItemIndex, 0, LVIR_BOUNDS, &rect);

    // Draw a red rectangle around the item.
    m_listCtrl.GetDC()->Draw3dRect( &rect, RGB(255, 0, 0), RGB(255, 0, 0) );

Siehe auch

Referenz

CListCtrl-Klasse

Hierarchien-Diagramm

LVM_GETITEMINDEXRECT

LVITEMINDEX

RECT

ListView_GetItemIndexRect-Makro