Share via


ListView_GetGroupRect 매크로(commctrl.h)

지정된 그룹의 사각형을 가져옵니다. 이 매크로를 사용하거나 LVM_GETGROUPRECT 메시지를 명시적으로 보냅니다.

구문

void ListView_GetGroupRect(
  [in]       hwnd,
  [in]       iGroupId,
  [in]       type,
  [in, out]  prc
);

매개 변수

[in] hwnd

형식: HWND

목록 보기 컨트롤에 대한 핸들입니다.

[in] iGroupId

형식: int

iGroupId로 그룹을 지정합니다(LVGROUP 구조체 참조).

[in] type

형식: LONG

검색할 사각형의 형식을 지정합니다. 이 매개 변수는 다음 값 중 하나여야 합니다.

의미
LVGGR_GROUP
확장된 전체 그룹의 좌표입니다.
LVGGR_HEADER
머리글 전용 좌표입니다(축소된 그룹).
LVGGR_LABEL
레이블 전용 좌표입니다.
LVGGR_SUBSETLINK
하위 집합 링크 전용 좌표입니다(태그 하위 집합). 목록 뷰 컨트롤은 각 그룹에 표시되는 항목의 수를 제한할 수 있습니다. 사용자가 그룹을 확장할 수 있도록 링크가 사용자에게 표시됩니다. 이 플래그는 그룹이 하위 집합인 경우 하위 집합 링크의 경계 사각형을 반환합니다(LVGS_SUBSETED 그룹 상태, 구조체 LVGROUP, 멤버 상태 참조). 이 플래그는 접근성 애플리케이션이 링크를 찾을 수 있도록 제공됩니다.

[in, out] prc

형식: RECT*

iGroupId로 지정된 그룹에 대한 정보를 수신하는 RECT 구조체에 대한 포인터입니다. 메시지 수신자는 iGroupId로 지정된 그룹에 대한 정보를 사용하여 구조체 멤버를 설정해야 합니다. 호출 애플리케이션은 구조체에 대한 메모리 할당을 담당합니다.

반환 값

없음

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 commctrl.h