다음을 통해 공유


CListCtrl::SortItems

응용 프로그램-정의 된 비교 함수를 사용 하 여 목록 보기 항목을 정렬 합니다.

BOOL SortItems(
   PFNLVCOMPARE pfnCompare,
   DWORD_PTR dwData 
);

매개 변수

  • [in] pfnCompare
    응용 프로그램 정의 비교 함수의 주소입니다.

    정렬 작업 두 목록 항목의 상대 순서를 결정할 수 할 때마다 비교 함수를 호출 합니다.비교 함수는 클래스의 정적 멤버 또는 클래스의 구성원이 아닌 독립 실행형 함수 여야 합니다.

  • [in] dwData
    비교 함수에 전달 되는 응용 프로그램 정의 값입니다.

반환 값

true경우 메서드가 실패 합니다. 그렇지 않으면 false.

설명

이 메서드는 인덱스의 각 항목을 새 값으로 변경 합니다.

비교 함수를 pfnCompare, 다음과 같은 형식을 갖습니다:

int CALLBACK CompareFunc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort);

비교 함수는 첫 번째 항목의 두 번째 앞에 야 하는 경우 음수 값을 반환 해야, 첫 번째 항목의 두 번째 또는 0이 따라야 하는 경우 양수 값 두 개의 항목이 동일 합니다.

lParam1 매개 변수를 비교, 첫 번째 항목과 연관 된 32 비트 값입니다 및 lParam2 매개 변수는 두 번째 항목과 연결 된 값입니다.다음에 지정 된 값입니다.는 lParam 의 소속 LVITEM 구조 목록에 삽입 되는 경우.lParamSort 매개 변수는 동일의 dwData 값입니다.

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

예제

다음 항목으로 정렬 하 고 결과 단순 비교 함수는 해당 lParam 값입니다.

// Sort items by associated lParam
int CALLBACK CListCtrlDlg::MyCompareProc(LPARAM lParam1, LPARAM lParam2, 
    LPARAM lParamSort)
{
    UNREFERENCED_PARAMETER(lParamSort);

    return (int)(lParam1 - lParam2);
}
// Sort the items by passing in the comparison function.
void CListCtrlDlg::Sort()
{
    m_myListCtrl.SortItems(&CListCtrlDlg::MyCompareProc, 0);
}

요구 사항

헤더: afxcmn.h

이 컨트롤에서 Windows NT 3.51 또는 나중에 지.

참고 항목

참조

CListCtrl 클래스

계층 구조 차트

CListCtrl::FindItem

CListCtrl::SortItemsEx