На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

DialogBox



The DialogBox macro creates a modal dialog box from a dialog box template resource. DialogBox does not return control until the specified callback function terminates the modal dialog box by calling the EndDialog function. The DialogBox macro uses the DialogBoxParam function.

int DialogBox(

HINSTANCE hInstance, // handle to application instance
LPCTSTR lpTemplate, // identifies dialog box template
HWND hWndParent, // handle to owner window
DLGPROC lpDialogFunc // pointer to dialog box procedure
);


Parameters

hInstance

Identifies an instance of the module whose executable file contains the dialog box template.

lpTemplate

Identifies the dialog box template. This parameter is either the pointer to a null-terminated character string that specifies the name of the dialog box template or an integer value that specifies the resource identifier of the dialog box template. If the parameter specifies a resource identifier, its high-order word must be zero and its low-order word must contain the identifier. You can use the MAKEINTRESOURCE macro to create this value.

hWndParent

Identifies the window that owns the dialog box.

lpDialogFunc

Points to the dialog box procedure. For more information about the dialog box procedure, see the DialogProc callback function.



Return Values

If the function succeeds, the return value is the nResult parameter in the call to the EndDialog function used to terminate the dialog box.
If the function fails, the return value is -1.

Remarks

The DialogBox macro uses the CreateWindowEx function to create the dialog box. DialogBox then sends a WM_INITDIALOG message (and a WM_SETFONT message if the template specifies the DS_SETFONT style) to the dialog box procedure. The function displays the dialog box (regardless of whether the template specifies the WS_VISIBLE style), disables the owner window, and starts its own message loop to retrieve and dispatch messages for the dialog box.
When the dialog box procedure calls the EndDialog function, DialogBox destroys the dialog box, ends the message loop, enables the owner window (if previously enabled), and returns the nResult parameter specified by the dialog box procedure when it called EndDialog.

Windows 95: The system can support a maximum of 16,364 window handles.

See Also

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


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

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.

Окно 95: система может поддержать максимум 16,364 ручек окна.

Смотри Также

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


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz