На главную

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

DialogBoxIndirectParam



The DialogBoxIndirectParam function creates a modal dialog box from a dialog box template in memory. 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 DialogBoxIndirectParam(

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


Parameters

hInstance

Identifies the instance of the module that creates the dialog box.

hDialogTemplate

Pointer to a global memory object containing a template that DialogBoxIndirectParam uses to create the dialog box. A dialog box template consists of a header that describes the dialog box, followed by one or more additional blocks of data that describe each of the controls in the dialog box. The template can use either the standard format or the extended format.
In a standard template for a dialog box, the header is a DLGTEMPLATE structure followed by additional variable-length arrays. The data for each control consists of a DLGITEMTEMPLATE structure followed by additional variable-length arrays.

In an extended template for a dialog box, the header uses the DLGTEMPLATEEX format and the control definitions use the DLGITEMTEMPLATEEX format.

hWndParent

Identifies the window that owns the dialog box.

lpDialogFunc

Pointer to the dialog box procedure. For more information about the dialog box procedure, see DialogProc.

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 nResult parameter specified in the call to the EndDialog function that was used to terminate the dialog box.
If the function fails, the return value is -1.

Remarks

The DialogBoxIndirectParam function uses the CreateWindowEx function to create the dialog box. DialogBoxIndirectParam then sends a WM_INITDIALOG message to the dialog box procedure. If the template specifies the DS_SETFONT style, the function also sends a WM_SETFONT message 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.
The DialogBoxIndirectParam function uses the CreateWindowEx function to create the dialog box. DialogBoxIndirectParam then sends a WM_INITDIALOG message to the dialog box procedure. If the template specifies the DS_SETFONT style, the function also sends a WM_SETFONT message 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.
Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

DialogBoxIndirectParam



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

int DialogBoxIndirectParam(

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


Параметры

hInstance

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

hDialogTemplate

Указатель на глобальный объект памяти, содержащий шаблон, что DialogBoxIndirectParam используется, чтобы создавать диалоговый ящик. Диалоговый шаблон блока состоит из заголовка, который описывает диалогового блока, сопровождается одним или более дополнительными блоками данных, которые описывают каждые элементы управления в диалоговом блоке. Шаблон может использовать или стандартный формат или расширенный формат.
В стандартном шаблоне для диалогового блока, заголовок является структурой DLGTEMPLATE сопровожденной дополнительной переменной-длиной подготавливается. Данные для каждого управления состоит из структуры DLGITEMTEMPLATE сопровожденной дополнительной переменной-длиной подготавливается.

В расширенном шаблоне для диалогового блока, заголовок использует формат DLGTEMPLATEEX и управляющее использование определений формат DLGITEMTEMPLATEEX.

hWndParent

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

lpDialogFunc

Указатель диалоговому блоку процедуры. Более подробно о диалоговом блоке процедуры, смотри DialogProc.

dwInitParam

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



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

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

Замечания

Функция DialogBoxIndirectParam использует функцию CreateWindowEx, чтобы создавать диалогового блока. DialogBoxIndirectParam ЗАТЕМ посылает сообщение WM_INITDIALOG диалоговому блоку процедуры. Если шаблон определяет стиль DS_SETFONT, функция также посылает сообщение WM_SETFONT диалоговому блоку процедуры. Функция отображает диалогового блока (независимо от того, что шаблон определяет стиль WS_VISIBLE), выводит из строя окно владельца и начинает собственный цикл сообщения, чтобы извлекать и посылать сообщения для диалогового блока.
Функция DialogBoxIndirectParam использует функцию CreateWindowEx, чтобы создавать диалогового блока. DialogBoxIndirectParam ЗАТЕМ посылает сообщение WM_INITDIALOG диалоговому блоку процедуры. Если шаблон определяет стиль DS_SETFONT, функция также посылает сообщение WM_SETFONT диалоговому блоку процедуры. Функция отображает диалогового блока (независимо от того, что шаблон определяет стиль WS_VISIBLE), выводит из строя окно владельца и начинает собственный цикл сообщения, чтобы извлекать и посылать сообщения для диалогового блока.
Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz