Распространенные типы диалоговых окон

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

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

. Описание
Цвет
Отображает доступные цвета и при необходимости позволяет пользователю создавать пользовательские цвета. Пользователь может выбрать базовый или пользовательский цвет. Используйте функцию ChooseColor и структуру CHOOSECOLOR . Дополнительные сведения см. в разделе Диалоговое окно цвета.
Поиск
Отображает диалоговое окно, в котором пользователь может ввести строку для поиска. Пользователь также может указать параметры поиска, такие как направление поиска и учет регистра в поиске. Используйте функцию FindText и структуру FINDREPLACE . Дополнительные сведения см. в разделе Поиск и замена диалоговых окон.
Шрифт
Отображает диалоговое окно, в котором пользователь может выбрать семейство шрифтов и соответствующий стиль шрифта, размеры точек и другие атрибуты шрифта, такие как цвет шрифта, подчеркивание или зачеркивка. Используйте функцию ChooseFont и структуру CHOOSEFONT . Дополнительные сведения см. в разделе Диалоговое окно шрифта.
Открыть
Отображает диалоговое окно, в котором пользователь может ввести или выбрать имя открываемого объекта имени файла или оболочки. Диалоговое окно содержит списки дисков, каталогов и расширений пространства имен оболочки, которые позволяют пользователю просматривать пространство имен оболочки. Он также содержит список расширений имен файлов, которые позволяют пользователю фильтровать отображаемые имена файлов. Используйте функцию GetOpenFileName и структуру OPENFILENAME . Дополнительные сведения см. в разделе Диалоговое окно "Открытие и сохранение как".
Настройка страницы
Отображает текущую конфигурацию страницы. Пользователь может выбрать параметры конфигурации страницы, такие как ориентация бумаги, размер, источник и поля. Используйте функцию PageSetupDlg и структуру PAGESETUPDLG . Дополнительные сведения см. в разделе Диалоговое окно "Настройка страницы".
Печать
Отображает сведения об установленном принтере и его конфигурации. Пользователь может выбрать параметры задания печати, такие как диапазон страниц для печати и количество копий, и начать процесс печати. Используйте функцию PrintDlg и структуру PRINTDLG . Дополнительные сведения см. в разделе Диалоговое окно печати.
Чтобы отобразить страницу свойств Печать , а не диалоговое окно Печать , используйте функцию PrintDlgEx со структурой PRINTDLGEX . Страница Общие страницы свойств похожа на диалоговое окно Печать . Страница свойств может содержать дополнительные страницы свойств для конкретных приложений и драйверов после страницы Общие . Дополнительные сведения см. в разделе Печать страницы свойств.
Заменить
Отображает диалоговое окно, в котором пользователь может ввести строку для поиска и строку замены. Пользователь может указать параметры поиска, например, учитывается ли регистр, и варианты замены, например область замены. Используйте функцию ReplaceText и структуру FINDREPLACE . Дополнительные сведения см. в разделе Поиск и замена диалоговых окон.
Сохранить как
Отображает диалоговое окно, в котором пользователь может ввести или выбрать имя, с помощью которого следует сохранить файл или объект пространства имен оболочки. Диалоговое окно содержит списки дисков, каталогов и расширений пространства имен оболочки, которые позволяют пользователю просматривать пространство имен оболочки. Он также содержит список расширений имен файлов, которые позволяют пользователю фильтровать отображаемые имена файлов. Используйте функцию GetSaveFileName и структуру OPENFILENAME . Дополнительные сведения см. в разделе Диалоговое окно "Открытие и сохранение как".

Хотя доступно диалоговое окно "Настройка печати ", оно заменено диалоговым окном "Параметры страницы ". Приложения должны использовать диалоговое окно Параметры страницы , а не диалоговое окно Параметры печати .

Все распространенные диалоговые окна являются модальными, за исключением диалоговых окон "Найти и заменить ". Перед возвратом функции, используемой для создания диалогового окна, пользователь должен закрыть модальные диалоговые окна. Диалоговые окна "Найти и заменить " являются немодерными; функция возвращается до закрытия диалогового окна. Если вы используете диалоговые окна Найти и заменить, необходимо также использовать функцию IsDialogMessage в цикле сообщений main приложения, чтобы убедиться, что эти диалоговые окна правильно обрабатывают ввод с помощью клавиатуры, например клавиши TAB и ESC.