ListView_InsertItem 매크로(commctrl.h)

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

통사론

int ListView_InsertItem(
         HWND     hwnd,
   const LPLVITEM pitem
);

매개 변수

hwnd

형식: HWND

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

pitem

형식: const LPLVITEM

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

반환 값

형식: int

성공하면 새 항목의 인덱스 또는 -1 반환합니다.

발언

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

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

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

ListView_InsertItem 매크로는 다음 조건이 유지되는 경우 정렬 순서대로 적절한 위치에 새 항목을 삽입합니다.

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

요구 사항

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