Struktur WINDOWPLACEMENT (winuser.h)

Artikel
03/15/2023

Berisi informasi tentang penempatan jendela pada layar.

Sintaks

typedef struct tagWINDOWPLACEMENT {
  UINT  length;
  UINT  flags;
  UINT  showCmd;
  POINT ptMinPosition;
  POINT ptMaxPosition;
  RECT  rcNormalPosition;
  RECT  rcDevice;
} WINDOWPLACEMENT;

Anggota

length

Jenis: UINT

Panjang struktur, dalam byte. Sebelum memanggil fungsi GetWindowPlacement atau SetWindowPlacement , atur anggota ini ke sizeof(WINDOWPLACEMENT).

GetWindowPlacement dan SetWindowPlacement gagal jika anggota ini tidak diatur dengan benar.

flags

Jenis: UINT

Bendera yang mengontrol posisi jendela yang diminimalkan dan metode di mana jendela dipulihkan. Anggota ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Makna
WPF_ASYNCWINDOWPLACEMENT 0x0004	Jika utas panggilan dan utas yang memiliki jendela dilampirkan ke antrean input yang berbeda, sistem memposting permintaan ke utas yang memiliki jendela. Ini mencegah utas panggilan memblokir eksekusinya sementara utas lain memproses permintaan.
WPF_RESTORETOMAXIMIZED 0x0002	Jendela yang dipulihkan akan dimaksimalkan, terlepas dari apakah jendela tersebut dimaksimalkan sebelum diminimalkan. Pengaturan ini hanya valid saat berikutnya jendela dipulihkan. Ini tidak mengubah perilaku pemulihan default. Bendera ini hanya valid ketika nilai SW_SHOWMINIMIZED ditentukan untuk anggota showCmd .
WPF_SETMINPOSITION 0x0001	Koordinat jendela yang diminimalkan dapat ditentukan. Bendera ini harus ditentukan jika koordinat diatur dalam anggota ptMinPosition .

showCmd

Jenis: UINT

Status peragaan jendela saat ini. Ini bisa menjadi salah satu nilai yang dapat ditentukan dalam parameter nCmdShow untuk fungsi ShowWindow .

ptMinPosition

Jenis: TITIK

Koordinat sudut kiri atas jendela saat jendela diminimalkan.

ptMaxPosition

Jenis: TITIK

Koordinat sudut kiri atas jendela saat jendela dimaksimalkan.

rcNormalPosition

Jenis: RECT

Jendela berkoordinasi ketika jendela berada di posisi yang dipulihkan.

rcDevice

Keterangan

Jika jendela adalah jendela tingkat atas yang tidak memiliki gaya jendela WS_EX_TOOLWINDOW , maka koordinat yang diwakili oleh anggota berikut berada dalam koordinat ruang kerja: ptMinPosition, ptMaxPosition, dan rcNormalPosition. Jika tidak, anggota ini berada dalam koordinat layar.

Koordinat ruang kerja berbeda dari koordinat layar karena koordinat tersebut mempertimbangkan lokasi dan ukuran toolbar aplikasi (termasuk taskbar). Koordinat ruang kerja (0,0) adalah sudut kiri atas area ruang kerja, area layar yang tidak digunakan oleh toolbar aplikasi.

Koordinat yang digunakan dalam struktur WINDOWPLACEMENT hanya boleh digunakan oleh fungsi GetWindowPlacement dan SetWindowPlacement . Meneruskan koordinat ruang kerja ke fungsi yang mengharapkan koordinat layar (seperti SetWindowPos) akan mengakibatkan jendela muncul di lokasi yang salah. Misalnya, jika taskbar berada di bagian atas layar, menyimpan koordinat jendela menggunakan GetWindowPlacement dan memulihkannya menggunakan SetWindowPos menyebabkan jendela tampak "merayap" ke atas layar.

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)