Диалоговые окна (диалоговые окна)

Диалоговое окно — это временное окно, которое создает приложение для получения входных данных пользователя. Приложение обычно использует диалоговые окна для запроса пользователя дополнительных сведений о элементах меню. Диалоговое окно обычно содержит один или несколько элементов управления (дочерние окна), с помощью которых пользователь вводит текст, выбирает параметры или направляет действие.

Windows также предоставляет стандартные диалоговые окна, поддерживающие общие пункты меню, такие как Открыть и печать. Приложения, использующие эти пункты меню, должны использовать общие диалоговые окна для запроса ввода этого пользователя независимо от типа приложения.

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

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

Функции диалогового окна

Имя	Описание
CreateDialog	Создает диалоговое окно без режима из ресурса шаблона диалогового окна.
CreateDialogIndirect	Создает диалоговое окно без режима из шаблона диалогового окна в памяти.
CreateDialogIndirectParam	Создает диалоговое окно без режима из шаблона диалогового окна в памяти. Перед отображением диалогового окна функция передает определяемое приложением значение в процедуру диалогового окна в качестве параметра lParam сообщения WM_INITDIALOG. Приложение может использовать это значение для инициализации элементов управления диалоговым окном.
CreateDialogParam	Создает диалоговое окно без режима из ресурса шаблона диалогового окна. Перед отображением диалогового окна функция передает определяемое приложением значение в процедуру диалогового окна в качестве параметра lParam сообщения WM_INITDIALOG. Приложение может использовать это значение для инициализации элементов управления диалоговым окном.
DefDlgProc	Вызывает процедуру диалогового окна по умолчанию, чтобы обеспечить обработку по умолчанию для любых сообщений окна, которые диалоговое окно с классом закрытого окна не обрабатывает.
DialogBox	Создает модальное диалоговое окно из ресурса шаблона диалогового окна. DialogBox не возвращает управление, пока указанная функция обратного вызова не завершает модальное диалоговое окно путем вызова функции EndDialog.
DialogBoxIndirect	Создает модальное диалоговое окно из шаблона диалогового окна в памяти. DialogBoxIndirect не возвращает управление, пока указанная функция обратного вызова не завершает модальное диалоговое окно путем вызова функции EndDialog.
DialogBoxIndirectParam	Создает модальное диалоговое окно из шаблона диалогового окна в памяти. Перед отображением диалогового окна функция передает определяемое приложением значение в процедуру диалогового окна в качестве параметра lParam сообщения WM_INITDIALOG. Приложение может использовать это значение для инициализации элементов управления диалоговым окном.
DialogBoxParam	Создает модальное диалоговое окно из ресурса шаблона диалогового окна. Перед отображением диалогового окна функция передает определяемое приложением значение в процедуру диалогового окна в качестве параметра lParam сообщения WM_INITDIALOG. Приложение может использовать это значение для инициализации элементов управления диалоговым окном.
DialogProc	Определяемая приложением функция обратного вызова, используемая с CreateDialog и семействами функций DialogBox. Он обрабатывает сообщения, отправленные в модальное или безрежимное диалоговое окно. Тип DLGPROC определяет указатель на эту функцию обратного вызова. DialogProc — это заполнитель для имени определяемой приложением функции.
EndDialog	Уничтожает модальное диалоговое окно, что приводит к прекращению любой обработки для диалогового окна.
GetDialogBaseUnits	Извлекает базовые единицы диалога системы, которые являются средней шириной и высотой символов в системном шрифте. Для диалоговых окон, использующих системный шрифт, эти значения можно использовать для преобразования между единицами шаблонов диалогов, как указано в шаблонах диалоговых окон и пикселях. Для диалоговых окон, которые не используют системный шрифт, преобразование из единиц шаблона диалога в пиксели зависит от шрифта, используемого диалоговым окном.
GetDlgCtrlID	Извлекает идентификатор указанного элемента управления.
GetDlgItem	Извлекает дескриптор в элемент управления в указанном диалоговом окне.
GetDlgItemInt	Преобразует текст указанного элемента управления в диалоговом окне в целочисленное значение.
GetDlgItemText	Извлекает заголовок или текст, связанный с элементом управления в диалоговом окне.
GetNextDlgGroupItem	Извлекает дескриптор первого элемента управления в группе элементов управления, которые предшествуют (или следуют) указанному элементу управления в диалоговом окне.
GetNextDlgTabItem	Извлекает дескриптор к первому элементу управления с WS_TABSTOP стилем, который предшествует указанному элементу управления (или следует).
IsDialogMessage	Определяет, предназначено ли сообщение для указанного диалогового окна и, если это так, обрабатывает сообщение.
MapDialogRect	Преобразует указанные блоки диалогового окна в единицы экрана (пиксели). Функция заменяет координаты в указанной структуре RECT преобразованными координатами, что позволяет использовать структуру для создания диалогового окна или размещения элемента управления в диалоговом окне.
MessageBox	Отображает модальное диалоговое окно, содержащее системный значок, набор кнопок и краткое сообщение для конкретного приложения, например сведения о состоянии или ошибке. Поле сообщения возвращает целочисленное значение, указывающее, какая кнопка щелкнула пользователя.
MessageBoxEx	Создает, отображает и управляет окном сообщения. Поле сообщения содержит определенное приложением сообщение и заголовок, а также любое сочетание предопределенных значков и кнопок push-уведомлений. Кнопки находятся на языке системного пользовательского интерфейса.
MessageBoxIndirect	Создает, отображает и управляет окном сообщения. Поле сообщения содержит текст сообщения и название приложения, любой значок и любую комбинацию предопределенных кнопок.
SendDlgItemMessage	Отправляет сообщение указанному элементу управления в диалоговом окне.
SetDlgItemInt	Задает текст элемента управления в диалоговом окне строковым представлением указанного целочисленного значения.
SetDlgItemText	Задает заголовок или текст элемента управления в диалоговом окне.

