На главную

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 | Скачать Вниз

DialogBoxParam



The DialogBoxParam function creates a modal dialog box from a dialog box template resource. Before displaying the dialog box, the function passes an application-defined value to the dialog box procedure as the lParam parameter of the WM_INITDIALOG message. An application can use this value to initialize dialog box controls.

int DialogBoxParam(

HINSTANCE hInstance, // handle to application instance
LPCTSTR lpTemplateName, // identifies dialog box template
HWND hWndParent, // handle to owner window
DLGPROC lpDialogFunc, // pointer to dialog box procedure
LPARAM dwInitParam // initialization value
);


Parameters

hInstance

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

lpTemplateName

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.

dwInitParam

Specifies the value to pass to the dialog box in the lParam parameter of the WM_INITDIALOG message.



Return Values

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

Remarks

The DialogBoxParam function uses the CreateWindowEx function to create the dialog box. DialogBoxParam 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, DialogBoxParam 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

CreateWindowEx, DialogBox, DialogBoxIndirect, DialogBoxIndirectParam, DialogProc, EndDialog, MAKEINTRESOURCE, WM_INITDIALOG, WM_SETFONT


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

DialogBoxParam



Функция DialogBoxParam создает модальный диалоговый ящик из ресурса шаблона диалогового ящика. Прежде, чем отобразить диалоговый ящик, функция передает определенную прикладную величину в диалоговую процедуру ящика как параметр lParam сообщения WM_INITDIALOG. Приложение может использовать эту величину, чтобы инициализировать диалоговые элементы управления ящика.

int DialogBoxParam(

hInstance HINSTANCE, // ОПЕРИРУЕТСЯ в прикладной пример LPCTSTR lpTemplateName, // идентифицирует диалоговый шаблон ящика HWND hWndParent, // ручки в окно владельца DLGPROC lpDialogFunc, // указателя, чтобы общаться величина инициализации ящика процедуры LPARAM dwInitParam //
);


Параметры

hInstance

Идентифицирует пример модуля, чей выполняемый файл содержит диалоговый шаблон ящика.

lpTemplateName

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

hWndParent

Идентифицирует окно, которое обладает диалоговым ящиком.

lpDialogFunc

Точки на диалоговую процедуру ящика. Более подробно о диалоговой процедуре ящика, смотри функцию возврата DialogProc.

dwInitParam

Определяет величину, чтобы проходить в диалоговый ящик в параметре lParam сообщения WM_INITDIALOG.



Обратные Величины

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

Замечания

Функция DialogBoxParam использует функцию CreateWindowEx, чтобы создавать диалоговый ящик. DialogBoxParam ЗАТЕМ посылает сообщение WM_INITDIALOG (и сообщение WM_SETFONT если шаблон определяет стиль DS_SETFONT) в диалоговую процедуру ящика. Функция отображает диалоговый ящик (независимо от того, что шаблон определяет стиль WS_VISIBLE), выводит из строя окно владельца и начинает собственный цикл сообщения, чтобы извлекать и посылать сообщения для диалогового ящика.

Когда диалоговая процедура ящика вызывает функцию EndDialog, DialogBoxParam уничтожает диалоговый ящик, заканчивает цикл сообщения, приспосабливается окно владельца (если прежде приспособлено), и возврат параметр nResult определялся диалоговой процедурой ящика когда он вызван EndDialog.
Окно 95: система может поддержать максимум 16,364 ручек окна.

Смотри Также

CreateWindowEx, DialogBox, DialogBoxIndirect, DialogBoxIndirectParam, DialogProc, EndDialog, MAKEINTRESOURCE, WM_INITDIALOG, WM_SETFONT


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