LVM_GETITEM 메시지

목록 뷰 항목의 특성 중 일부 또는 전부를 검색합니다. 이 메시지를 명시적으로 보내거나 ListView_GetItem 매크로를 사용하여 보낼 수 있습니다.

매개 변수

wParam

0이어야 합니다.

lParam

검색할 정보를 지정하고 목록 뷰 항목에 대한 정보를 수신하는 LVITEM 구조체에 대한 포인터입니다.

반환 값

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

설명

LVM_GETITEM 메시지가 전송되면 iItem 및 iSubItem 멤버는 정보를 검색할 항목 또는 하위 항목을 식별하고 mask 멤버는 검색할 특성을 지정합니다. 가능한 값 목록은 LVITEM 구조체에 대한 설명을 참조하세요.

LVIF_TEXT 플래그가 LVITEM 구조체의 mask 멤버에 설정된 경우 pszText 멤버는 유효한 버퍼를 가리켜야 하며 cchTextMax 멤버는 해당 버퍼의 문자 수로 설정되어야 합니다. 애플리케이션은 텍스트가 반드시 지정된 버퍼에 배치될 것이라고 가정해서는 안 됩니다. 대신 컨트롤은 구조체의 pszText 멤버를 버퍼에 배치하는 대신 새 텍스트를 가리키도록 변경할 수 있습니다.

mask 멤버가 LVIF_STATE 값을 지정하는 경우 stateMask 멤버는 검색할 항목 상태 비트를 지정해야 합니다. 출력 시 state 멤버에는 지정된 상태 비트의 값이 포함됩니다.

요구 사항

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