Bagikan melalui

Struktur CPLINFO (cpl.h)

  • Artikel

Berisi informasi sumber daya dan nilai yang ditentukan aplikasi untuk kotak dialog yang didukung oleh aplikasi Panel Kontrol. Fungsi CPlApplet dari aplikasi Panel Kontrol mengembalikan informasi ini ke Panel Kontrol sebagai respons terhadap pesan CPL_INQUIRE .

Sintaks

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

Anggota

idIcon

Jenis: int

Pengidentifikasi sumber daya ikon yang mewakili kotak dialog.

idName

Jenis: int

Pengidentifikasi sumber daya string yang berisi nama pendek untuk kotak dialog. Nama ini dimaksudkan untuk ditampilkan di bawah ikon.

idInfo

Jenis: int

Pengidentifikasi sumber daya string yang berisi deskripsi untuk kotak dialog yang dimaksudkan untuk ditampilkan saat ikon aplikasi dipilih.

lData

Jenis: LONG_PTR

Penunjuk ke data yang ditentukan oleh aplikasi. Ketika Panel Kontrol mengirim pesan CPL_DBLCLK dan CPL_STOP , panel kontrol meneruskan nilai ini kembali ke aplikasi Anda.

Keterangan

Jika string ikon atau tampilan kotak dialog dapat berubah berdasarkan status komputer, Anda dapat menentukan nilai CPL_DYNAMIC_RES untuk anggota idIcon, idName, atau idInfo daripada menentukan pengidentifikasi sumber daya yang valid. Hal ini menyebabkan Panel Kontrol mengirim pesan CPL_NEWINQUIRE setiap kali diperlukan ikon dan string tampilan. Namun, menggunakan teknik ini secara signifikan lebih lambat, karena Panel Kontrol perlu memuat aplikasi Anda setiap kali mengirim pesan CPL_NEWINQUIRE .

Persyaratan

   
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Header cpl.h