Диалоговые окна

Обзор технологии диалоговых окон.

Для разработки диалоговых окон вам потребуются следующие заголовки:

• commdlg.h

Рекомендации по программированию для этой технологии см. в следующих разделах:

• Диалоговые окна

Функции

AddRef Метод IPrintDialogCallback::AddRef (commdlg.h) — это метод AddRef IUnknown, который уменьшает количество ссылок для интерфейса в COM-объекте.
AddRef Метод IPrintDialogServices::AddRef (commdlg.h) — это метод AddRef IUnknown, который уменьшает количество ссылок для интерфейса в COM-объекте.
CDSIZEOF_STRUCT Возвращает размер структуры до указанного элемента.
ChooseColorA Функция CHOOSECOLORA (ANSI) (commdlg.h) содержит сведения, которые функция ChooseColor использует для инициализации диалогового окна Цвет.
ВыберитеColorW Широкая строковая версия ChooseColor
ВыберитеFontA AsCII-версия ChooseFont
ВыберитеFontW Широкая строковая версия ChooseFont
CommDlg_OpenSave_GetFilePathA ВЕРСИЯ ASCII CommDlg_OpenSave_GetFilePath
CommDlg_OpenSave_GetFilePathW Расширенная строковая версия CommDlg_OpenSave_GetFilePath
CommDlg_OpenSave_GetFolderIDList Извлекает адрес списка идентификаторов элементов, соответствующий папке, в которую в настоящее время открыто диалоговое окно "Открыть" или "Сохранить как" в стиле Обозреватель.
CommDlg_OpenSave_GetFolderPathA ВЕРСИЯ ASCII CommDlg_OpenSave_GetFolderPath
CommDlg_OpenSave_GetFolderPathW Широкая строковая версия CommDlg_OpenSave_GetFolderPath
CommDlg_OpenSave_GetSpecA ВЕРСИЯ ASCII CommDlg_OpenSave_GetSpec
CommDlg_OpenSave_GetSpecW Версия CommDlg_OpenSave_GetSpec с широкой строкой
CommDlg_OpenSave_HideControl Скрывает указанный элемент управления в Обозреватель стиле диалогового окна "Открыть" или "Сохранить как".
CommDlg_OpenSave_SetControlText Задает текст для указанного элемента управления в Обозреватель стиле диалогового окна Открыть или Сохранить как.
CommDlg_OpenSave_SetDefExt Задает расширение имени файла по умолчанию для диалогового окна "Открыть" или "Сохранить как" в стиле Обозреватель.
CommDlgExtendedError Функция CommDlgExtendedError (commdlg.h) возвращает код общей ошибки диалогового окна.
CreateDialogA Создает немодное диалоговое окно на основе ресурса шаблона диалогового окна. Макрос CreateDialog использует функцию CreateDialogParam. (ANSI)
CreateDialogIndirectA Создает немодное диалоговое окно на основе шаблона диалогового окна в памяти. Макрос CreateDialogIndirect использует функцию CreateDialogIndirectParam. (ANSI)
CreateDialogIndirectParamA Создает немодное диалоговое окно на основе шаблона диалогового окна в памяти. (ANSI)
CreateDialogIndirectParamW Создает немодное диалоговое окно на основе шаблона диалогового окна в памяти. (Юникод)
CreateDialogIndirectW Создает немодное диалоговое окно на основе шаблона диалогового окна в памяти. Макрос CreateDialogIndirect использует функцию CreateDialogIndirectParam. (Юникод)
CreateDialogParamA Создает немодное диалоговое окно на основе ресурса шаблона диалогового окна. (ANSI)
CreateDialogParamW Создает немодное диалоговое окно на основе ресурса шаблона диалогового окна. (Юникод)
CreateDialogW Создает немодное диалоговое окно на основе ресурса шаблона диалогового окна. Макрос CreateDialog использует функцию CreateDialogParam. (Юникод)
DefDlgProcA Вызывает процедуру диалогового окна по умолчанию, чтобы обеспечить обработку по умолчанию для всех оконных сообщений, которые не обрабатываются диалоговым окном с закрытым классом окна. (ANSI)
DefDlgProcW Вызывает процедуру диалогового окна по умолчанию, чтобы обеспечить обработку по умолчанию для всех оконных сообщений, которые не обрабатываются диалоговым окном с закрытым классом окна. (Юникод)
DialogBoxA Создает модальное диалоговое окно на основе ресурса шаблона диалогового окна. DialogBox не возвращает управление, пока указанная функция обратного вызова не завершит модальное диалоговое окно путем вызова функции EndDialog. (ANSI)
DialogBoxIndirectA Создает модальное диалоговое окно на основе шаблона диалогового окна в памяти. DialogBoxIndirect не возвращает управление, пока указанная функция обратного вызова не завершит модальное диалоговое окно, вызвав функцию EndDialog. (ANSI)
DialogBoxIndirectParamA Создает модальное диалоговое окно на основе шаблона диалогового окна в памяти. (ANSI)
DialogBoxIndirectParamW Создает модальное диалоговое окно на основе шаблона диалогового окна в памяти. (Юникод)
DialogBoxIndirectW Создает модальное диалоговое окно на основе шаблона диалогового окна в памяти. DialogBoxIndirect не возвращает управление, пока указанная функция обратного вызова не завершит модальное диалоговое окно, вызвав функцию EndDialog. (Юникод)
DialogBoxParamA Создает модальное диалоговое окно на основе ресурса шаблона диалогового окна. (ANSI)
DialogBoxParamW Создает модальное диалоговое окно из ресурса шаблона диалогового окна. (Юникод)
DialogBoxW Создает модальное диалоговое окно из ресурса шаблона диалогового окна. DialogBox не возвращает управление, пока указанная функция обратного вызова не завершит модальное диалоговое окно путем вызова функции EndDialog. (Юникод)
DLGPROC Определяемая приложением функция обратного вызова, используемая с семействами функций CreateDialog и DialogBox.
EndDialog Уничтожает модальное диалоговое окно, в результате чего система завершает обработку этого диалогового окна.
FindTextA Создает системное диалоговое окно поиска без режима, которое позволяет пользователю указать строку для поиска и параметры, используемые при поиске текста в документе. (ANSI)
FindTextW Создает системное диалоговое окно поиска без режима, которое позволяет пользователю указать строку для поиска и параметры, используемые при поиске текста в документе. (Юникод)
GetCurrentDevMode Заполняет структуру DEVMODE сведениями о текущем выбранном принтере для использования с PrintDlgEx.
GetCurrentPortName Извлекает имя текущего порта для использования с PrintDlgEx.
GetCurrentPrinterName Извлекает имя текущего выбранного принтера для использования с PrintDlgEx.
GetDialogBaseUnits Извлекает базовые единицы диалога системы, которые представляют собой среднюю ширину и высоту символов в системном шрифте.
GetDlgCtrlID Извлекает идентификатор указанного элемента управления.
GetDlgItem Извлекает дескриптор элемента управления в указанном диалоговом окне.
GetDlgItemInt Преобразует текст указанного элемента управления в диалоговом окне в целочисленное значение.
GetDlgItemTextA Извлекает заголовок или текст, связанный с элементом управления в диалоговом окне. (ANSI)
GetDlgItemTextW Извлекает заголовок или текст, связанный с элементом управления в диалоговом окне. (Юникод)
GetFileTitleA Извлекает имя указанного файла. (ANSI)
GetFileTitleW Извлекает имя указанного файла. (Юникод)
GetNextDlgGroupItem Извлекает дескриптор первого элемента управления в группе элементов управления, которые предшествуют указанному элементу управления в диалоговом окне или следуют за ней.
GetNextDlgTabItem Извлекает дескриптор первого элемента управления, который имеет стиль WS_TABSTOP, который предшествует указанному элементу управления (или следует за ней).
GetOpenFileNameA Создает диалоговое окно Открыть, позволяющее пользователю указать диск, каталог и имя файла или набора файлов, которые необходимо открыть. (ANSI)
GetOpenFileNameW Создает диалоговое окно Открыть, позволяющее пользователю указать диск, каталог и имя файла или набора файлов, которые необходимо открыть. (Юникод)
GetSaveFileNameA Создает диалоговое окно Сохранение, позволяющее пользователю указать диск, каталог и имя файла для сохранения. (ANSI)
GetSaveFileNameW Создает диалоговое окно Сохранение, позволяющее пользователю указать диск, каталог и имя файла для сохранения. (Юникод)
HandleMessage Вызывается PrintDlgEx, чтобы предоставить приложению возможность обрабатывать сообщения, отправленные в дочернее диалоговое окно в нижней части страницы Общие на странице свойств печати.
InitDone Вызывается методом PrintDlgEx, когда система завершила инициализацию страницы Общие на странице свойств печати.
IsDialogMessageA Определяет, предназначено ли сообщение для указанного диалогового окна, и, если оно имеется, обрабатывает его. (ANSI)
IsDialogMessageW Определяет, предназначено ли сообщение для указанного диалогового окна, и, если оно имеется, обрабатывает его. (Юникод)
LPCCHOOKPROC Получает сообщения или уведомления, предназначенные для диалогового окна по умолчанию диалогового окна Цвет. Это определяемая приложением или библиотекой функция обратного вызова, используемая с функцией ChooseColor.
LPCFHOOKPROC Получает сообщения или уведомления, предназначенные для процедуры диалогового окна по умолчанию диалогового окна Шрифт. Это определяемая приложением или библиотекой процедура обратного вызова, используемая с функцией ChooseFont.
LPFRHOOKPROC Получает сообщения или уведомления, предназначенные для диалогового окна по умолчанию диалогового окна "Найти или заменить".
LPOFNHOOKPROC Получает уведомления, отправленные из диалогового окна.
LPPAGEPAINTHOOK Получает сообщения, позволяющие настроить рисование примера страницы в диалоговом окне Параметры страницы. Процедура перехватчика PagePaintHook — это определяемая приложением или библиотекой функция обратного вызова, используемая с функцией PageSetupDlg.
LPPAGESETUPHOOK Получает сообщения или уведомления, предназначенные для диалогового окна по умолчанию диалогового окна Параметры страницы. Процедура перехватчика PageSetupHook — это определяемая приложением или библиотекой функция обратного вызова, используемая с функцией PageSetupDlg.
LPPRINTHOOKPROC Получает сообщения или уведомления, предназначенные для диалогового окна по умолчанию диалогового окна Печать. Это определяемая приложением или библиотекой функция обратного вызова, используемая с функцией PrintDlg.
LPSETUPHOOKPROC Определяемая приложением или библиотекой функция обратного вызова, используемая с функцией PrintDlg. Процедура перехватчика получает сообщения или уведомления, предназначенные для диалогового окна по умолчанию диалогового окна Настройка печати.
MapDialogRect Преобразует указанные единицы диалогового окна в единицы экрана (пиксели).
Messagebox Функция MessageBox отображает модальное диалоговое окно, содержащее системный значок, набор кнопок и краткое сообщение для конкретного приложения.
MessageBoxA Отображает модальное диалоговое окно, содержащее системный значок, набор кнопок и краткое сообщение для конкретного приложения, например сведения о состоянии или ошибке. Окно сообщения возвращает целочисленное значение, указывающее, какую кнопку нажал пользователь. (MessageBoxA)
MessageBoxExA Создает, отображает и управляет окном сообщения. (ANSI)
MessageBoxExW Создает, отображает и управляет окном сообщения. (Юникод)
MessageBoxIndirectA Создает, отображает и управляет окном сообщения. Окно сообщения содержит текст и заголовок сообщения, определяемые приложением, любой значок и любое сочетание предопределенных кнопок. (ANSI)
MessageBoxIndirectW Создает, отображает и управляет окном сообщения. Окно сообщения содержит текст и заголовок сообщения, определяемые приложением, любой значок и любое сочетание предопределенных кнопок. (Юникод)
MessageBoxW Функция MessageBoxW (Юникод) отображает модальное диалоговое окно, содержащее системный значок, набор кнопок и краткое сообщение для конкретного приложения.
MSGBOXCALLBACK Функция обратного вызова, определяемая в приложении, которая обрабатывает события справки для окна сообщения.
PageSetupDlgA AsCII-версия PageSetupDlg
PageSetupDlgW Расширенная строковая версия PageSetupDlg
PrintDlgA AsCII-версия PrintDlg
PrintDlgExA AsCII-версия PrintDlgEx
PrintDlgExW Расширенная строковая версия PrintDlgEx
PrintDlgW Расширенная строковая версия PrintDlg
QueryInterface Метод IPrintDialogCallback::QueryInterface (commdlg.h) — это метод QueryInterface iUnknown, который запрашивает у COM-объекта указатель.
QueryInterface Метод IPrintDialogServices::QueryInterface (commdlg.h) — это метод QueryInterface iUnknown, который запрашивает у COM-объекта указатель.
Выпуск Метод IPrintDialogCallback::Release (commdlg.h) — это метод Release IUnknown, который уменьшает количество ссылок для интерфейса в COM-объекте.
Выпуск Метод IPrintDialogServices::Release (commdlg.h) — это метод Release IUnknown, который уменьшает количество ссылок для интерфейса в COM-объекте.
ReplaceTextA Создает системное безмодерное диалоговое окно, позволяющее пользователю указать строку для поиска и строку замены, а также параметры для управления операциями поиска и замены. (ANSI)
ReplaceTextW Создает системное безмодерное диалоговое окно, позволяющее пользователю указать строку для поиска и строку замены, а также параметры для управления операциями поиска и замены. (Юникод)
SelectionChange Вызывается PrintDlgEx, когда пользователь выбирает другой принтер из списка установленных принтеров на странице Общие страницы свойств печати.
SendDlgItemMessageA Отправляет сообщение указанному элементу управления в диалоговом окне. (ANSI)
SendDlgItemMessageW Отправляет сообщение указанному элементу управления в диалоговом окне. (Юникод)
SetDlgItemInt Задает текст элемента управления в диалоговом окне строковое представление указанного целочисленного значения.
SetDlgItemTextA Задает заголовок или текст элемента управления в диалоговом окне. (ANSI)
SetDlgItemTextW Задает заголовок или текст элемента управления в диалоговом окне. (Юникод)

