다음을 통해 공유


CheckDlgButton 함수(winuser.h)

단추 컨트롤의 확인 상태를 변경합니다.

구문

BOOL CheckDlgButton(
  [in] HWND hDlg,
  [in] int  nIDButton,
  [in] UINT uCheck
);

매개 변수

[in] hDlg

형식: HWND

단추가 포함된 대화 상자에 대한 핸들입니다.

[in] nIDButton

형식: int

수정할 단추의 식별자입니다.

[in] uCheck

형식: UINT

단추의 검사 상태입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

의미
BST_CHECKED
단추 상태를 확인하도록 설정합니다.
BST_INDETERMINATE
단추 상태를 회색으로 설정하여 확정되지 않은 상태를 나타냅니다. 단추에 BS_3STATE 또는 BS_AUTO3STATE 스타일이 있는 경우에만 이 값을 사용합니다.
BST_UNCHECKED
단추 상태를 지울 수 있도록 설정합니다.

반환 값

형식: BOOL

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

CheckDlgButton 함수는 지정된 대화 상자의 지정된 단추 컨트롤에 BM_SETCHECK 메시지를 보냅니다.

예제

예를 들어 대화 상자 사용에서 모덜리스 대화 상자 만들기를 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 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에 도입됨)

추가 정보

CheckRadioButton

IsDlgButtonChecked

참조