ListView_InsertItem 매크로(commctrl.h)

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

구문

void ListView_InsertItem(
   hwnd,
   pitem
);

매개 변수

hwnd

형식: HWND

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

pitem

형식: const LPLVITEM

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

반환 값

없음

설명

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

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

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

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

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

요구 사항

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