Bagikan melalui

Struktur NEWCPLINFOA (cpl.h)

  • Artikel

Berisi informasi sumber daya dan nilai yang ditentukan aplikasi untuk kotak dialog yang didukung oleh aplikasi Panel Kontrol.

Sintaksis

typedef struct tagNEWCPLINFOA {
  DWORD    dwSize;
  DWORD    dwFlags;
  DWORD    dwHelpContext;
  LONG_PTR lData;
  HICON    hIcon;
  CHAR     szName[32];
  CHAR     szInfo[64];
  CHAR     szHelpFile[128];
} NEWCPLINFOA, *LPNEWCPLINFOA;

Anggota

dwSize

Jenis: DWORD

Panjang struktur, dalam byte.

dwFlags

Jenis: DWORD

Anggota ini diabaikan.

dwHelpContext

Jenis: DWORD

Anggota ini diabaikan.

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.

hIcon

Jenis: HICON

Pengidentifikasi ikon yang mewakili kotak dialog. Ikon ini dimaksudkan untuk ditampilkan oleh aplikasi yang mengontrol aplikasi Panel Kontrol.

szName[32]

Jenis: TCHAR[32]

String null-terminated yang berisi nama kotak dialog. Nama dimaksudkan untuk ditampilkan di bawah ikon.

szInfo[64]

Jenis: TCHAR[64]

String null-terminated yang berisi deskripsi kotak dialog. Deskripsi dimaksudkan untuk ditampilkan saat ikon untuk kotak dialog dipilih.

szHelpFile[128]

Jenis: TCHAR[128]

Anggota ini diabaikan.

Komentar

Fungsi CPlApplet dari aplikasi Panel Kontrol mengembalikan informasi ini ke Panel Kontrol sebagai respons terhadap pesan CPL_NEWINQUIRE.

Nota

Header cpl.h mendefinisikan NEWCPLINFO sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat Nilai
klien minimum yang didukung Windows XP [hanya aplikasi desktop]
server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Header cpl.h

Lihat juga

CPLINFO