COMPAREITEMSTRUCT 구조체(winuser.h)

소유자가 그린 정렬된 목록 상자 또는 콤보 상자에서 두 항목에 대한 식별자 및 애플리케이션 제공 데이터를 제공합니다.

애플리케이션이 CBS_SORT 또는LBS_SORT 스타일로 만든 소유자 그리기 목록 상자 또는 콤보 상자에 새 항목을 추가할 때마다 시스템은 소유자에게 WM_COMPAREITEM 메시지를 보냅니다. 메시지의 lParam 매개 변수에는 COMPAREITEMSTRUCT 구조체에 대한 긴 포인터가 포함되어 있습니다. 메시지를 받으면 소유자는 두 항목을 비교하고 다른 항목 앞에 정렬되는 항목을 나타내는 값을 반환합니다.

구문

typedef struct tagCOMPAREITEMSTRUCT {
  UINT      CtlType;
  UINT      CtlID;
  HWND      hwndItem;
  UINT      itemID1;
  ULONG_PTR itemData1;
  UINT      itemID2;
  ULONG_PTR itemData2;
  DWORD     dwLocaleId;
} COMPAREITEMSTRUCT, *PCOMPAREITEMSTRUCT, *LPCOMPAREITEMSTRUCT;

멤버

CtlType

형식: UINT

ODT_LISTBOX(소유자가 그린 목록 상자) 또는 ODT_COMBOBOX(소유자가 그린 콤보 상자)입니다.

CtlID

형식: UINT

목록 상자 또는 콤보 상자의 식별자입니다.

hwndItem

형식: HWND

컨트롤에 대한 핸들입니다.

itemID1

형식: UINT

비교할 목록 상자 또는 콤보 상자의 첫 번째 항목 인덱스입니다. 항목이 삽입되지 않았거나 목록 상자 또는 콤보 상자에서 잠재적 항목을 검색할 때 이 멤버는 –1이 됩니다.

itemData1

형식: ULONG_PTR

비교할 첫 번째 항목에 대한 애플리케이션 제공 데이터입니다. (이 값은 목록 상자 또는 콤보 상자에 항목을 추가한 메시지의 lParam 매개 변수로 전달되었습니다.)

itemID2

형식: UINT

비교할 목록 상자 또는 콤보 상자의 두 번째 항목 인덱스입니다.

itemData2

형식: ULONG_PTR

비교 중인 두 번째 항목에 대한 애플리케이션 제공 데이터입니다. 이 값은 목록 상자 또는 콤보 상자에 항목을 추가한 메시지의 lParam 매개 변수로 전달되었습니다. 항목이 삽입되지 않았거나 목록 상자 또는 콤보 상자에서 잠재적 항목을 검색할 때 이 멤버는 –1이 됩니다.

dwLocaleId

형식: DWORD

로캘 식별자입니다. 로캘 식별자를 만들려면 MAKELCID 매크로를 사용합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	winuser.h(Windows.h 포함)

추가 정보

콤보 상자

개념

MAKELCID

기타 리소스

참조

WM_COMPAREITEM