Struktur CREATESTRUCTA (winuser.h)
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) |
Lihat juga
Tentang Antarmuka Beberapa Dokumen
Konseptual
Referensi