На главную

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

CPL_NEWINQUIRE



The CPL_NEWINQUIRE message is sent to the CPlApplet function of a Control Panel application to request information about a dialog box that the application supports.

For better performance, most applications should ignore CPL_NEWINQUIRE and process the CPL_INQUIRE message instead. The CPL_NEWINQUIRE message is useful only for applications that need to change their icon or display strings based on the state of the computer.

CPL_NEWINQUIRE
uAppNum = (UINT) lParam1; // application number
lpncpli = (LPNEWCPLINFO) lParam2; // structure for appl. info.


Parameters

uAppNum

Value of lParam1. Specifies the dialog box number. This number must be in the range zero through one less than the value returned in response to the CPL_GETCOUNT message (CPL_GETCOUNT - 1).

lpncpli

Value of lParam2. Specifies the address of a NEWCPLINFO structure. The Control Panel application should fill this structure with information about the dialog box.



Return Values

If the CPlApplet function processes this message successfully, it should return zero.

Remarks

The Control Panel sends the CPL_NEWINQUIRE message once for each dialog box supported by your application. The Control Panel also sends a CPL_INQUIRE message for each dialog box. These messages are sent immediately after the CPL_GETCOUNT message. However, the system does not guarantee the order in which the CPL_INQUIRE and CPL_NEWINQUIRE messages are sent.
You can perform initialization for the dialog box when you receive CPL_INQUIRE. If you must allocate memory, do so in response to the CPL_INIT message.

The CPL_NEWINQUIRE message was introduced in Windows version 3.1 as a replacement for CPL_INQUIRE. However, CPL_INQUIRE is the preferred message for Windows 95 and Windows NT version 4.0. This is because CPL_NEWINQUIRE returns information in a form that the system cannot cache. Consequently, applications that process CPL_NEWINQUIRE must be loaded each time the Control Panel needs the information, resulting in a significant reduction in performance.

The only applications that should use CPL_NEWINQUIRE are those that need to change their icon or display strings based on the state of the computer. In this case, your CPL_INQUIRE handler should specify the CPL_DYNAMIC_RES value for the idIcon, idName, or idInfo members of the CPLINFO structure, rather than specifying a valid resource identifier. This causes the Control Panel to send the CPL_NEWINQUIRE message each time it needs the icon and display strings, allowing you to specify information based on the current state of the computer. Of course, this is significantly slower than using cached information.

See Also

CPL_GETCOUNT, CPL_INIT, CPL_INQUIRE, CPlApplet, CPLINFO, NEWCPLINFO


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

CPL_NEWINQUIRE



Сообщение CPL_NEWINQUIRE послано в функцию CPlApplet Панели Управления приложения, чтобы запрашивать информацию о диалоговом блоке, что приложение поддерживает.

Для большего эффекта, большинство приложений должны проигнорировать CPL_NEWINQUIRE и обрабатывать сообщение CPL_INQUIRE взамен. Сообщение CPL_NEWINQUIRE полезное только для приложений, что нужно изменять их иконку или отображать строки основанные в состоянии компьютера.

CPL_NEWINQUIRE
uAppNum = (UINT) lParam1; // прикладной номер lpncpli = (LPNEWCPLINFO) lParam2; // структура для применения инфо.


Параметры

uAppNum

Величина lParam1. Определяет диалоговый номер блока. Это число должно быть в нуле дипазона через одну менее чем величину возвращанную в ответ на сообщение CPL_GETCOUNT (CPL_GETCOUNT - 1).

lpncpli

Величина lParam2. Определяет адрес структуры NEWCPLINFO. Панель Управления приложения должна заполнять эту структуру информацией о диалоговом блоке.



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

Если функциональные процессы CPlApplet этого сообщения успешно, это должно возвращать нуль.

Замечания

Панель Управления посылает сообщение CPL_NEWINQUIRE как только для каждого диалогового блока поддерживанного вашим приложением. Панель Управления также посылает сообщение CPL_INQUIRE для каждого диалогового блока. Эти сообщения посылаются немедленно после сообщения CPL_GETCOUNT. Тем не менее, система не гарантирует порядок в котором CPL_INQUIRE и сообщения CPL_NEWINQUIRE посланы.
Вы можете выполнить инициализацию для диалогового блока когда Вы получаете CPL_INQUIRE. Если Вы должны распределить память, сделайте так в ответ на сообщение CPL_INIT.

Сообщение CPL_NEWINQUIRE было введено в версию Windows 3.1 как замена для CPL_INQUIRE. Тем не менее, CPL_INQUIRE - предпочтительное сообщение для Windows 95 и версии Windows NT 4.0. Дело в том, что информация возврата CPL_NEWINQUIRE в форме, что система не может кешировать. Следовательно, приложения, которые обрабатывают CPL_NEWINQUIRE должен быть загружен всякий раз, когда Панели Управления нужно информация, заканчивающаяся значимым уменьшением в исполнении.

Единственные приложения, которые должны использовать CPL_NEWINQUIRE - те которым нужно изменять их иконку или отображать строки основанные в состоянии компьютера. В этом случае, ваш вручитель CPL_INQUIRE должен определить величину CPL_DYNAMIC_RES для idIcon, idName, или участников idInfo структуры CPLINFO, а не определяя правильный идентификатор ресурса. Это заставляет Панель Управления, чтобы посылать сообщение CPL_NEWINQUIRE всякий раз, когда ему нужно иконная и дисплейная строки, допускающие Вас, чтобы определять информацию основанную в текущем состоянии компьютера. Конечно, это значительно медленнее чем использование кешировавшее информацию.

Смотри Также

CPL_GETCOUNT, CPL_INIT, CPL_INQUIRE, CPlApplet, CPLINFO, NEWCPLINFO


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