Struktur CREATESTRUCTW (winuser.h)

Artikel
11/20/2024

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

Sintaksis

typedef struct tagCREATESTRUCTW {
  LPVOID    lpCreateParams;
  HINSTANCE hInstance;
  HMENU     hMenu;
  HWND      hwndParent;
  int       cy;
  int       cx;
  int       y;
  int       x;
  LONG      style;
  LPCWSTR   lpszName;
  LPCWSTR   lpszClass;
  DWORD     dwExStyle;
} CREATESTRUCTW, *LPCREATESTRUCTW;

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 penunjuk 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 Komentar 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 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 dari 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 Window Styles.

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 Extended Window Styles.

Komentar

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

Anda harus mengakses data yang diwakili oleh lpCreateParams anggota menggunakan penunjuk yang telah dideklarasikan menggunakan jenis UNALIGNED, karena penunjuk mungkin tidak DWORD selaras. 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);

Nota

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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	winuser.h (termasuk Windows.h)