Struttura CPLINFO (cpl.h)

Contiene informazioni sulle risorse e un valore definito dall'applicazione per una finestra di dialogo supportata da un'applicazione لوحة التحكم. La funzione CPlApplet dell'applicazione لوحة التحكم restituisce queste informazioni al لوحة التحكم in risposta a un messaggio di CPL_INQUIRE.

Sintassi

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

Members

idIcon

Tipo: int

Identificatore della risorsa dell'icona che rappresenta la finestra di dialogo.

idName

Tipo: int

Identificatore della risorsa della stringa contenente il nome breve per la finestra di dialogo. Questo nome deve essere visualizzato sotto l'icona.

idInfo

Tipo: int

Identificatore della risorsa della stringa contenente la descrizione per la finestra di dialogo che deve essere visualizzata quando viene selezionata l'icona dell'applicazione.

lData

Tipo: LONG_PTR

Puntatore ai dati definiti dall'applicazione. Quando il لوحة التحكم invia i messaggi CPL_DBLCLK e CPL_STOP, passa di nuovo questo valore all'applicazione.

Commenti

Se l'icona o le stringhe di visualizzazione della finestra di dialogo possono cambiare in base allo stato del computer, è possibile specificare il valore CPL_DYNAMIC_RES per i membri idIcon, idName o idInfo anziché specificare un identificatore di risorsa valido. In questo modo il لوحة التحكم invia il messaggio CPL_NEWINQUIRE ogni volta che richiede l'icona e le stringhe di visualizzazione. L'uso di questa tecnica è notevolmente più lento, tuttavia, perché il لوحة التحكم dovrà caricare l'applicazione ogni volta che invia il messaggio di CPL_NEWINQUIRE.

Requisiti

Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	cpl.h