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 [데스크톱 앱만 해당] |
헤더 |
|
유니코드 및 ANSI 이름 |
LVM_GETITEMW(유니코드) 및 LVM_GETITEMA(ANSI) |