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입니다.

반환 코드 설명
BST_CHECKED
 단추가 선택되어 있습니다.
BST_INDETERMINATE
 단추가 확정되지 않은 상태입니다(단추에 BS_3STATE 또는 BS_AUTO3STATE 스타일이 있는 경우에만 적용됨).
BST_UNCHECKED
 단추가 선택되어 있지 않습니다.

설명

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에서 도입)

추가 정보

CheckDlgButton