LVM_SETITEMCOUNT 메시지

목록 뷰 컨트롤이 지정된 수의 항목에 대한 메모리를 할당하거나 가상 목록 뷰 컨트롤에서 가상 항목 수를 설정합니다.

매개 변수

wParam

목록 뷰 컨트롤에 궁극적으로 포함할 항목 수입니다.

lParam

버전 4.70. 항목 수를 다시 설정한 후 목록 뷰 컨트롤의 동작을 지정하는 값입니다. 이 값은 다음의 조합일 수 있습니다.

값	의미
LVSICF_NOINVALIDATEALL	영향을 받는 항목이 현재 보기에 있지 않으면 목록 뷰 컨트롤이 다시 표시되지 않습니다.
LVSICF_NOSCROLL	목록 뷰 컨트롤은 항목 수가 변경될 때 스크롤 위치를 변경하지 않습니다.

반환 값

성공하면 0이 아닌 값을 반환하고 그렇지 않으면 0을 반환합니다.

설명

메모리가 할당되는 방법은 목록 뷰 컨트롤을 만든 방법에 따라 달라집니다. 이 메시지를 명시적으로 보내거나 ListView_SetItemCount 또는 ListView_SetItemCountEx 매크로를 사용할 수 있습니다. 자세한 내용은 가상 목록 뷰 스타일을 참조하세요.

LVS_OWNERDATA 스타일 없이 목록 뷰 컨트롤을 만든 경우 이 메시지를 보내면 컨트롤이 지정된 수의 항목에 대한 내부 데이터 구조를 할당합니다. 이렇게 하면 항목을 추가할 때마다 컨트롤이 데이터 구조를 할당할 필요가 없습니다.

LVS_OWNERDATA 스타일(가상 목록 뷰)을 사용하여 목록 뷰 컨트롤을 만든 경우 이 메시지를 보내면 컨트롤에 포함된 항목의 가상 수가 설정됩니다.

lParam 매개 변수는 LVS_OWNERDATA 및 LVS_REPORT 또는 LVS_LIST 스타일을 사용하는 목록 뷰 컨트롤에만 사용됩니다.

공용 컨트롤 목록 뷰가 가상화된 목록 뷰(LVS_OWNERDATA)인 경우 목록 뷰에는 100,000,000개의 항목 제한이 있습니다. 이 시나리오에서 LVM_SETITEMCOUNT는 wParam이 100,000,001인 경우에 FALSE를 반환합니다.

요구 사항

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