다음을 통해 공유

ListView_GetNextItemIndex 매크로(commctrl.h)

  • 아티클

지정된 속성과 다른 특정 항목과의 관계가 있는 특정 목록 보기 컨트롤에 있는 항목의 인덱스입니다. 이 매크로를 사용하거나 LVM_GETNEXTITEMINDEX 메시지를 명시적으로 보냅니다.

통사론

BOOL ListView_GetNextItemIndex(
  [in]      HWND        hwnd,
  [in, out] LVITEMINDEX *plvii,
            LPARAM      flags
);

매개 변수

[in] hwnd

형식: HWND

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

[in, out] plvii

형식: LVITEMINDEX*

항목이 검색을 시작하는 LVITEMINDEX 구조체에 대한 포인터이거나 지정된 플래그와 일치하는 첫 번째 항목을 찾을 -1. 호출 프로세스는 이 구조를 할당하고 해당 멤버를 설정해야 합니다.

flags

형식: LPARAM

매개 변수 plvii지정된 항목과의 관계입니다. 이 값은 하나 또는 다음 값의 조합일 수 있습니다.

값 의미
인덱스별로 검색합니다.
LVNI_ALL
 기본값인 인덱스별로 후속 항목을 검색합니다.
검색을 시작할 항목의 인덱스로 물리적 관계를 검색합니다.
LVNI_ABOVE
 지정된 항목 위에 있는 항목을 검색합니다.
LVNI_BELOW
 지정된 항목 아래에 있는 항목을 검색합니다.
LVNI_TOLEFT
 지정된 항목의 왼쪽에 있는 항목을 검색합니다.
LVNI_PREVIOUS
 Windows Vista 이상: 지정된 항목 이전 항목을 검색합니다. LVNI_PREVIOUS 플래그는 방향이 아닙니다(LVNI_ABOVE 위에 배치된 항목을 찾은 반면, LVNI_PREVIOUS 이전에 정렬된 항목을 찾습니다.) LVNI_PREVIOUS 플래그는 기본적으로 LVM_GETNEXTITEM 또는 LVM_GETNEXTITEMINDEX 메시지를 통해 수행되는 검색 논리를 반대로 바뀝니다.
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 이상 : 현재 그룹을 검색합니다.
항목에 지정된 상태 플래그가 모두 설정되지 않은 경우 검색은 다음 항목으로 계속됩니다.

반환 값

형식: BOOL

성공하면 TRUE 반환하거나, 그렇지 않으면 FALSE .

발언

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

요구 사항

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

참고 항목

LVM_GETNEXTITEM