Сообщения в диалоговом окне

Имя	Описание
DM_GETDEFID	Извлекает идентификатор элемента управления кнопки по умолчанию для диалогового окна.
DM_REPOSITION	Переместит диалоговое окно верхнего уровня, чтобы оно соответствовало области рабочего стола. Приложение может отправить это сообщение в диалоговое окно после изменения размера, чтобы убедиться, что все диалоговое окно остается видимым.
DM_SETDEFID	Изменяет идентификатор кнопки нажатия по умолчанию для диалогового окна.

Уведомления в диалоговом окне

Имя	Описание
WM_CTLCOLORDLG	Отправляется в диалоговое окно, прежде чем система рисует диалоговое окно. Отвечая на это сообщение, диалоговое окно может задать его текст и фоновые цвета с помощью указанного дескриптора контекста устройства отображения.
WM_ENTERIDLE	Отправлено в окно владельца модального диалогового окна или меню, которое вводит состояние простоя. Модальное диалоговое окно или меню вводит состояние простоя, когда сообщения в очереди не ожидаются после обработки одного или нескольких предыдущих сообщений.
WM_GETDLGCODE	Отправлена в процедуру окна, связанную с элементом управления. По умолчанию система обрабатывает все входные данные клавиатуры в элемент управления; Система интерпретирует определенные типы ввода клавиатуры в виде клавиш навигации в диалоговом окне. Чтобы переопределить это поведение по умолчанию, элемент управления может реагировать на сообщение WM_GETDLGCODE, чтобы указать типы входных данных, которые он хочет обработать.
WM_INITDIALOG	Отправляется в процедуру диалогового окна непосредственно перед отображением диалогового окна. Процедуры диалогового окна обычно используют это сообщение для инициализации элементов управления и выполнения других задач инициализации, влияющих на внешний вид диалогового окна.
WM_NEXTDLGCTL	Отправлена в процедуру диалогового окна, чтобы задать фокус клавиатуры другим элементом управления в диалоговом окне.

Структуры диалогового окна

Имя	Описание
DLGITEMTEMPLATE	Определяет измерения и стиль элемента управления в диалоговом окне. Одна или несколько этих структур объединяются с структурой DLGTEMPLATE для формирования стандартного шаблона диалогового окна.
DLGITEMTEMPLATEEX	Описывает расширенное диалоговое окно. Описание формата расширенного диалогового окна см. в разделе DLGTEMPLATEEX.
DLGTEMPLATE	Определяет измерения и стиль диалогового окна. Эта структура всегда является первой в стандартном шаблоне диалогового окна, а также указывает количество элементов управления в диалоговом окне и, следовательно, указывает количество последующих структур DLGITEMTEMPLATE в шаблоне.
DLGTEMPLATEEX	Шаблон расширенного диалогового окна начинается с заголовка DLGTEMPLATEEX, описывающего диалоговое окно, и задает количество элементов управления в диалоговом окне. Для каждого элемента управления в диалоговом окне расширенный шаблон диалогового окна содержит блок данных, использующий формат DLGITEMTEMPLATEEX для описания элемента управления.
MSGBOXPARAMS	Содержит сведения, используемые для отображения поля сообщения. Функция MessageBoxIndirect использует эту структуру.