CListCtrl::GetGroupInfoByIndex
현재 목록 뷰 컨트롤에 지정 된 그룹에 대 한 정보를 검색합니다.
BOOL GetGroupInfoByIndex(
int iIndex,
PLVGROUP pGroup
) const;
매개 변수
Parameter |
설명 |
|---|---|
[in] iIndex |
그룹의 인덱스 0부터 시작 합니다. |
[out] pGroup |
포인터는 LVGROUP 지정 된 그룹에 대 한 정보를 수신 하는 구조는 iIndex 매개 변수. 호출자의 멤버를 초기화 하는 책임이 있는 LVGROUP 구조. 설정의 cbSize 멤버는 구조체의 크기 및 플래그의의 mask 멤버를 검색할 정보를 지정 합니다. |
반환 값
true이 방법에 성공 하면. 그렇지 않으면 false.
설명
보내는이 메서드는 LVM_GETGROUPINFOBYINDEX 에서 설명 하는 메시지는 Windows SDK.
요구 사항
헤더: afxcmn.h
이 컨트롤에서 지 Windows Vista 이상.
이 메서드에 대 한 추가 요구 사항에서 설명 Windows Vista 공용 컨트롤의 빌드 요구 사항.
예제
다음 코드 예제에서는 변수 정의 m_listCtrl, 즉 현재 목록 뷰 컨트롤에 액세스 하는 데 사용 합니다. 이 변수는 다음 예제에 사용 됩니다.
public:
// Variable used to access the list control.
CListCtrl m_listCtrl;
다음 코드 예제에서는 GetGroupInfoByIndex 메서드를 사용하는 방법을 보여 줍니다. 이 코드는 앞 절에서 예제에서는 목록 뷰 컨트롤 작성 "ClientID" 및 "등급" 보고서 뷰에서 이라는 두 개의 열 표시 됩니다. 이러한 그룹에 존재 하는 경우 다음 코드 예제에서는 인덱스 0의 그룹에 대 한 정보를 검색 합니다.
// GetGroupInfoByIndex
const int GROUP_HEADER_BUFFER_SIZE = 40;
// Initialize the structure
LVGROUP gInfo = {0};
gInfo.cbSize = sizeof(LVGROUP);
wchar_t wstrHeadGet[GROUP_HEADER_BUFFER_SIZE] = {0};
gInfo.cchHeader = GROUP_HEADER_BUFFER_SIZE;
gInfo.pszHeader = wstrHeadGet;
gInfo.mask = (LVGF_ALIGN | LVGF_STATE | LVGF_HEADER | LVGF_GROUPID);
gInfo.state = LVGS_NORMAL;
gInfo.uAlign = LVGA_HEADER_LEFT;
BOOL bRet = m_listCtrl.GetGroupInfoByIndex( 0, &gInfo );
if (bRet == TRUE) {
CString strHeader = CString( gInfo.pszHeader );
CString str;
str.Format(_T("Header: '%s'"), strHeader);
AfxMessageBox(str, MB_ICONINFORMATION);
}
else
{
AfxMessageBox(_T("No group information was retrieved."));
}