Отправляет email-рассылки с помощью сервиса Sendsay

WinAPI на русском

  Все выпуски  

WinAPI на русском


Служба Рассылок Subscribe.Ru

Новости сайта http://www.gabber.2ajaxs.ru

Здравствуйте, уважаемые подписчики. Сегодня вашему вниманию представлен перевод
функции DialogBox

DialogBox

Макрос DialogBox создает модальное диалоговое окно из ресурса – шаблона диалогового
окна. DialogBox не возвращает управление до тех пор, пока заданная функция обратного
вызова не завершит модальное диалоговое окно, вызвав функцию EndDialog. Макрос
DialogBox использует функцию DialogBoxParam.

int DialogBox(

    HINSTANCE hInstance,        // дескриптор экземпляра приложения
    LPCTSTR lpTemplate, // идентифицирует имя шаблона диалогового окна
    HWND hWndParent,    // дескриптор окна-владельца
    DLGPROC lpDialogFunc        // указатель на оконную процедуру
// диалогового окна
   );

Параметры

hInstance – идентифицирует экземпляр модуля, чей исполняемый файл содержит шаблон
диалогового окна.
lpTemplate – идентифицирует шаблон диалогового окна. Этот параметр является либо
указателем на завершающуюся нулем строку, определяющей имя шаблона диалогового
окна, либо целым значением, которое определяет идентификатор ресурса шаблона
диалогового окна. Если этот параметр является идентификатором ресурса, его старшее
слово должно быть равно нулю, а младшее слово должно содержать идентификатор.
Вы можете использовать макрос MAKEINTRESOURCE для создания этого значения.
hWndParent – идентифицирует окно, владеющее диалоговым окном.
lpDialogFunc – указатель на оконную процедуру диалогового окна. Для дополнительной
информации об этой процедуре смотрите DialogProc.

Возвращаемые значения

В случае успеха возвращается параметр nResult функции EndDialog, используемой
для завершения диалогового окна.
В случае неудачи возвращается –1.

Комментарии

Функция DialogBox использует функцию CreateWindowEx для создания диалогового
окна. Затем DialogBox отправляет сообщение WM_INITDIALOG (а также сообщение WM_SETFONT,
если шаблон задает стиль DS_SETFONT) оконной процедуре диалогового окна. Функция
отображает диалоговое окно (вне зависимости от того, установлен ли в ресурсе-шаблоне
стиль WS_VISIBLE), блокирует родительское окно и входит в собственный цикл обработки
сообщений.
Когда оконная процедура диалогового окна вызывает функцию EndDialog, DialogBox
разрушает диалоговое окно, завершает цикл обработки сообщений, разблокирует родительское
окно и возвращает параметр nResult, задаваемый процедурой диалогового окна, когда
она вызывает функцию EndDialog.
Windows 95: Система поддерживает максимум 16384 дескрипторов окон.


См. также

CreateDialog, CreateWindowEx, DialogBoxIndirect, DialogBoxIndirectParam, DialogBoxParam,
DialogProc, EndDialog, MAKEINTRESOURCE, WM_INITDIALOG, WM_SETFONT.

С уважением,
ведущий рассылки
Тарас Сорока.
mailto:gabber@guns.ru

http://subscribe.ru/
E-mail: ask@subscribe.ru
Отписаться
Убрать рекламу

В избранное