Struktur CREATESTRUCTA (winuser.h)

Artikel
08/28/2023

Menentukan parameter inisialisasi yang diteruskan ke prosedur jendela aplikasi. Anggota ini identik dengan parameter fungsi CreateWindowEx .

Sintaks

typedef struct tagCREATESTRUCTA {
  LPVOID    lpCreateParams;
  HINSTANCE hInstance;
  HMENU     hMenu;
  HWND      hwndParent;
  int       cy;
  int       cx;
  int       y;
  int       x;
  LONG      style;
  LPCSTR    lpszName;
  LPCSTR    lpszClass;
  DWORD     dwExStyle;
} CREATESTRUCTA, *LPCREATESTRUCTA;

Anggota

lpCreateParams

Jenis: LPVOID

Berisi data tambahan yang dapat digunakan untuk membuat jendela. Jika jendela sedang dibuat sebagai akibat dari panggilan ke fungsi CreateWindow atau CreateWindowEx , anggota ini berisi nilai parameter lpParam yang ditentukan dalam panggilan fungsi.

Jika jendela yang dibuat adalah jendela klien MDI, anggota ini berisi pointer ke struktur CLIENTCREATESTRUCT . Jika jendela yang dibuat adalah jendela anak MDI, anggota ini berisi penunjuk ke struktur MDICREATESTRUCT .

Jika jendela sedang dibuat dari templat dialog, anggota ini adalah alamat nilai SHORT yang menentukan ukuran, dalam byte, dari data pembuatan jendela. Nilainya segera diikuti oleh data pembuatan. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

hInstance

Jenis: HINSTANCE

Handel ke modul yang memiliki jendela baru.

hMenu

Jenis: HMENU

Handel ke menu yang akan digunakan oleh jendela baru.

hwndParent

Jenis: HWND

Handel ke jendela induk, jika jendela adalah jendela anak. Jika jendela dimiliki, anggota ini mengidentifikasi jendela pemilik. Jika jendela bukan anak atau jendela milik, anggota ini adalah NULL.

cy

Jenis: int

Tinggi jendela baru, dalam piksel.

cx

Jenis: int

Lebar jendela baru, dalam piksel.

y

Jenis: int

Koordinat y dari sudut kiri atas jendela baru. Jika jendela baru adalah jendela anak, koordinat relatif terhadap jendela induk. Jika tidak, koordinat relatif terhadap asal layar.

x

Jenis: int

Koordinat x sudut kiri atas jendela baru. Jika jendela baru adalah jendela anak, koordinat relatif terhadap jendela induk. Jika tidak, koordinat relatif terhadap asal layar.

style

Jenis: LONG

Gaya untuk jendela baru. Untuk daftar nilai yang mungkin, lihat Gaya Jendela.

lpszName

Jenis: LPCTSTR

Nama jendela baru.

lpszClass

Jenis: LPCTSTR

Penunjuk ke string yang dihentikan null atau atom yang menentukan nama kelas jendela baru.

dwExStyle

Jenis: DWORD

Gaya jendela yang diperluas untuk jendela baru. Untuk daftar nilai yang mungkin, lihat Gaya Jendela yang Diperluas.

Keterangan

Karena anggota lpszClass dapat berisi pointer ke atom lokal (dan dengan demikian tidak dapat diakses), jangan mendapatkan nama kelas dengan menggunakan anggota ini. Gunakan fungsi GetClassName sebagai gantinya.

Anda harus mengakses data yang diwakili oleh anggota lpCreateParams menggunakan penunjuk yang telah dinyatakan menggunakan jenis UNALIGNED , karena pointer mungkin tidak selaras dengan DWORD . Ini ditunjukkan dalam contoh berikut:

typedef struct tagMyData 
{
    // Define creation data here. 
} MYDATA; 
 
typedef struct tagMyDlgData 
{ 
    SHORT   cbExtra; 
    MYDATA  myData; 
} MYDLGDATA, UNALIGNED *PMYDLGDATA; 
 
PMYDLGDATA pMyDlgdata = (PMYDLGDATA) (((LPCREATESTRUCT) lParam)->lpCreateParams);

Catatan

Header winuser.h mendefinisikan CREATESTRUCT sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	winuser.h (sertakan Windows.h)