Поделиться через


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

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

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

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

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

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

Имя Описание
CreateDialog Создает немодное диалоговое окно на основе ресурса шаблона диалогового окна.
CreateDialogIndirect Создает немодное диалоговое окно на основе шаблона диалогового окна в памяти.
CreateDialogIndirectParam Создает немодное диалоговое окно на основе шаблона диалогового окна в памяти. Перед отображением диалогового окна функция передает определенное приложением значение в процедуру диалогового окна в качестве параметра lParamсообщения WM_INITDIALOG . Приложение может использовать это значение для инициализации элементов управления диалоговых окон.
CreateDialogParam Создает немодное диалоговое окно на основе ресурса шаблона диалогового окна. Перед отображением диалогового окна функция передает определенное приложением значение в процедуру диалогового окна в качестве параметра lParamсообщения WM_INITDIALOG . Приложение может использовать это значение для инициализации элементов управления диалоговых окон.
DefDlgProc Вызывает процедуру диалогового окна по умолчанию, чтобы обеспечить обработку по умолчанию для всех оконных сообщений, которые не обрабатываются диалоговым окном с закрытым классом окна.
Диалоговое окно Создает модальное диалоговое окно на основе ресурса шаблона диалогового окна. 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 Создает, отображает и управляет окном сообщения. Окно сообщения содержит определенное приложением сообщение и заголовок, а также любое сочетание предопределенных значков и кнопок нажатия. Кнопки используются на языке пользовательского интерфейса системы.
MessageBoxIndirect Создает, отображает и управляет окном сообщения. Окно сообщения содержит текст и заголовок сообщения, определяемые приложением, любой значок и любое сочетание предопределенных кнопок нажатия.
SendDlgItemMessage Отправляет сообщение указанному элементу управления в диалоговом окне.
SetDlgItemInt Задает текст элемента управления в диалоговом окне строковое представление указанного целочисленного значения.
SetDlgItemText Задает заголовок или текст элемента управления в диалоговом окне.

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

Имя Описание
DM_GETDEFID Извлекает идентификатор элемента управления push-кнопкой по умолчанию для диалогового окна.
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 .