ListView_GetItem 매크로(commctrl.h)
목록 보기 항목의 특성 중 일부 또는 전체를 가져옵니다. 이 매크로를 사용하거나 LVM_GETITEM 메시지를 명시적으로 보낼 수 있습니다.
통사론
BOOL ListView_GetItem(
HWND hwnd,
LPLVITEM pitem
);
매개 변수
hwnd
형식: HWND
목록 보기 컨트롤에 대한 핸들입니다.
pitem
형식: LPLVITEM
목록 보기 항목에 대한 정보를 검색하고 받는 정보를 지정하는 LVITEM 구조체에 대한 포인터입니다.
반환 값
형식: BOOL
성공하면
발언
LVM_GETITEM 메시지가 전송되면 iItem 및 iSubItem 멤버는 정보를 검색할 항목 또는 하위 항목을 식별하고 마스크 멤버는 검색할 특성을 지정합니다. 가능한 값 목록은 LVITEM 구조체에 대한 설명을 참조하세요.
LVIF_TEXT 플래그가 LVITEM 구조체의 마스크 멤버에 설정된 경우 pszText 멤버는 유효한 버퍼를 가리키고 cchTextMax 멤버는 해당 버퍼의 문자 수로 설정해야 합니다. 애플리케이션은 텍스트가 반드시 지정된 버퍼에 배치된다고 가정해서는 안 됩니다. 대신 컨트롤이 버퍼에 배치하지 않고 새 텍스트를 가리키도록 구조체의 pszText 멤버를 변경할 수 있습니다.
마스크 멤버가 LVIF_STATE 값을 지정하는 경우 stateMask 멤버는 검색할 항목 상태 비트를 지정해야 합니다. 출력 시 상태 멤버에는 지정된 상태 비트의 값이 포함됩니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | commctrl.h |