Интерфейсы

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

Структуры

CHOOSEFONTA Содержит сведения, которые функция ChooseFont использует для инициализации диалогового окна Шрифт. После того как пользователь закроет диалоговое окно, система возвращает сведения о выборе пользователя в этой структуре. (ANSI)
CHOOSEFONTW Содержит сведения, которые функция ChooseFont использует для инициализации диалогового окна Шрифт. После того как пользователь закроет диалоговое окно, система возвращает сведения о выборе пользователя в этой структуре. (Юникод)
DEVNAMES Содержит строки, определяющие имена драйверов, устройств и выходных портов для принтера.
DLGITEMTEMPLATE Определяет размеры и стиль элемента управления в диалоговом окне. Одна или несколько из этих структур объединяются со структурой DLGTEMPLATE, чтобы сформировать стандартный шаблон для диалогового окна.
DLGTEMPLATE Определяет размеры и стиль диалогового окна.
FINDREPLACEA Содержит сведения, используемые функциями FindText и ReplaceText для инициализации диалоговых окон Найти и Заменить. (ANSI)
FINDREPLACEW Содержит сведения, используемые функциями FindText и ReplaceText для инициализации диалоговых окон Найти и Заменить. (Юникод)
MSGBOXPARAMSA Содержит сведения, используемые для отображения окна сообщения. Эта структура используется в функции MessageBoxIndirect. (ANSI)
MSGBOXPARAMSW Содержит сведения, используемые для отображения окна сообщения. Эта структура используется в функции MessageBoxIndirect. (Юникод)
OFNOTIFYA Содержит сведения о WM_NOTIFY сообщении, отправленном в процедуру перехватчика OFNHookProc для диалогового окна Открыть или Сохранить как. Параметр lParam сообщения WM_NOTIFY является указателем на структуру OFNOTIFY. (ANSI)
OFNOTIFYEXA Содержит сведения о сообщении уведомления CDN_INCLUDEITEM. (ANSI)
OFNOTIFYEXW Содержит сведения о CDN_INCLUDEITEM сообщении уведомления. (Юникод)
OFNOTIFYW Содержит сведения о WM_NOTIFY сообщении, отправляемом в процедуру обработчика OFNHookProc для диалогового окна Открыть или Сохранить как. Параметр lParam сообщения WM_NOTIFY является указателем на структуру OFNOTIFY. (Юникод)
OPENFILENAME_NT4A Структура OPENFILENAME_NT4 идентична openfileNAME с _WIN32_WINNT значением 0x0400. (ANSI)
OPENFILENAME_NT4W Структура OPENFILENAME_NT4 идентична openfileNAME с _WIN32_WINNT значением 0x0400. (Юникод)
OPENFILENAMEA Содержит сведения, используемые функциями GetOpenFileName и GetSaveFileName для инициализации диалогового окна Открыть или Сохранить как. После закрытия пользователем диалогового окна система возвращает сведения о выборе пользователя в этой структуре. (ANSI)
OPENFILENAMEW Содержит сведения, используемые функциями GetOpenFileName и GetSaveFileName для инициализации диалогового окна Открыть или Сохранить как. После закрытия пользователем диалогового окна система возвращает сведения о выборе пользователя в этой структуре. (Юникод)
PAGESETUPDLGA Содержит сведения, которые функция PageSetupDlg использует для инициализации диалогового окна Параметры страницы. После закрытия пользователем диалогового окна система возвращает сведения о пользовательских параметрах страницы в этой структуре. (ANSI)
PAGESETUPDLGW Содержит сведения, которые функция PageSetupDlg использует для инициализации диалогового окна Параметры страницы. После закрытия пользователем диалогового окна система возвращает сведения о пользовательских параметрах страницы в этой структуре. (Юникод)
PRINTDLGA Содержит сведения, которые функция PrintDlg использует для инициализации диалогового окна "Печать". После того как пользователь закроет диалоговое окно, система использует эту структуру для возврата сведений о выбранных пользователем параметрах. (ANSI)
PRINTDLGEXA Содержит сведения, которые функция PrintDlgEx использует для инициализации страницы свойств Print. После закрытия пользователем страницы свойств система использует эту структуру для возврата сведений о выбранных пользователем параметрах. (ANSI)
PRINTDLGEXW Содержит сведения, которые функция PrintDlgEx использует для инициализации страницы свойств Print. После закрытия пользователем страницы свойств система использует эту структуру для возврата сведений о выбранных пользователем параметрах. (Юникод)
PRINTDLGW Содержит сведения, которые функция PrintDlg использует для инициализации диалогового окна "Печать". После того как пользователь закроет диалоговое окно, система использует эту структуру для возврата сведений о выбранных пользователем параметрах. (Юникод)
PRINTPAGERANGE Представляет диапазон страниц в задании печати. Задание печати может иметь несколько диапазонов страниц. Эти сведения предоставляются в структуре PRINTDLGEX при вызове функции PrintDlgEx.