Fungsi CreateMDIWindowA (winuser.h)

Artikel
08/27/2023

Membuat jendela anak antarmuka multi-dokumen (MDI).

Sintaks

HWND CreateMDIWindowA(
  [in]           LPCSTR    lpClassName,
  [in]           LPCSTR    lpWindowName,
  [in]           DWORD     dwStyle,
  [in]           int       X,
  [in]           int       Y,
  [in]           int       nWidth,
  [in]           int       nHeight,
  [in, optional] HWND      hWndParent,
  [in, optional] HINSTANCE hInstance,
  [in]           LPARAM    lParam
);

Parameter

[in] lpClassName

Jenis: LPCTSTR

Kelas jendela jendela anak MDI. Nama kelas harus telah didaftarkan oleh panggilan ke fungsi RegisterClassEx .

[in] lpWindowName

Jenis: LPCTSTR

Nama jendela. Sistem menampilkan nama di bilah judul jendela anak.

[in] dwStyle

Jenis: DWORD

Gaya jendela anak MDI. Jika jendela klien MDI dibuat dengan gaya jendela MDIS_ALLCHILDSTYLES , parameter ini bisa menjadi kombinasi gaya jendela apa pun yang tercantum di halaman Gaya Jendela . Jika tidak, parameter ini terbatas pada satu atau beberapa nilai berikut.

Nilai	Makna
WS_MINIMIZE 0x20000000L	Membuat jendela anak MDI yang awalnya diminimalkan.
WS_MAXIMIZE 0x01000000L	Membuat jendela anak MDI yang awalnya dimaksimalkan.
WS_HSCROLL 0x00100000L	Membuat jendela anak MDI yang memiliki bilah gulir horizontal.
WS_VSCROLL 0x00200000L	Membuat jendela anak MDI yang memiliki bilah gulir vertikal.

[in] X

Jenis: int

Posisi horizontal awal, dalam koordinat klien, dari jendela anak MDI. Jika parameter ini CW_USEDEFAULT ((int)0x80000000), jendela anak MDI diberi posisi horizontal default.

[in] Y

Jenis: int

Posisi vertikal awal, dalam koordinat klien, dari jendela anak MDI. Jika parameter ini CW_USEDEFAULT, jendela anak MDI diberi posisi vertikal default.

[in] nWidth

Jenis: int

Lebar awal, dalam unit perangkat, dari jendela anak MDI. Jika parameter ini CW_USEDEFAULT, jendela anak MDI diberi lebar default.

[in] nHeight

Jenis: int

Tinggi awal, di unit perangkat, dari jendela anak MDI. Jika parameter ini diatur ke CW_USEDEFAULT, jendela anak MDI diberi tinggi default.

[in, optional] hWndParent

Jenis: HWND

Handel ke jendela klien MDI yang akan menjadi induk jendela anak MDI baru.

[in, optional] hInstance

Jenis: HINSTANCE

Handel ke instans aplikasi yang membuat jendela anak MDI.

[in] lParam

Jenis: LPARAM

Nilai yang ditentukan aplikasi.

Mengembalikan nilai

Jenis: HWND

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke jendela yang dibuat.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Catatan

Header winuser.h mendefinisikan CreateMDIWindow 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

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll