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

참조