Structure CPLINFO (cpl.h)

Contient des informations sur les ressources et une valeur définie par l’application pour une boîte de dialogue prise en charge par une application Panneau de configuration. La fonction CPlApplet de l’application Panneau de configuration retourne ces informations au Panneau de configuration en réponse à un message CPL_INQUIRE.

Syntaxe

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

Membres

idIcon

Type : int

Identificateur de ressource de l’icône qui représente la boîte de dialogue.

idName

Type : int

Identificateur de ressource de la chaîne contenant le nom court de la boîte de dialogue. Ce nom est destiné à être affiché sous l’icône.

idInfo

Type : int

Identificateur de ressource de la chaîne contenant la description de la boîte de dialogue destinée à être affichée lorsque l’icône d’application est sélectionnée.

lData

Type : LONG_PTR

Pointeur vers les données définies par l’application. Lorsque le Panneau de configuration envoie les messages CPL_DBLCLK et CPL_STOP, il transmet cette valeur à votre application.

Remarques

Si l’icône ou les chaînes d’affichage de la boîte de dialogue peuvent changer en fonction de l’état de l’ordinateur, vous pouvez spécifier la valeur CPL_DYNAMIC_RES pour les membres idIcon, idName ou idInfo au lieu de spécifier un identificateur de ressource valide. Ainsi, le Panneau de configuration envoie le message CPL_NEWINQUIRE chaque fois qu’il a besoin de l’icône et des chaînes d’affichage. L’utilisation de cette technique est toutefois beaucoup plus lente, car le Panneau de configuration devra charger votre application chaque fois qu’il envoie le message CPL_NEWINQUIRE.

Configuration requise

Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	cpl.h