Fungsi GetWindowPlacement (winuser.h)

  • Artikel

Mengambil status pertunjukan dan posisi yang dipulihkan, diminimalkan, dan dimaksimalkan dari jendela yang ditentukan.

Sintaks

BOOL GetWindowPlacement(
  [in]      HWND            hWnd,
  [in, out] WINDOWPLACEMENT *lpwndpl
);

Parameter

[in] hWnd

Jenis: HWND

Handel ke jendela.

[in, out] lpwndpl

Jenis: WINDOWPLACEMENT*

Penunjuk ke struktur WINDOWPLACEMENT yang menerima status tampilkan dan informasi posisi. Sebelum memanggil GetWindowPlacement, atur panjang anggota ke sizeof(WINDOWPLACEMENT). GetWindowPlacement gagal jika panjang lpwndpl> tidak diatur dengan benar.

Nilai kembali

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

Anggota benderaWINDOWPLACEMENT yang diambil oleh fungsi ini selalu nol. Jika jendela yang diidentifikasi oleh parameter hWnd dimaksimalkan, anggota showCmd SW_SHOWMAXIMIZED. Jika jendela diminimalkan, showCmd SW_SHOWMINIMIZED. Jika tidak, itu SW_SHOWNORMAL.

Panjang anggotaWINDOWPLACEMENT harus diatur ke sizeof(WINDOWPLACEMENT). Jika anggota ini tidak diatur dengan benar, fungsi mengembalikan FALSE. Untuk keterangan tambahan tentang penggunaan koordinat penempatan jendela yang tepat, lihat WINDOWPLACEMENT.

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-0 (diperkenalkan dalam Windows 8)

Lihat juga

Konseptual

Referensi

SetWindowPlacement

WINDOWPLACEMENT

Windows