ListView_GetNextItemIndex 매크로(commctrl.h)

  • 아티클

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

구문

void ListView_GetNextItemIndex(
  [in]       hwnd,
  [in, out]  plvii,
             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 이상: 현재 그룹을 검색합니다.
항목에 지정된 모든 상태 플래그 집합이 없는 경우 검색은 다음 항목으로 계속됩니다.

반환 값

없음

설명

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

요구 사항

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

추가 정보

LVM_GETNEXTITEM