Fungsi BeginDeferWindowPos (winuser.h)

Artikel
03/04/2024

Mengalokasikan memori untuk struktur posisi beberapa jendela dan mengembalikan handel ke struktur.

Sintaks

HDWP BeginDeferWindowPos(
  [in] int nNumWindows
);

Parameter

[in] nNumWindows

Jenis: int

Jumlah awal jendela untuk menyimpan informasi posisi. Fungsi DeferWindowPos meningkatkan ukuran struktur, jika perlu.

Nilai kembali

Jenis: HDWP

Jika fungsi berhasil, nilai pengembalian mengidentifikasi struktur posisi beberapa jendela. Jika sumber daya sistem yang tidak mencukupkan tersedia untuk mengalokasikan struktur, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Struktur multiple-window-position adalah struktur internal; aplikasi tidak dapat mengaksesnya secara langsung.

DeferWindowPos mengisi struktur posisi beberapa jendela dengan informasi tentang posisi target untuk satu atau beberapa jendela yang akan dipindahkan. Fungsi EndDeferWindowPos menerima handel ke struktur ini dan memposisikan ulang jendela dengan menggunakan informasi yang disimpan dalam struktur.

Jika sistem harus meningkatkan ukuran struktur posisi beberapa jendela di luar ukuran awal yang ditentukan oleh parameter nNumWindows tetapi tidak dapat mengalokasikan cukup memori untuk melakukannya, sistem gagal seluruh urutan posisi jendela (BeginDeferWindowPos, DeferWindowPos, dan EndDeferWindowPos). Dengan menentukan ukuran maksimum yang diperlukan, aplikasi dapat mendeteksi dan memproses kegagalan di awal proses.

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 (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-window-l1-1-4 (diperkenalkan dalam Windows 10, versi 10.0.14393)