Библиотека общих диалоговых окон

  • Статья

Библиотека общих диалоговых окон содержит набор диалоговых окон для выполнения распространенных задач приложения, таких как открытие файлов, выбор значений цвета и печать документов. Общие диалоговые окна позволяют реализовать согласованный подход к пользовательскому интерфейсу приложения. Это сокращает объем усилий, которые пользователи тратят на обучение поведения пользовательского интерфейса для приложения.

В этом разделе описываются распространенные диалоговые окна, которые включают диалоговое окно "Открыть и сохранить как файл", диалоговое окно "Поиск и замена", "Печать", "Настройка печати", "Лист свойств" и "Настройка страницы", а также диалоговые окна "Цвет" и "Шрифт".

Примечание.

Начиная с Windows Vista, диалоговые окна "Открыть и сохранить как распространенные" были заменены диалоговым окном "Общий элемент". Мы рекомендуем использовать API общих диалоговых окон вместо этих диалоговых окон из библиотеки общих диалоговых окон.

В этом разделе

Имя Описание
Распространенные типы диалоговых окон Обсуждает различные диалоговые окна.
Общие флаги инициализации диалогового окна Описывает, как флаги используются для изменения поведения и внешнего вида общего диалогового окна.
Настройка общих диалоговых окон Описывает использование общих диалоговых окон.
Использование общих диалоговых окон Охватывает задачи, которые вызывают общие диалоговые окна.
Справочник по общему диалоговому оккуму Содержит ссылку на API.

Функции

Имя Описание
CCHookProc Получает сообщения или уведомления, предназначенные для диалогового окна по умолчанию в диалоговом окне "Цвет ". Это определяемая приложением или библиотека функция обратного вызова, используемая с функцией ChooseColor .
CFHookProc Получает сообщения или уведомления, предназначенные для диалогового окна по умолчанию в диалоговом окне "Шрифт ". Это процедура обратного вызова, определяемая приложением или библиотекой, которая используется с функцией ChooseFont.
Выбор Цвета Создает диалоговое окно "Цвет", позволяющее пользователю выбрать цвет.
Выбор Фонта Создает диалоговое окно "Шрифт", позволяющее пользователю выбирать атрибуты для логического шрифта. К этим атрибутам относятся семейство шрифтов и связанный стиль шрифта, размер точки, эффекты (подчеркивание, удар и цвет текста), а также скрипт (или набор символов).
CommDlgExtendedError Возвращает распространенный код ошибки диалогового окна. Этот код указывает на последнюю ошибку во время выполнения одной из распространенных функций диалогового окна.
FindText Создает системное диалоговое окно поиска без режима, позволяющее пользователю указать строку для поиска и параметров, используемых при поиске текста в документе.
FRHookProc Получает сообщения или уведомления, предназначенные для диалогового окна по умолчанию в диалоговом окне поиска или замены . Это определяемая приложением или библиотека функция обратного вызова, используемая с функцией FindText или ReplaceText.
GetFileTitle Извлекает имя указанного файла.
GetOpenFileName Создает диалоговое окно "Открыть", позволяющее пользователю указать диск, каталог и имя файла или набора файлов, которые нужно открыть.
GetSaveFileName Создает диалоговое окно "Сохранить", позволяющее пользователю указать диск, каталог и имя файла для сохранения.
OFNHookProc Получает уведомления, отправленные из диалогового окна. Функция также получает сообщения для любых дополнительных элементов управления, определенных путем указания дочернего шаблона диалогового окна. Это определяемая приложением или библиотека функция обратного вызова, используемая в диалоговом окне "Открыть и сохранить как" в стиле обозревателя.
OFNHookProcOldStyle Получает сообщения или уведомления, предназначенные для процедуры диалогового окна. Это определяемая приложением или библиотека функция обратного вызова, которая используется в диалоговом окне "Открыть и сохранить как ".
PagePaintHook Получает сообщения, позволяющие настроить рисунок примера страницы в диалоговом окне "Настройка страницы". Это определяемая приложением или библиотека функция обратного вызова, используемая с функцией PageSetupDlg.
PageSetupDlg Создает диалоговое окно установки страницы, позволяющее пользователю указывать атрибуты печатной страницы. К этим атрибутам относятся размер бумаги и источник, ориентация страницы (книжная или альбомная) и ширина полей страницы.
PageSetupHook Получает сообщения или уведомления, предназначенные для диалогового окна по умолчанию в диалоговом окне "Настройка страницы". Это определяемая приложением или библиотека функция обратного вызова, используемая сфункцией PageSetupDlg.
PrintDlg Отображает диалоговое окно печати. Диалоговое окно "Печать " позволяет пользователю указывать свойства определенного задания печати.
PrintDlgEx Отображает лист свойств Print, позволяющий пользователю указывать свойства определенного задания печати. Листсвойств Print содержит страницу "Общие", которая содержит элементы управления, аналогичные диалоговому окне "Печать". Лист свойств также может содержать дополнительные страницы свойств для конкретного приложения и драйвера, а также страницу "Общие ".
PrintHookProc Получает сообщения или уведомления, предназначенные для диалогового окна по умолчанию в диалоговом окне "Печать ". Это определяемая приложением или библиотека функция обратного вызова, используемая с функцией PrintDlg.
ReplaceText Создает системное диалоговое окно без режима, позволяющее пользователю указать строку для поиска и замены, а также параметры управления операциями поиска и замены.
SetupHookProc Определяемая приложением или библиотека функция обратного вызова, используемая с функцией PrintDlg. Процедура перехватчика получает сообщения или уведомления, предназначенные для диалогового окна по умолчанию в диалоговом окне "Настройка печати".

