ListView_SetItem 매크로(commctrl.h)

목록 보기 항목의 특성 중 일부 또는 전체를 설정합니다. ListView_SetItem 사용하여 하위 항목의 텍스트를 설정할 수도 있습니다. 이 매크로를 사용하거나 LVM_SETITEM 메시지를 명시적으로 보낼 수 있습니다.

통사론

BOOL ListView_SetItem(
         HWND     hwnd,
   const LPLVITEM pitem
);

매개 변수

hwnd

형식: HWND

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

pitem

형식: const LPLVITEM

새 항목 특성을 포함하는 LVITEM 구조체에 대한 포인터입니다. iItem 및 iSubItem 멤버는 항목 또는 하위 항목을 식별하고 마스크 멤버는 설정할 특성을 지정합니다. 마스크 멤버가 LVIF_TEXT 값을 지정하는 경우 pszText 멤버는 null로 끝나는 문자열의 주소이고 cchTextMax 멤버는 무시됩니다. 마스크 멤버가 LVIF_STATE 값을 지정하는 경우 stateMask 멤버는 변경할 항목 상태를 지정하고 상태 멤버는 해당 상태에 대한 값을 포함합니다.

반환 값

형식: BOOL

성공하면 TRUE 반환하거나, 그렇지 않으면 FALSE .

발언

목록 보기 항목의 특성을 설정하려면 LVITEM 구조체의 iItem 멤버를 항목의 인덱스로 설정하고 iSubItem 멤버를 0으로 설정합니다. 항목의 경우 상태, pszText, iImage및 LVITEM 구조의 lParam 멤버를 사용하여 이러한 항목 매개 변수를 수정할 수 있습니다.

하위 항목의 텍스트를 설정하려면 iItem 설정하고 iSubItem 멤버를 특정 하위 사이트를 나타내고 pszText 멤버를 사용하여 텍스트를 지정합니다. 또는 ListView_SetItemText 매크로를 사용하여 하위 항목의 텍스트를 설정할 수 있습니다. 하위 항목에는 이러한 특성이 없으므로 하위 항목에 대한 상태 또는 lParam 멤버를 설정할 수 없습니다. 버전 4.70 이상에서는 하위 항목에 대한 iImage 멤버를 설정할 수 있습니다. 목록 보기 컨트롤에 LVS_EX_SUBITEMIMAGES 확장 스타일이 있는 경우 하위 항목 이미지가 표시됩니다. 이전 버전은 하위 항목 이미지를 무시합니다.

요구 사항

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