LVM_INSERTITEM 메시지

목록 뷰 컨트롤에 새 항목을 삽입합니다. 이 메시지를 명시적으로 보내거나 ListView_InsertItem 매크로를 사용하여 보낼 수 있습니다.

매개 변수

wParam

0이어야 합니다.

lParam

목록 뷰 항목의 특성을 지정하는 LVITEM 구조체에 대한 포인터입니다. iItem 멤버를 사용하여 새 항목을 삽입해야 하는 인덱스(0부터 시작)를 지정합니다. 이 값이 현재 목록 뷰에 포함된 항목 수보다 크면 새 항목이 목록 끝에 추가되고 올바른 인덱스가 할당됩니다. 메시지의 반환 값을 검사하여 항목에 할당된 실제 인덱스를 확인합니다.

반환 값

성공하면 새 항목의 인덱스를 반환하고 그렇지 않으면 -1을 반환합니다.

설명

ListView_InsertItem 또는 LVM_INSERTITEM을 사용하여 하위 항목을 삽입할 수 없습니다. LVITEM 구조체의 iSubItem 멤버는 0이어야 합니다. 하위 항목 설정에 대한 자세한 내용은 LVM_SETITEM을 참조하세요.

목록 뷰 컨트롤에 LVS_EX_CHECKBOXES 스타일이 설정된 경우 LVITEM 구조체의 state 멤버의 비트 12~15에 있는 모든 값은 무시됩니다. 이 스타일 집합으로 항목을 추가하면 항상 선택되지 않은 상태로 설정됩니다.

목록 뷰 컨트롤에 LVS_SORTASCENDING 또는 LVS_SORTDESCENDING 창 스타일이 있는 경우 pszText 멤버의 값으로 LPSTR_TEXTCALLBACK이 있는 항목을 삽입하려고 하면 LVM_INSERTITEM 메시지가 실패합니다.

LVM_INSERTITEM 메시지는 다음 조건이 충족되는 경우 정렬 순서의 적절한 위치에 새 항목을 삽입합니다.

• LVS_SORTXXX 스타일 중 하나를 사용하고 있습니다.
• LVS_OWNERDRAW 스타일을 사용하고 있지 않습니다.
• pitem이 가리키는 구조체의 pszText 멤버가 LPSTR_TEXTCALLBACK으로 설정되지 않았습니다.

LVITEM 구조체가 mask 멤버에 LVIF_GROUPID를 포함하지 않는 경우 iGroupId 멤버의 값은 기본적으로 I_GROUPIDCALLBACK입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
헤더	Commctrl.h
유니코드 및 ANSI 이름	LVM_INSERTITEMW(유니코드) 및 LVM_INSERTITEMA(ANSI)