Интерфейсы

Имя Описание
IPrintDialogCallback Предоставляет методы, позволяющие приложению получать уведомления и сообщения из функции PrintDlgEx при отображении листа свойств печати.
IPrintDialogServices Предоставляет методы, позволяющие приложению использовать функцию PrintDlgEx для получения сведений о выбранном принтере.

Сообщения

Имя Описание
CDM_GETFILEPATH Извлекает путь и имя файла выбранного файла в диалоговом окне "Открыть или сохранить как ". Диалоговое окно должно быть создано с флагом OFN_EXPLORER; В противном случае сообщение завершается ошибкой.
CDM_GETFOLDERIDLIST Извлекает адрес списка идентификаторов элемента, соответствующего папке, открытой в диалоговом окне "Открыть" или "Сохранить как". Диалоговое окно должно быть создано с флагом OFN_EXPLORER ; в противном случае сообщение завершается ошибкой.
CDM_GETFOLDERPATH Извлекает путь к открытой папке или каталогу для диалогового окна "Открыть или сохранить как" в стиле обозревателя. Диалоговое окно должно быть создано с флагом OFN_EXPLORER ; в противном случае сообщение завершается ошибкой.
CDM_GETSPEC Извлекает имя файла (не включая путь) выбранного файла в диалоговом окне "Открыть или сохранить как" в стиле проводника. Диалоговое окно должно быть создано с флагом OFN_EXPLORER ; в противном случае сообщение завершается ошибкой.
CDM_HIDECONTROL Скрывает указанный элемент управления в диалоговом окне "Открыть или сохранить как" в стиле обозревателя. Диалоговое окно должно быть создано с флагом OFN_EXPLORER ; в противном случае сообщение завершается ошибкой.
CDM_SETCONTROLTEXT Задает текст для указанного элемента управления в диалоговом окне "Открыть или сохранить как ". Диалоговое окно должно быть создано с флагом OFN_EXPLORER ; в противном случае сообщение завершается ошибкой.
CDM_SETDEFEXT Задает расширение имени файла по умолчанию для диалогового окна "Открыть или сохранить как" в стиле обозревателя. Диалоговое окно должно быть создано с флагом OFN_EXPLORER ; в противном случае сообщение завершается ошибкой.
SETRGBSTRING Процедура перехватчика диалогового окна цвета CCHookProc может отправить зарегистрированное сообщение SETRGBSTRING в диалоговое окно, чтобы задать текущий цвет.
WM_CHOOSEFONT_GETLOGFONT Приложение отправляет WM_CHOOSEFONT_GETLOGFONT сообщение в диалоговое окно "Шрифт" для получения сведений о текущих выборах шрифтов пользователя.
WM_CHOOSEFONT_SETFLAGS Приложение отправляет WM_CHOOSEFONT_SETFLAGS сообщение в диалоговое окно "Шрифт", чтобы задать параметры отображения для диалогового окна.
WM_CHOOSEFONT_SETLOGFONT Приложение отправляет сообщение WM_CHOOSEFONT_SETLOGFONT в диалоговое окно "Шрифт", чтобы задать текущие сведения о логическом шрифте.

Notifications

