Поделиться через


Структура CPLINFO (cpl.h)

Содержит сведения о ресурсе и определяемое приложением значение для диалогового окна, поддерживаемого приложением панель управления. Функция CPlApplet приложения панель управления возвращает эти сведения в панель управления в ответ на сообщение CPL_INQUIRE.

Синтаксис

typedef struct tagCPLINFO {
  int      idIcon;
  int      idName;
  int      idInfo;
  LONG_PTR lData;
} CPLINFO, *LPCPLINFO;

Члены

idIcon

Тип: int

Идентификатор ресурса значка, представляющего диалоговое окно.

idName

Тип: int

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

idInfo

Тип: int

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

lData

Тип: LONG_PTR

Указатель на данные, определенные приложением. Когда панель управления отправляет CPL_DBLCLK и CPL_STOP сообщения, оно передает это значение обратно в приложение.

Комментарии

Если значок или отображаемые строки диалогового окна могут изменяться в зависимости от состояния компьютера, можно указать значение CPL_DYNAMIC_RES для элементов idIcon, idName или idInfo , а не указывать допустимый идентификатор ресурса. Это приводит к тому, что панель управления будет отправлять CPL_NEWINQUIRE сообщение каждый раз, когда ему требуется значок и отображаемые строки. Однако использование этого метода значительно медленнее, так как панель управления нужно будет загружать приложение каждый раз, когда оно отправляет CPL_NEWINQUIRE сообщение.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть cpl.h