일반 대화 상자 라이브러리

공통 대화 상자 라이브러리에는 파일 열기, 색 값 선택 및 문서 인쇄와 같은 일반적인 애플리케이션 작업을 수행하기 위한 대화 상자 집합이 포함되어 있습니다. 일반적인 대화 상자를 사용하면 애플리케이션의 사용자 인터페이스에 대한 일관된 접근 방식을 구현할 수 있습니다. 이렇게 하면 사용자가 애플리케이션에 대한 사용자 인터페이스 동작을 학습하는 데 소비하는 작업이 줄어듭니다.

이 섹션에서는 열기 및 다른 이름으로 저장 파일 대화 상자를 포함하는 일반적인 대화 상자에 대해 설명합니다. 편집 상자 찾기 및 바꾸기 대화 상자 인쇄, 인쇄 설정, 인쇄 속성 시트 및 페이지 설정 인쇄 대화 상자 색 및 글꼴 대화 상자가 표시됩니다.

참고

Windows Vista부터 일반 항목 대화 상자로 열기 및 다른 이름으로 저장대화 상자가 대체되었습니다. 공통 대화 상자 라이브러리의 이러한 대화 상자 대신 공통 항목 대화 상자 API를 사용하는 것이 좋습니다.

섹션 내용

속성	설명
일반적인 대화 상자 유형	다양한 대화 상자에 대해 설명합니다.
일반 대화 상자 초기화 플래그	플래그를 사용하여 일반적인 대화 상자의 동작과 모양을 수정하는 방법을 설명합니다.
일반 대화 상자 사용자 지정	일반적인 대화 상자를 사용하는 방법을 설명합니다.
일반 대화 상자 사용	일반적인 대화 상자를 호출하는 작업을 다룹니다.
일반 대화 상자 참조	API 참조를 포함합니다.

Functions

