LVM_SETITEM 메시지

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

매개 변수

wParam

0이어야 합니다.

lParam

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

반환 값

성공하면 TRUE를 반환하고 그렇지 않으면 FALSE를 반환합니다.

설명

목록 뷰 항목의 특성을 설정하려면 LVITEM 구조체의 iItem 멤버를 항목의 인덱스로 설정하고 iSubItem 멤버를 0으로 설정합니다. 항목의 경우 LVITEM 구조체의 state, pszText, iImage 및 lParam 멤버를 설정할 수 있습니다.

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

요구 사항

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