다음을 통해 공유


CListCtrl::GetGroupRect

현재 목록 뷰 컨트롤에 지정 된 그룹에 대 한 경계 사각형을 검색합니다.

BOOL GetGroupRect(
     int iGroupId, 
     LPRECT lpRect, 
     int iCoords = LVGGR_GROUP
) const;

매개 변수

Parameter

설명

[in] iGroupId

그룹을 지정합니다.

[in, out]lpRect

포인터는 RECT 구조.이 메서드가 성공 하면 사각형 좌표에서 지정 된 그룹의 구조를 받는 iGroupId.

[in] iCoords

검색 사각형 좌표를 지정 합니다.이러한 값 중 하나를 사용 하십시오.

  • LVGGR_GROUP-확장 된 그룹 전체 좌표 (기본값).

  • LVGGR_HEADER좌표는 헤더 (축소 된 그룹)입니다.

  • LVGGR_SUBSETLINK좌표 (하위 태그) 하위 링크만입니다.

반환 값

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

설명

호출자 할당에 대 한 책임을 지지는 RECT 구조에서를 가리키는 있는 pRect 매개 변수.

보내는이 메서드는 LVM_GETGROUPRECT 에서 설명 하는 메시지는 Windows SDK.

요구 사항

헤더: afxcmn.h

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

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

예제

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

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

다음 코드 예제에서는 GetGroupRect 메서드를 사용하는 방법을 보여 줍니다.이 코드 예제는 이전 단원에서 "등급" 및 "ClientID" 보고서 뷰에서 이라는 두 개의 열을 표시 하는 목록 뷰 컨트롤을 만들.이러한 그룹에 존재 하는 경우 다음 코드 예제에서는 인덱스 0 그룹 주위의 3D 사각형을 그립니다.

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

참고 항목

참조

CListCtrl 클래스

계층 구조 차트

LVM_GETGROUPRECT

RECT