속성	설명
CCHookProc	색 대화 상자의 기본 대화 상자 프로시저에 대한 메시지 또는 알림을 받습니다. ChooseColor 함수와 함께 사용되는 애플리케이션 정의 또는 라이브러리 정의 콜백 함수입니다.
CFHookProc	글꼴 대화 상자의 기본 대화 상자 프로시저를 위한 메시지 또는 알림을 받습니다. ChooseFont 함수와 함께 사용되는 애플리케이션 정의 또는 라이브러리 정의 콜백 프로시저입니다.
선택Color	사용자가 색 을 선택할 수 있도록 하는 색 대화 상자를 만듭니다.
선택Font	사용자가 논리 글꼴 의 특성을 선택할 수 있도록 하는 글꼴 대화 상자를 만듭니다. 이러한 특성에는 글꼴 패밀리 및 관련 글꼴 스타일, 점 크기, 효과(밑줄, 취소선 및 텍스트 색) 및 스크립트(또는 문자 집합)가 포함됩니다.
CommDlgExtendedError	일반적인 대화 상자 오류 코드를 반환합니다. 이 코드는 일반적인 대화 상자 함수 중 하나를 실행하는 동안 발생할 가장 최근의 오류를 나타냅니다.
Findtext	사용자가 검색할 문자열과 문서에서 텍스트를 검색할 때 사용할 옵션을 지정할 수 있는 시스템 정의 모덜리스 찾기 대화 상자를 만듭니다.
FRHookProc	찾기 또는 바꾸기 대화 상자의 기본 대화 상자 프로시저에 대한 메시지 또는 알림을 받습니다. FindText 또는 ReplaceText 함수와 함께 사용되는 애플리케이션 정의 또는 라이브러리 정의 콜백 함수입니다.
GetFileTitle	지정된 파일의 이름을 검색합니다.
GetOpenFileName	사용자가 열 파일 또는 파일 집합의 드라이브, 디렉터리 및 이름을 지정할 수 있는 열기 대화 상자를 만듭니다.
GetSaveFileName	사용자가 저장할 파일의 드라이브, 디렉터리 및 이름을 지정할 수 있는 저장 대화 상자를 만듭니다.
OFNHookProc	대화 상자에서 보낸 알림 메시지를 받습니다. 또한 함수는 자식 대화 상자 템플릿을 지정하여 정의한 추가 컨트롤에 대한 메시지를 받습니다. Explorer 스타일 열기 및 다른 이름으로 저장 대화 상자와 함께 사용되는 애플리케이션 정의 또는 라이브러리 정의 콜백 함수입니다.
OFNHookProcOldStyle	대화 상자 프로시저에 대한 메시지 또는 알림을 받습니다. 이 함수는 열기 및 다른 이름으로 저장 대화 상자와 함께 사용되는 애플리케이션 정의 또는 라이브러리 정의 콜백 함수입니다.
PagePaintHook	페이지 설정 대화 상자에서 샘플 페이지의 그리기를 사용자 지정할 수 있는 메시지를 받습니다. PageSetupDlg 함수와 함께 사용되는 애플리케이션 정의 또는 라이브러리 정의 콜백 함수입니다.
PageSetupDlg	사용자가 인쇄된 페이지의 특성을 지정할 수 있도록 하는 페이지 설정 대화 상자를 만듭니다. 이러한 특성에는 용지 크기 및 원본, 페이지 방향(세로 또는 가로) 및 페이지 여백의 너비가 포함됩니다.
PageSetupHook	페이지 설정 대화 상자의 기본 대화 상자 프로시저에 대한 메시지 또는 알림을 받습니다. PageSetupDlg함수와 함께 사용되는 애플리케이션 정의 또는 라이브러리 정의 콜백 함수입니다.
PrintDlg	인쇄 대화 상자를 표시합니다. 인쇄 대화 상자를 사용하면 사용자가 특정 인쇄 작업의 속성을 지정할 수 있습니다.
PrintDlgEx	사용자가 특정 인쇄 작업의 속성을 지정할 수 있도록 하는 Print 속성 시트를 표시합니다. Print속성 시트에는 인쇄 대화 상자와 유사한 컨트롤이 포함된 일반 페이지가 있습니다. 속성 시트에는 일반 페이지뿐만 아니라 추가 애플리케이션별 및 드라이버별 속성 페이지도 있을 수 있습니다.
PrintHookProc	인쇄 대화 상자의 기본 대화 상자 프로시저에 대한 메시지 또는 알림을 받습니다. PrintDlg 함수와 함께 사용되는 애플리케이션 정의 또는 라이브러리 정의 콜백 함수입니다.
ReplaceText	사용자가 검색할 문자열과 대체 문자열을 지정할 수 있는 시스템 정의 모덜리스 대화 상자와 찾기 및 바꾸기 작업을 제어하는 옵션을 만듭니다.
SetupHookProc	PrintDlg 함수와 함께 사용되는 애플리케이션 정의 또는 라이브러리 정의 콜백 함수입니다. 후크 프로시저는 설치 프로그램 인쇄 대화 상자의 기본 대화 상자 프로시저에 대한 메시지 또는 알림을 받습니다.

인터페이스

속성	Description
IPrintDialogCallback	Print 속성 시트가 표시되는 동안 애플리케이션이 PrintDlgEx 함수에서 알림 및 메시지를 받을 수 있도록 하는 메서드를 제공합니다.
IPrintDialogServices	현재 선택한 프린터에 대한 정보를 검색하기 위해 PrintDlgEx 함수를 사용하여 애플리케이션을 사용하도록 설정하는 메서드를 제공합니다.

메시지

이름	Description
CDM_GETFILEPATH	Explorer 스타일 열기 또는 다른 이름으로 저장 대화 상자에서 선택한 파일의 경로 및 파일 이름을 검색합니다. OFN_EXPLORER 플래그를 사용하여 대화 상자를 만들었어야 합니다. 그렇지 않으면 메시지가 실패합니다.
CDM_GETFOLDERIDLIST	Explorer 스타일 열기 또는 다른 이름으로 저장 대화 상자가 열려 있는 폴더에 해당하는 항목 식별자 목록의 주소를 검색합니다. OFN_EXPLORER 플래그를 사용하여 대화 상자를 만들었어야 합니다. 그렇지 않으면 메시지가 실패합니다.
CDM_GETFOLDERPATH	Explorer 스타일 열기 또는 다른 이름으로 저장 대화 상자의 현재 열려 있는 폴더 또는 디렉터리의 경로를 검색합니다. OFN_EXPLORER 플래그를 사용하여 대화 상자를 만들었어야 합니다. 그렇지 않으면 메시지가 실패합니다.
CDM_GETSPEC	현재 선택한 파일의 파일 이름(경로 제외)을 Explorer 스타일 열기 또는 다른 이름으로 저장 대화 상자에서 검색합니다. OFN_EXPLORER 플래그를 사용하여 대화 상자를 만들었어야 합니다. 그렇지 않으면 메시지가 실패합니다.
CDM_HIDECONTROL	Explorer 스타일 열기 또는 다른 이름으로 저장 대화 상자에서 지정된 컨트롤을 숨깁니다. OFN_EXPLORER 플래그를 사용하여 대화 상자를 만들었어야 합니다. 그렇지 않으면 메시지가 실패합니다.
CDM_SETCONTROLTEXT	Explorer 스타일 열기 또는 다른 이름으로 저장 대화 상자에서 지정된 컨트롤의 텍스트를 설정합니다. OFN_EXPLORER 플래그를 사용하여 대화 상자를 만들었어야 합니다. 그렇지 않으면 메시지가 실패합니다.
CDM_SETDEFEXT	Explorer 스타일 열기 또는 다른 이름으로 저장 대화 상자의 기본 파일 이름 확장명을 설정합니다. OFN_EXPLORER 플래그를 사용하여 대화 상자를 만들었어야 합니다. 그렇지 않으면 메시지가 실패합니다.
SETRGBSTRING	색 대화 상자의 후크 프로시저인 CCHookProc은 SETRGBSTRING 등록된 메시지를 대화 상자에 보내 현재 색 선택을 설정할 수 있습니다.
WM_CHOOSEFONT_GETLOGFONT	애플리케이션은 사용자의 현재 글꼴 선택에 대한 정보를 검색하기 위해 WM_CHOOSEFONT_GETLOGFONT 메시지를 글꼴 대화 상자로 보냅니다.
WM_CHOOSEFONT_SETFLAGS	애플리케이션은 WM_CHOOSEFONT_SETFLAGS 메시지를 글꼴 대화 상자로 보내 대화 상자의 표시 옵션을 설정합니다.
WM_CHOOSEFONT_SETLOGFONT	애플리케이션은 현재 논리 글꼴 정보를 설정하기 위해 WM_CHOOSEFONT_SETLOGFONT 메시지를 글꼴 대화 상자로 보냅니다.

알림

속성	Description
CDN_FILEOK	사용자가 파일 이름을 지정하고 확인 단추를 클릭하면 Explorer 스타일 열기 또는 다른 이름으로 저장 대화 상자에서 전송됩니다.
CDN_FOLDERCHANGE	새 폴더가 열릴 때 Explorer 스타일 열기 또는 다른 이름으로 저장 대화 상자에서 전송됩니다.
CDN_HELP	사용자가 도움말 단추를 클릭할 때 Explorer 스타일 열기 또는 다른 이름으로 저장 대화 상자에서 전송됩니다.
CDN_INCLUDEITEM	대화 상자가 셸 폴더의 항목 목록에 항목을 표시할지 여부를 결정하기 위해 다른 이름으로 열기 또는 저장 대화 상자에서 보냅니다. 사용자가 폴더를 열면 대화 상자에서 폴더의 각 항목에 대한 CDN_INCLUDEITEM 알림을 보냅니다. 대화 상자는 대화 상자를 만들 때 OFN_ENABLEINCLUDENOTIFY 플래그가 설정된 경우에만 이 알림을 보냅니다.
CDN_INITDONE	시스템에서 대화 상자의 컨트롤 정렬을 완료하면 Explorer 스타일 열기 또는 다른 이름으로 저장 대화 상자에서 전송됩니다. 시스템은 표준 컨트롤을 이동하여 자식 대화 상자의 컨트롤을 위한 공간을 만듭니다.
CDN_SELCHANGE	현재 열려 있는 폴더 또는 디렉터리의 내용을 표시하는 목록 상자에서 선택 항목이 변경되면 Explorer 스타일 열기 또는 다른 이름으로 저장 대화 상자에서 전송됩니다.
CDN_SHAREVIOLATION	사용자가 확인 단추를 클릭하고 선택한 파일에 대해 네트워크 공유 위반이 발생하는 경우 Explorer 스타일 열기 또는 다른 이름으로 저장 대화 상자에서 전송됩니다.
CDN_TYPECHANGE	사용자가 파일 형식 콤보 상자에서 새 파일 형식을 선택할 때 Explorer 스타일 열기 또는 다른 이름으로 저장 대화 상자에서 보냅니다.
COLOROKSTRING	색 대화 상자는 사용자가 색을 선택하고 확인 단추를 클릭하면 COLOROKSTRING 등록된 메시지를 후크 프로시저 CCHookProc에 보냅니다. 후크 프로시저는 색을 적용하고 대화 상자를 닫거나 색을 거부하고 대화 상자를 열어 두도록 할 수 있습니다.
FILEOKSTRING	다른 이름으로 열기 또는 저장 대화 상자는 사용자가 파일 이름을 지정하고 확인 단추를 클릭하면 FILEOKSTRING 등록된 메시지를 후크 프로시저 OFNHookProc로 보냅니다. 후크 프로시저는 파일 이름을 수락하고 대화 상자를 닫거나 파일 이름을 거부하고 대화 상자를 열어 두도록 허용할 수 있습니다.
FINDMSGSTRING	찾기 또는 바꾸기 대화 상자는 사용자가 다음찾기, 바꾸기 또는 모두 바꾸기 단추를 클릭하거나 대화 상자를 닫을 때 FINDMSGSTRING 등록된 메시지를 소유자 창의 창 프로시저로 보냅니다.
HELPMSGSTRING	일반적인 대화 상자는 사용자가 도움말 단추를 클릭할 때 HELPMSGSTRING 등록된 메시지를 소유자 창의 창 프로시저로 보냅니다.
LBSELCHSTRING	다른 이름으로 열기 또는 저장 대화 상자는 대화 상자의 목록 상자 또는 콤보 상자에서 선택 항목이 변경될 때 LBSELCHSTRING 등록된 메시지를 후크 프로시저로 보냅니다.
SHAREVISTRING	사용자가 확인 단추를 클릭할 때 선택한 파일에 대해 공유 위반이 발생하는 경우 다른 이름으로 열기 또는 저장 대화 상자는 SHAREVISTRING 등록된 메시지를 후크 프로시저 OFNHookProc로 보냅니다.
WM_PSD_ENVSTAMPRECT	페이지 설정 대화 상자 PagePaintHook의 후크 프로시저에 대화 상자가 샘플 페이지의 봉투 스탬프 사각형을 그리려고 함을 알립니다.
WM_PSD_FULLPAGERECT	페이지 설정 대화 상자에서 샘플 페이지 사각형의 좌표에 대한 PagePaintHook 후크 프로시저를 알립니다. 이 대화 상자는 샘플 페이지의 내용을 그리려고 할 때 이 메시지를 보냅니다.
WM_PSD_GREEKTEXTRECT	페이지 설정 대화 상자 PagePaintHook의 후크 프로시저에 대화 상자가 샘플 페이지의 여백 사각형 안에 그리스어 텍스트를 그리려고 한다는 것을 알립니다.
WM_PSD_MARGINRECT	페이지 설정 대화 상자 PagePaintHook의 후크 프로시저에 대화 상자가 샘플 페이지의 여백 사각형을 그릴 것임을 알립니다.
WM_PSD_MINMARGINRECT	샘플 페이지에서 여백 사각형의 좌표에 대한 PagePaintHook 후크 프로시저에 알립니다. 페이지 설정 대화 상자는 샘플 페이지의 내용을 그리려고 할 때 이 메시지를 보냅니다.
WM_PSD_PAGESETUPDLG	페이지 설정 대화 상자가 샘플 페이지의 내용을 그리려고 한다는 것을 PagePaintHook 후크 프로시저에 알립니다. 후크 프로시저는 이 메시지를 사용하여 샘플 페이지의 내용 그리기와 관련된 초기화 작업을 수행할 수 있습니다.
WM_PSD_YAFULLPAGERECT	페이지 설정 대화 상자 PagePaintHook의 후크 프로시저에 대화 상자가 봉투 샘플 페이지의 반환 주소 부분을 그리려고 함을 알립니다.

