ListView_GetItem 매크로(commctrl.h)

목록 뷰 항목의 특성 중 일부 또는 전부를 가져옵니다. 이 매크로를 사용하거나 LVM_GETITEM 메시지를 명시적으로 보낼 수 있습니다.

구문

void ListView_GetItem(
   hwnd,
   pitem
);

매개 변수

hwnd

형식: HWND

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

pitem

형식: LPLVITEM

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

반환 값

없음

설명

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

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

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

요구 사항

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