CListCtrl::GetItemIndexRect

아티클
02/21/2013

현재 목록 보기 컨트롤에서 하위 항목의 전체 또는 일부에 대 한 경계 사각형을 검색합니다.

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

매개 변수

Parameter	설명
[in] pItemIndex	포인터는 LVITEMINDEX 하위 항목의 부모 항목에 대 한 구조. 호출자가 할당 하 고 멤버의 설정에 대 한 책임이 있는 LVITEMINDEX 구조.이 매개 변수는 NULL일 수 없습니다.
[in] iColumn	컨트롤에 있는 열의 인덱스입니다.
[in] rectType	목록 보기 하위 항목의 경계 사각형을 검색 하는 부분입니다.다음 값 중 하나를 지정합니다. LVIR_BOUNDS-아이콘 및 레이블을 포함 하 여 전체 하위 항목의 경계 사각형을 반환 합니다. LVIR_ICON-아이콘 또는 작은 아이콘의 하위 항목의 경계 사각형을 반환합니다. LVIR_LABEL-하위 항목 텍스트의 경계 사각형을 반환합니다.
[out] pRect	포인터는 RECT 하위 항목의 경계 사각형에 대 한 정보를 수신 하는 구조입니다. 호출자 할당에 대 한 책임을 지지는 RECT 구조.이 매개 변수는 NULL일 수 없습니다.

반환 값

true이 방법에 성공 하면. 그렇지 않으면 false.

설명

보내는이 메서드는 LVM_GETITEMINDEXRECT 에서 설명 하는 메시지는 Windows SDK. 자세한 내용은 ListView_GetItemIndexRect 매크로.

요구 사항

헤더: afxcmn.h

이 컨트롤에서 지 Windows Vista 이상.

이 메서드에 대 한 추가 요구 사항에서 설명 빌드 Windows Vista 공용 컨트롤을 위한 요구 사항.

예제

다음 코드 예제에서는 변수 정의 m_listCtrl, 즉 현재 목록 뷰 컨트롤에 액세스 하는 데 사용 합니다.이 변수는 다음 예제에 사용 됩니다.

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

다음 코드 예제에서는 GetGroupRect 메서드를 사용하는 방법을 보여 줍니다.이 코드를 입력 하기 전에 예제에서는 목록 뷰 컨트롤 작성 "ClientID" 및 "등급" 보고서 뷰에서 이라는 두 개의 열을 표시 합니다.다음 코드 예제에서는 두 열에 두 번째 하위 항목 주위 3 차원 사각형을 그립니다.

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