구조체

속성	Description
CHOOSECOLOR	ChooseColor 함수가 색 대화 상자를 초기화하는 데 사용하는 정보를 포함합니다. 사용자가 대화 상자를 닫은 후 시스템은 이 구조에서 사용자의 선택 항목에 대한 정보를 반환합니다.
CHOOSEFONT	ChooseFont 함수가 글꼴 대화 상자를 초기화하는 데 사용하는 정보를 포함합니다. 사용자가 대화 상자를 닫은 후 시스템은 이 구조에서 사용자의 선택 항목에 대한 정보를 반환합니다.
DEVNAMES	프린터의 드라이버, 디바이스 및 출력 포트 이름을 식별하는 문자열을 포함합니다. PrintDlgEx 및 PrintDlg 함수는 이러한 문자열을 사용하여 시스템 정의 인쇄 속성 시트 또는 인쇄 대화 상자를 초기화합니다. 사용자가 속성 시트 또는 대화 상자를 닫으면 선택한 프린터에 대한 정보가 이 구조에 반환됩니다.
FINDREPLACE	FindText 및 ReplaceText 함수가 찾기 및 바꾸기 대화 상자를 초기화하는 데 사용하는 정보를 포함합니다. FINDMSGSTRING 등록된 메시지는 이 구조를 사용하여 사용자의 검색 또는 대체 입력을 찾기 또는 바꾸기 대화 상자의 소유자 창에 전달합니다.
OFNOTIFY	열기 또는 다른 이름으로 저장 대화 상자의 OFNHookProc 후크 프로시저로 전송된 WM_NOTIFY 메시지에 대한 정보를 Ccontains합니다. WM_NOTIFY 메시지의 lParam 매개 변수는 OFNOTIFY 구조체에 대한 포인터입니다.
OFNOTIFYEX	CDN_INCLUDEITEM 알림 메시지에 대한 정보를 포함합니다.
OPENFILENAME	GetOpenFileName 및 GetSaveFileName 함수가 다른 이름으로 열기 또는 다른 이름으로 저장 대화 상자를 초기화하는 데 사용하는 정보를 포함합니다. 사용자가 대화 상자를 닫은 후 시스템은 이 구조에서 사용자의 선택에 대한 정보를 반환합니다.
OPENFILENAME_NT4	_WIN32_WINNT 0x0400 설정된 OPENFILENAME 과 동일합니다.
PAGESETUPDLG	PageSetupDlg 함수가 페이지 설정 대화 상자를 초기화하는 데 사용하는 정보를 포함합니다. 사용자가 대화 상자를 닫은 후 시스템은 이 구조의 사용자 정의 페이지 매개 변수에 대한 정보를 반환합니다.
PRINTDLG	PrintDlg 함수가 인쇄 대화 상자를 초기화하는 데 사용하는 정보를 포함합니다. 사용자가 대화 상자를 닫은 후 시스템은 이 구조를 사용하여 사용자의 선택 항목에 대한 정보를 반환합니다.
PRINTDLGEX	PrintDlgEx 함수가 Print 속성 시트를 초기화하는 데 사용하는 정보를 포함합니다. 사용자가 속성 시트를 닫은 후 시스템은 이 구조를 사용하여 사용자의 선택 항목에 대한 정보를 반환합니다.
PRINTPAGERANGE	인쇄 작업의 페이지 범위를 지정합니다. 인쇄 작업에는 둘 이상의 페이지 범위가 있을 수 있습니다. 이 정보는 PrintDlgEx 함수를 호출할 때 PRINTDLGEX 구조체에 제공됩니다.