Compartir a través de

Estructura CPLINFO (cpl.h)

  • Artículo

Contiene información de recursos y un valor definido por la aplicación para un cuadro de diálogo admitido por una aplicación Panel de control. La función CPlApplet de la aplicación Panel de control devuelve esta información al Panel de control en respuesta a un mensaje de CPL_INQUIRE.

Sintaxis

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

Miembros

idIcon

Tipo: int

Identificador de recurso del icono que representa el cuadro de diálogo.

idName

Tipo: int

Identificador de recurso de la cadena que contiene el nombre corto del cuadro de diálogo. Este nombre está pensado para mostrarse debajo del icono.

idInfo

Tipo: int

Identificador de recurso de la cadena que contiene la descripción del cuadro de diálogo que está pensado para mostrarse cuando se selecciona el icono de la aplicación.

lData

Tipo: LONG_PTR

Puntero a los datos definidos por la aplicación. Cuando el Panel de control envía el CPL_DBLCLK y CPL_STOP mensajes, vuelve a pasar este valor a la aplicación.

Comentarios

Si el icono o las cadenas de presentación del cuadro de diálogo pueden cambiar en función del estado del equipo, puede especificar el valor de CPL_DYNAMIC_RES para los miembros idIcon, idName o idInfo , en lugar de especificar un identificador de recurso válido. Esto hace que el Panel de control envíe el mensaje CPL_NEWINQUIRE cada vez que necesite el icono y las cadenas de presentación. Sin embargo, el uso de esta técnica es significativamente más lento, ya que el Panel de control tendrá que cargar la aplicación cada vez que envía el mensaje CPL_NEWINQUIRE.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado cpl.h