다음을 통해 공유

LVM_GETNEXTITEM 메시지

  • 아티클

지정된 속성이 있고 지정된 항목에 대한 지정된 관계를 포함하는 목록 뷰 항목을 검색합니다. 이 메시지를 명시적으로 보내거나 ListView_GetNextItem 매크로를 사용하여 보낼 수 있습니다.

매개 변수

wParam

검색을 시작할 항목의 인덱스 또는 -1을 사용하여 지정된 플래그와 일치하는 첫 번째 항목을 찾습니다. 지정된 항목 자체는 검색에서 제외됩니다.

lParam

wParam에 지정된 항목과의 관계를 지정합니다. 다음 값 중 하나 또는 여러 값의 조합일 수 있습니다.

값 의미
인덱스별로 검색합니다.
LVNI_ALL
 기본값인 인덱스별로 후속 항목을 검색합니다.
LVNI_PREVIOUS
 Windows Vista 이상:wParam에 지정된 항목 앞에 정렬된 항목을 검색합니다. LVNI_PREVIOUS 플래그는 방향이 아닙니다(LVNI_ABOVE는 위에 배치된 항목을 찾지만 LVNI_PREVIOUS는 앞에 정렬된 항목을 찾습니다.) LVNI_PREVIOUS 플래그는 기본적으로 LVM_GETNEXTITEM 또는 LVM_GETNEXTITEMINDEX 메시지에서 수행하는 검색 논리를 반전합니다.
검색을 시작할 항목의 인덱스와의 물리적 관계를 기준으로 검색합니다.
LVNI_ABOVE
 지정된 항목 위에 있는 항목을 검색합니다.
LVNI_BELOW
 지정된 항목 아래에 있는 항목을 검색합니다.
LVNI_TOLEFT
 지정된 항목의 왼쪽에 있는 항목을 검색합니다.
LVNI_TORIGHT
 지정된 항목의 오른쪽에 있는 항목을 검색합니다.
LVNI_DIRECTIONMASK
 Windows Vista 이상: 다음과 같은 값이 있는 방향 플래그 마스크: LVNI_ABOVE | LVNI_BELOW | LVNI_TOLEFT | LVNI_TORIGHT.
찾을 항목의 상태는 다음 값 중 하나 또는 이들의 조합으로 지정할 수 있습니다.
LVNI_CUT
 항목에 LVIS_CUT 상태 플래그 집합이 있습니다.
LVNI_DROPHILITED
 항목에 LVIS_DROPHILITED 상태 플래그 집합이 있습니다.
LVNI_FOCUSED
 항목에 LVIS_FOCUSED 상태 플래그 집합이 있습니다.
LVNI_SELECTED
 항목에 LVIS_SELECTED 상태 플래그 집합이 있습니다.
LVNI_STATEMASK
 Windows Vista 이상: 다음과 같은 값이 있는 상태 플래그 마스크: LVNI_FOCUSED | LVNI_SELECTED | LVNI_CUT | LVNI_DROPHILITED.
항목의 모양 또는 그룹별로 검색합니다.
LVNI_VISIBLEORDER
 Windows Vista 이상: 표시되는 순서를 검색합니다.
LVNI_VISIBLEONLY
 Windows Vista 이상: 표시되는 항목을 검색합니다.
LVNI_SAMEGROUPONLY
 Windows Vista 이상: 현재 그룹을 검색합니다.
항목에 지정된 모든 상태 플래그 집합이 없는 경우 검색은 다음 항목으로 계속됩니다.

반환 값

성공하면 다음 항목의 인덱스를 반환하고 그렇지 않으면 -1을 반환합니다.

설명

Windows Vista에서만 사용할 플래그는 사용 중인 다른 플래그인 LVNI_VISIBLEONLY, LVNI_SAMEGROUPONLY, LVNI_VISIBLEORDER, LVNI_DIRECTIONMASK 및 LVNI_STATEMASK와 함께 사용할 수 없습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2003 [데스크톱 앱만 해당]
헤더
Commctrl.h