IsDlgButtonChecked 함수(winuser.h)
IsDlgButtonChecked 함수는 단추 컨트롤이 선택되었는지 또는 세 가지 상태의 단추 컨트롤이 선택되었는지, 선택되지 않았는지 또는 결정되지 않았는지를 결정합니다.
구문
UINT IsDlgButtonChecked(
[in] HWND hDlg,
[in] int nIDButton
);
매개 변수
[in] hDlg
형식: HWND
단추 컨트롤이 포함된 대화 상자에 대한 핸들입니다.
[in] nIDButton
형식: int
단추 컨트롤의 식별자입니다.
반환 값
형식: UINT
BS_AUTOCHECKBOX, BS_AUTORADIOBUTTON, BS_AUTO3STATE, BS_CHECKBOX, BS_RADIOBUTTON 또는 BS_3STATE 스타일로 만든 단추의 반환 값은 다음 표의 값 중 하나일 수 있습니다. 단추에 다른 스타일이 있는 경우 반환 값은 0입니다.
| 반환 코드 | 설명 |
|---|---|
|
단추가 선택되어 있습니다. |
|
단추가 확정되지 않은 상태입니다(단추에 BS_3STATE 또는 BS_AUTO3STATE 스타일이 있는 경우에만 적용됨). |
|
단추가 선택되어 있지 않습니다. |
설명
IsDlgButtonChecked 함수는 지정된 단추 컨트롤에 BM_GETCHECK 메시지를 보냅니다.
예제
예를 들어 대화 상자 사용의 "모덜리스 대화 상자 만들기" 섹션을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winuser.h(Windows.h 포함) |
| 라이브러리 | User32.lib |
| DLL | User32.dll |
| API 세트 | ext-ms-win-ntuser-dialogbox-l1-1-0(Windows 8에서 도입) |