Диалоговые окна
Обзор технологии диалоговых окон.
Для разработки диалоговых окон вам потребуются следующие заголовки:
Рекомендации по программированию для этой технологии см. в следующих разделах:
Функции
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. |