Имя Описание
CDN_FILEOK Отправляется в диалоговом окне "Открыть или сохранить как", когда пользователь задает имя файла и нажимает кнопку "ОК".
CDN_FOLDERCHANGE При открытии новой папки отправляется диалоговое окно "Открыть в стиле обозревателя" или "Сохранить как".
CDN_HELP Отправляется в диалоговом окне "Открыть или сохранить как", когда пользователь нажимает кнопку "Справка".
CDN_INCLUDEITEM Отправляется диалоговым окном "Открыть или сохранить как ", чтобы определить, должен ли диалоговое окно отображать элемент в списке элементов папки оболочки. Когда пользователь открывает папку, диалоговое окно отправляет уведомление CDN_INCLUDEITEM для каждого элемента в папке. Диалоговое окно отправляет это уведомление только в том случае, если флаг OFN_ENABLEINCLUDENOTIFY был установлен при создании диалогового окна.
CDN_INITDONE Отправляется в диалоговом окне "Открыть или сохранить как", когда система завершит упорядочивание элементов управления в диалоговом окне. Система перемещает стандартные элементы управления, чтобы освободить место для элементов управления дочерним диалоговым окном.
CDN_SELCHANGE Отправляется в диалоговом окне "Открыть или сохранить как" в диалоговом окне обозревателя при изменении выбора в списке, отображающем содержимое открываемой в данный момент папки или каталога.
CDN_SHAREVIOLATION Отправляется в диалоговом окне "Открыть или сохранить как", когда пользователь нажимает кнопку "ОК", а для выбранного файла возникает нарушение общего доступа к сети.
CDN_TYPECHANGE Отправляется в диалоговом окне "Открыть или сохранить как", когда пользователь выбирает новый тип файла из поля со списком типов файлов.
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, что диалоговое окно будет нарисовать часть возвращаемого адреса примера страницы конверта.

Структуры

Имя Описание
CHOOSECOLOR Содержит сведения, которые функция ChooseColor использует для инициализации диалогового окна "Цвет". После закрытия диалогового окна система возвращает сведения о выборе пользователя в этой структуре.
CHOOSEFONT Содержит сведения, которые функция ChooseFont использует для инициализации диалогового окна "Шрифт ". После закрытия диалогового окна система возвращает сведения о выборе пользователя в этой структуре.
DEVNAMES Содержит строки, определяющие имена драйверов, устройств и выходных портов принтера. Функции PrintDlgEx и PrintDlg используют эти строки для инициализации системного листа свойств печати или диалогового окна печати. Когда пользователь закрывает лист свойств или диалоговое окно, в этой структуре возвращаются сведения о выбранном принтере.
FINDREPLACE Содержит сведения, используемые функциями FindText и ReplaceText для инициализации диалоговых окон поиска и замены. Зарегистрированное сообщение FINDMSGSTRING использует эту структуру для передачи входных данных поиска или замены пользователя в окно владельца диалогового окна поиска или замены.
OFNOTIFY Сведения о WM_NOTIFY сообщении, отправленном в процедуру перехватчика OFNHookProc для диалогового окна "Открыть" или "Сохранить как". Параметр lParam сообщения WM_NOTIFY является указателем на структуру OFNOTIFY.
OFNOTIFYEX Содержит сведения о сообщении CDN_INCLUDEITEM уведомления.
OPENFILENAME Содержит сведения о функциях GetOpenFileName и GetSaveFileName , используемых для инициализации диалогового окна "Открыть " или "Сохранить как ". После закрытия диалогового окна система возвращает сведения о выборе пользователя в этой структуре.
OPENFILENAME_NT4 Идентичен OPENFILENAME с _WIN32_WINNT для 0x0400.
PAGESETUPDLG Содержит сведения о функции PageSetupDlg , которую использует для инициализации диалогового окна установки страницы. После закрытия диалогового окна система возвращает сведения о параметрах страницы, определенных пользователем в этой структуре.
PRINTDLG Содержит сведения, которые функция PrintDlg использует для инициализации диалогового окна печати. После закрытия диалогового окна система использует эту структуру для возврата сведений о выборах пользователя.
PRINTDLGEX Содержит сведения, которые функция PrintDlgEx использует для инициализации листа свойств Print. После закрытия листа свойств система использует эту структуру для возврата сведений о выборах пользователя.
PRINTPAGERANGE Задает диапазон страниц в задании печати. Задание печати может иметь несколько диапазонов страниц. Эти сведения предоставляются в структуре PRINTDLGEX при вызове функции PrintDlgEx.