CListCtrl::GetItemIndexRect

Artykuł
02/27/2013

Pobiera prostokąta obwiedni dla wszystkich lub części podpozycji bieżącego formantu widoku listy.

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

Parametry

Parametr	Opis
[w]pItemIndex	Wskaźnik do LVITEMINDEX struktury dla zapasu nadrzędnego podelement. Obiekt wywołujący jest odpowiedzialny za przydzielanie i ustawienie członków LVITEMINDEX struktury.Ten parametr nie może być NULL.
[w]iColumn	Indeksu kolumny w formancie.
[w]rectType	Część podelementu widoku listy, dla której jest pobierana prostokąta obwiedni.Określ jeden z następujących wartości: LVIR_BOUNDS-Zwraca prostokąta obwiedni całego podpozycji, łącznie z ikony i etykiety. LVIR_ICON-Zwraca ikonę lub mała ikona podelement prostokąta obwiedni. LVIR_LABEL-Zwraca prostokąta obwiedni tekstu podelement.
[out]pRect	Wskaźnik RECT strukturę, która otrzymuje informacje na temat prostokąta obwiedni podelement. Obiekt wywołujący jest odpowiedzialny za przydzielanie RECT struktury.Ten parametr nie może być NULL.

Wartość zwracana

trueJeśli ta metoda jest pomyślne; w przeciwnym razie false.

Uwagi

Metoda ta wysyła LVM_GETITEMINDEXRECT wiadomości, która jest opisana w Windows SDK. Aby uzyskać więcej informacji, zobacz Makro ListView_GetItemIndexRect.

Wymagania

Nagłówek: afxcmn.h

Ten formant jest obsługiwany w Windows Vista i później.

Dodatkowe wymagania dla tej metody opisane w Budowanie wymagania dla systemu Windows Vista wspólnej kontroli.

Przykład

Poniższy przykład kodu definiuje zmienną, m_listCtrl, czyli używane do bieżącego widoku listy kontroli dostępu.Ta zmienna jest używana w następnym przykładzie.

public:
    // Variable used to access the list control.
    CListCtrl m_listCtrl;

Poniższy przykład kodu pokazuje GetGroupRect metody.Przed wprowadzeniem tego kodu przykładu, że utworzyliśmy formantu widoku listy wyświetla dwie kolumny zatytułowanej "ClientID" i "Klasa" w widoku raportu.Poniższy kod rysuje 3D prostokąt wokół drugiego podelementu w obu kolumnach.

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