다음을 통해 공유


ListView_MapIDToIndex 매크로(commctrl.h)

항목의 ID를 인덱스로 매핑합니다. 이 매크로를 사용하거나 LVM_MAPIDTOINDEX 메시지를 명시적으로 보낼 수 있습니다.

통사론

UINT ListView_MapIDToIndex(
   HWND hwnd,
   UINT id
);

매개 변수

hwnd

형식: HWND

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

id

형식: UINT

항목의 고유 ID를 포함하는 UINT.

반환 값

형식: UINT

가장 최근 인덱스 반환

발언

목록 보기 컨트롤은 내부적으로 인덱스별로 항목을 추적합니다. 컨트롤이 있는 동안 인덱스가 변경되어 문제가 발생할 수 있습니다.

이 매크로를 사용하여 항목을 만들 때 ID가 있는 항목에 태그를 지정할 수 있습니다. 이 ID를 사용하여 목록 보기 컨트롤이 있는 동안 고유성을 보장합니다.

항목을 고유하게 식별하려면 IComponent::GetDisplayInfo같은 호출에서 반환되는 인덱스 및 LVM_MAPINDEXTOID호출합니다. 반환 값은 고유 ID입니다.

ID를 만든 후 항목의 인덱스도 알아야 하는 경우 고유 ID를 사용하여 LVM_MAPIDTOINDEX 호출하면 가장 최신 인덱스가 반환됩니다.

참고 다중 스레드 환경에서는 백그라운드 스레드가 아닌 목록 보기 컨트롤을 호스트하는 스레드에서 올바른 인덱스가 반환되는지 확인할 수 있습니다.
 
ListView_MapIDToIndex사용하려면 매니페스트에서 Comctl32.dll 버전 6을 지정합니다. 매니페스트에 대한 자세한 내용은 비주얼 스타일사용하도록 설정하세요.

요구 사항

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