|
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! |
|
|
CPL_INQUIRE
The CPL_INQUIRE message is sent to the CPlApplet function of a Control Panel application to request information about a dialog box that the application supports.
CPL_INQUIRE uAppNum = (UINT) lParam1; // application number lpcpli = (LPCPLINFO) lParam2; // structure for application 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).
lpcpli
Value of lParam2. Points to a CPLINFO structure. The application must fill this structure with resource identifiers for the icon, short name, description, and any user-defined value associated with the dialog box.
Return Values
If the CPlApplet function processes this message successfully, it should return zero.
Remarks
The Control Panel sends the CPL_INQUIRE message once for each dialog box supported by your application. The Control Panel also sends a CPL_NEWINQUIRE 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.
On Windows 95 and Windows NT version 4.0, the system caches the information returned in the CPLINFO structure used by CPL_INQUIRE. This provides significantly better performance because the system only needs to load your application the first time the Control Panel starts up. On the other hand, the CPL_NEWINQUIRE message returns information in a form that the system cannot cache. For this reason, most CPlApplet functions should process CPL_INQUIRE and ignore CPL_NEWINQUIRE.
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_NEWINQUIRE, CPlApplet, CPLINFO
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
CPL_INQUIRE
Сообщение CPL_INQUIRE послано в функцию CPlApplet Панели Управления приложения, чтобы запрашивать информацию о диалоговом блоке, что приложение поддерживает.
CPL_INQUIRE uAppNum = (UINT) lParam1; // прикладной номер lpcpli = (LPCPLINFO) lParam2; // структура для приложения инфо.
Параметры
uAppNum
Величина lParam1. Определяет диалоговый номер блока. Это число должно быть в нуле дипазона через одну менее чем величину возвращанную в ответ на сообщение CPL_GETCOUNT (CPL_GETCOUNT - 1).
lpcpli
Величина lParam2. Точки на структуру CPLINFO. Приложение должно заполнить эту структуру идентификаторами ресурса для иконного, короткого имени, описания, и любая определенная величина пользователя связывалась диалоговым блоком.
Обратные Величины
Если функциональные процессы CPlApplet этого сообщения успешно, это должно возвращать нуль.
Замечания
Панель Управления посылает сообщение CPL_INQUIRE как только для каждого диалогового блока поддерживанного вашим приложением. Панель Управления также посылает сообщение CPL_NEWINQUIRE для каждого диалогового блока. Эти сообщения посылаются немедленно после сообщения CPL_GETCOUNT. Тем не менее, система не гарантирует порядок в котором CPL_INQUIRE и сообщения CPL_NEWINQUIRE посланы. Вы можете выполнить инициализацию для диалогового блока когда Вы получаете CPL_INQUIRE. Если Вы должны распределить память, сделайте так в ответ на сообщение CPL_INIT.
В Windows 95 и версии Windows NT 4.0, система кеширует информацию возвращанную в структуру CPLINFO использованную CPL_INQUIRE. Это обеспечивает значительно больший эффект поскольку система только нужно загружать ваше приложение сначала Панель Управления Запускает. С другой стороны,, сообщение CPL_NEWINQUIRE возвращает информацию в форму, которая система не может кешировать. По этой причине, наиболее CPlApplet функционирует должно обрабатывать CPL_INQUIRE и игнорировать CPL_NEWINQUIRE.
Единственные приложения, которые должны использовать CPL_NEWINQUIRE - те которым нужно изменять их иконку или отображать строки основанные в состоянии компьютера. В этом случае, ваш вручитель CPL_INQUIRE должен определить величину CPL_DYNAMIC_RES для idIcon, idName, или участников idInfo структуры CPLINFO, а не определяя правильный идентификатор ресурса. Это заставляет Панель Управления, чтобы посылать сообщение CPL_NEWINQUIRE всякий раз, когда ему нужно иконная и дисплейная строки, допускающие Вас, чтобы определять информацию основанную в текущем состоянии компьютера. Конечно, это значительно медленнее чем использование кешировавшее информацию.
Смотри Также
CPL_GETCOUNT, CPL_INIT, CPL_NEWINQUIRE, CPlApplet, CPLINFO
|
|
|
|
| |