CSimpleDialog 클래스

이 클래스는 기본 모달 대화 상자를 구현합니다.

구문

template <WORD t_wDlgTemplateID, BOOL t_bCenter = TRUE>
class CSimpleDialog : public CDialogImplBase

매개 변수

t_wDlgTemplateID

대화 상자 템플릿 리소스의 리소스 ID입니다.

t_bCenter
대화 상자 개체가 소유자 창의 가운데에 배치될 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

멤버

공용 메서드

이름 설명
CSimpleDialog::D oModal 모달 대화 상자를 만듭니다.

설명

기본 기능이 있는 모달 대화 상자를 구현합니다. CSimpleDialog 에서는 Windows 공용 컨트롤만 지원합니다. 모달 대화 상자를 만들고 표시하려면 이 클래스의 인스턴스를 만들어 대화 상자에 대한 기존 리소스 템플릿의 이름을 제공합니다. 사용자가 미리 정의된 값(예: IDOK 또는 IDCANCEL)을 사용하여 컨트롤을 클릭하면 대화 상자 개체가 닫힙니다.

CSimpleDialog 를 사용하면 모달 대화 상자만 만들 수 있습니다. CSimpleDialog 는 기본 메시지 맵을 사용하여 메시지를 적절한 처리기로 보내는 대화 상자 프로시저를 제공합니다.

자세한 내용은 대화 상자 구현을 참조 하세요 .

상속 계층 구조

CDialogImplBase

CSimpleDialog

요구 사항

헤더: atlwin.h

CSimpleDialog::D oModal

모달 대화 상자를 호출하고 완료되면 대화 상자 결과를 반환합니다.

INT_PTR DoModal(HWND hWndParent = ::GetActiveWindow());

매개 변수

hWndParent
대화 상자의 부모에 대한 핸들입니다. 값이 제공되지 않으면 부모가 현재 활성 창으로 설정됩니다.

Return Value

성공하면 반환 값은 대화 상자를 해제한 컨트롤의 리소스 ID입니다.

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

설명

이 메서드는 대화 상자가 활성 상태인 동안 사용자와의 모든 상호 작용을 처리합니다. 이것이 대화 상자를 모달로 만드는 이유입니다. 즉, 사용자가 대화 상자를 닫을 때까지 다른 창과 상호 작용할 수 없습니다.

참고 항목

클래스 개요