DialogBox

DialogBox 매크로 대화 상자 템플릿 리소스에서 모달 대화 상자를 만듭니다. DialogBox 지정 된 콜백 함수 EndDialog 함수를 호출 하 여 모달 대화 상자를 종료 될 때까지 컨트롤을 반환 하지 않습니다. DialogBox 매크로 DialogBoxParam 함수를 사용 하 여.

int DialogBox ( HINSTANCE  hInstance, / / 응용 프로그램 인스턴스에 대 한 핸들LPCTSTRlpTemplate, / / 대화 상자 템플릿 식별 HWNDhWndParent, / / 소유자 창에 대 한 핸들DLGPROClpDialogFunc / / 포인터 대화 상자 프로시저);
 

매개 변수

hInstance

누구의 실행 파일 대화 상자 템플릿을 포함 하는 모듈의 인스턴스를 식별.

lpTemplate

대화 상자 템플릿을 식별합니다. 이 매개 변수는 대화 상자 서식 파일의 이름을 지정 하는 문자 null로 끝나는 문자열에 대 한 포인터 이거나 대화 상자 템플릿의 리소스 식별자를 지정 하는 정수 값입니다. 리소스 식별자를 지정 하는 매개 변수, 높은 순서 단어는 0 이어야 하 고 낮은 순서 단어는 식별자를 포함 해야 합니다. MAKEINTRESOURCE 매크로 사용 하 여이 값을 만들 수 있습니다.

hWndParent

대화 상자를 소유 하 고 있는 창을 식별합니다.

lpDialogFunc

대화 상자 프로시저에 포인터입니다. 대화 상자 프로시저에 대 한 자세한 내용은 다음 웹 사이트를 참조 하십시오. DialogProc.

반환 값

함수가 성공 하면 반환 값은 대화 상자를 종료 하는 데 사용 하는 EndDialog 함수 호출에서 nResult 매개 변수.

함수가 실패 하면 반환 값은-1입니다. 확장 된 오류 정보를 얻을 하려면 GetLastError.

주의

DialogBox 매크로 CreateWindowEx 함수를 사용 하 여 대화 상자를 만듭니다. DialogBox 보냅니다 WM_INITDIALOG 메시지 (그리고 WM_SETFONT 메시지) 서식 파일 DS_SETFONT 스타일을 지정 하는 경우 대화 상자 프로시저를. 함수 (여부를 서식 지정 WS_VISIBLE 스타일) 관계 없이 대화 상자가 표시 됩니다, 그리고 소유자 창이 비활성화 및 검색 대화 상자에 대 한 메시지를 전달 하는 자체 메시지 루프를 시작.

대화 상자 프로시저 EndDialog 함수를 호출 하는 경우 DialogBox 파괴 하는 대화 상자, 메시지 루프를 종료, 소유자 창 (해당 되는 경우 이전에 사용) 있으며 EndDialog 호출 될 때 대화 상자 프로시저에서 지정 된 nResult 매개 변수를 반환 합니다.

Windows 95 이상:시스템은 대화 상자 템플릿 당 255 컨트롤의 최대를 지원할 수 있습니다. 대화 상자에 255 개 이상의 컨트롤을 배치 하려면 서식 파일에 배치 하는 것 보다는 WM_INITDIALOG 메시지 처리기에서 컨트롤을 만들려면.

Windows CE: . LpTemplate 매개 변수에서 참조 하는 대화 상자 템플릿 DLGTEMPLATE 구조에서 지원 되는 모든 스타일

QuickInfo

nbsp;?Windows &NT: 버전 3.1 이상이 필요 합니다.
Windows:Windows 95 이상이 필요합니다.
Windows CE:버전 1.0 이상이 필요합니다.
헤더:Winuser.h에서 선언합니다.
가져오기 라이브러리:User32.lib를 사용 합니다.
유니코드:Windows NT에서 유니코드와 ANSI 버전으로 구현.

참고 항목

대화 상자 개요 대화 상자 함수를 CreateDialog, CreateWindowEx, DialogBoxIndirect, DialogBoxIndirectParam, DialogBoxParam, DialogProc, EndDialog, MAKEINTRESOURCE, WM_INITDIALOG, WM_SETFONT

Index