GetNextDlgGroupItem 함수(winuser.h)
대화 상자에서 지정된 컨트롤 앞에 오거나 따르는 컨트롤 그룹의 첫 번째 컨트롤에 대한 핸들을 검색합니다.
구문
HWND GetNextDlgGroupItem(
[in] HWND hDlg,
[in, optional] HWND hCtl,
[in] BOOL bPrevious
);
매개 변수
[in] hDlg
형식: HWND
검색할 대화 상자에 대한 핸들입니다.
[in, optional] hCtl
형식: HWND
검색의 시작점으로 사용할 컨트롤에 대한 핸들입니다. 이 매개 변수가 NULL인 경우 함수는 대화 상자의 마지막(또는 첫 번째) 컨트롤을 검색의 시작점으로 사용합니다.
[in] bPrevious
형식: BOOL
함수가 대화 상자에서 컨트롤 그룹을 검색하는 방법을 나타냅니다. 이 매개 변수가 TRUE이면 함수는 그룹의 이전 컨트롤을 검색합니다. FALSE이면 함수는 그룹의 다음 컨트롤을 검색합니다.
반환 값
형식: HWND
함수가 성공하면 반환 값은 컨트롤 그룹의 이전(또는 다음) 컨트롤에 대한 핸들입니다.
함수가 실패하면 반환 값은 NULL입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
GetNextDlgGroupItem 함수는 대화 상자 템플릿에서 만든 순서(또는 역순)로 컨트롤을 검색합니다. 그룹의 첫 번째 컨트롤에는 WS_GROUP 스타일이 있어야 합니다. 그룹의 다른 모든 컨트롤은 연속적으로 만들어졌어야 하며 WS_GROUP 스타일이 없어야 합니다.
이전 컨트롤을 검색할 때 함수는 표시되고 사용하지 않도록 설정되지 않은 첫 번째 컨트롤을 반환합니다. hCtl에 지정된 컨트롤에 WS_GROUP 스타일이 있는 경우 함수는 검색을 일시적으로 반전하여 WS_GROUP 스타일을 가진 첫 번째 컨트롤을 찾은 다음 원래 방향으로 검색을 다시 시작하고, 표시되고 사용하지 않도록 설정되지 않은 첫 번째 컨트롤을 반환하거나, 이러한 컨트롤이 없는 경우 hCtl을 반환합니다.
다음 컨트롤을 검색할 때 함수는 표시되고 비활성화되지 않고 WS_GROUP 스타일이 없는 첫 번째 컨트롤을 반환합니다. WS_GROUP 스타일이 있는 컨트롤이 발견되면 함수는 검색을 반대로 하고, WS_GROUP 스타일을 가진 첫 번째 컨트롤을 찾은 다음, 이 컨트롤이 표시되고 사용하지 않도록 설정되지 않은 경우 이 컨트롤을 반환합니다. 그렇지 않으면 함수는 원래 방향으로 검색을 다시 시작하고 표시되고 비활성화되지 않은 첫 번째 컨트롤을 반환하거나, 이러한 컨트롤이 없으면 hCtl 을 반환합니다.
그룹에서 다음 컨트롤을 검색하면 WS_EX_CONTROLPARENT 스타일이 있는 창이 발견되면 시스템은 창의 자식을 재귀적으로 검색합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | winuser.h(Windows.h 포함) |
| 라이브러리 | User32.lib |
| DLL | User32.dll |
추가 정보
개념
참조