Fungsi MoveWindow (winuser.h)

Artikel
03/04/2024

Mengubah posisi dan dimensi jendela yang ditentukan. Untuk jendela tingkat atas, posisi dan dimensi relatif terhadap sudut kiri atas layar. Untuk jendela anak, mereka relatif terhadap sudut kiri atas area klien jendela induk.

Sintaks

BOOL MoveWindow(
  [in] HWND hWnd,
  [in] int  X,
  [in] int  Y,
  [in] int  nWidth,
  [in] int  nHeight,
  [in] BOOL bRepaint
);

Parameter

[in] hWnd

Jenis: HWND

Handel ke jendela.

[in] X

Jenis: int

Posisi baru sisi kiri jendela.

[in] Y

Jenis: int

Posisi baru bagian atas jendela.

[in] nWidth

Jenis: int

Lebar baru jendela.

[in] nHeight

Jenis: int

Tinggi jendela yang baru.

[in] bRepaint

Jenis: BOOL

Menunjukkan apakah jendela akan dicat ulang. Jika parameter ini TRUE, jendela akan menerima pesan. Jika parameternya FALSE, tidak ada pengecatan ulang dalam bentuk apa pun yang terjadi. Ini berlaku untuk area klien, area nonclient (termasuk bilah judul dan bilah gulir), dan bagian mana pun dari jendela induk yang terungkap sebagai akibat dari memindahkan jendela anak.

Mengembalikan nilai

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

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

Keterangan

Jika parameter bRepaintTRUE, sistem mengirim pesan WM_PAINT ke prosedur jendela segera setelah memindahkan jendela (yaitu, fungsi MoveWindow memanggil fungsi UpdateWindow ). Jika bRepaintFALSE, aplikasi harus secara eksplisit membatalkan atau menggambar ulang bagian jendela dan jendela induk yang perlu digambar ulang.

MoveWindow mengirim pesan WM_WINDOWPOSCHANGING, WM_WINDOWPOSCHANGED, WM_MOVE, WM_SIZE, dan WM_NCCALCSIZE ke jendela.

Contoh

Misalnya, lihat Membuat, Menghitung, dan Mengukur Jendela Anak.

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
Set API	ext-ms-win-ntuser-window-l1-1-1 (diperkenalkan dalam Windows 8.1)