Fungsi ShowWindow (winuser.h)

Artikel
06/06/2023

Menyetel status peragaan jendela yang ditentukan.

Sintaks

BOOL ShowWindow(
  [in] HWND hWnd,
  [in] int  nCmdShow
);

Parameter

[in] hWnd

Jenis: HWND

Handel ke jendela.

[in] nCmdShow

Jenis: int

Mengontrol bagaimana jendela akan ditampilkan. Parameter ini diabaikan saat pertama kali aplikasi memanggil ShowWindow, jika program yang meluncurkan aplikasi menyediakan struktur STARTUPINFO . Jika tidak, pertama kali ShowWindow dipanggil, nilai harus menjadi nilai yang diperoleh oleh fungsi WinMain dalam parameter nCmdShow-nya . Dalam panggilan berikutnya, parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
SW_HIDE 0	Menyembunyikan jendela dan mengaktifkan jendela lain.
SW_SHOWNORMAL SW_NORMAL 1	Mengaktifkan dan menampilkan jendela. Jika jendela diminimalkan, dimaksimalkan, atau disusun, sistem memulihkannya ke ukuran dan posisi aslinya. Aplikasi harus menentukan bendera ini saat menampilkan jendela untuk pertama kalinya.
SW_SHOWMINIMIZED 2	Mengaktifkan jendela dan menampilkannya sebagai jendela yang diminimalkan.
SW_SHOWMAXIMIZED SW_MAXIMIZE 3	Mengaktifkan jendela dan menampilkannya sebagai jendela yang dimaksimalkan.
SW_SHOWNOACTIVATE 4	Menampilkan jendela dalam ukuran dan posisi terbarunya. Nilai ini mirip dengan SW_SHOWNORMAL, kecuali bahwa jendela tidak diaktifkan.
SW_SHOW 5	Mengaktifkan jendela dan menampilkannya dalam ukuran dan posisinya saat ini.
SW_MINIMIZE 6	Meminimalkan jendela yang ditentukan dan mengaktifkan jendela tingkat atas berikutnya dalam urutan Z.
SW_SHOWMINNOACTIVE 7	Menampilkan jendela sebagai jendela yang diminimalkan. Nilai ini mirip dengan SW_SHOWMINIMIZED, kecuali jendela tidak diaktifkan.
SW_SHOWNA 8	Menampilkan jendela dalam ukuran dan posisinya saat ini. Nilai ini mirip dengan SW_SHOW, kecuali bahwa jendela tidak diaktifkan.
SW_RESTORE 9	Mengaktifkan dan menampilkan jendela. Jika jendela diminimalkan, dimaksimalkan, atau disusun, sistem memulihkannya ke ukuran dan posisi aslinya. Aplikasi harus menentukan bendera ini saat memulihkan jendela yang diminimalkan.
SW_SHOWDEFAULT 10	Mengatur status tampilkan berdasarkan nilai SW_ yang ditentukan dalam struktur STARTUPINFO yang diteruskan ke fungsi CreateProcess oleh program yang memulai aplikasi.
SW_FORCEMINIMIZE 11	Meminimalkan jendela, bahkan jika utas yang memiliki jendela tidak merespons. Bendera ini hanya boleh digunakan saat meminimalkan jendela dari utas yang berbeda.

Nilai kembali

Jenis: BOOL

Jika jendela sebelumnya terlihat, nilai yang dikembalikan bukan nol.

Jika jendela sebelumnya disembunyikan, nilai yang dikembalikan adalah nol.

Keterangan

Untuk melakukan efek khusus tertentu saat menampilkan atau menyembunyikan jendela, gunakan AnimateWindow.

Pertama kali aplikasi memanggil ShowWindow, aplikasi harus menggunakan parameter nCmdShow fungsi WinMain sebagai parameter nCmdShow-nya. Panggilan berikutnya ke ShowWindow harus menggunakan salah satu nilai dalam daftar yang diberikan, bukan yang ditentukan oleh parameter nCmdShow fungsi WinMain.

Seperti yang disebutkan dalam diskusi parameter nCmdShow , nilai nCmdShow diabaikan dalam panggilan pertama ke ShowWindow jika program yang meluncurkan aplikasi menentukan informasi startup dalam struktur. Dalam hal ini, ShowWindow menggunakan informasi yang ditentukan dalam struktur STARTUPINFO untuk menampilkan jendela. Pada panggilan berikutnya, aplikasi harus memanggil ShowWindow dengan nCmdShow diatur ke SW_SHOWDEFAULT untuk menggunakan informasi startup yang disediakan oleh program yang meluncurkan aplikasi. Perilaku ini dirancang untuk situasi berikut:

Aplikasi membuat jendela utama mereka dengan memanggil CreateWindow dengan bendera WS_VISIBLE diatur.
Aplikasi membuat jendela utama mereka dengan memanggil CreateWindow dengan bendera WS_VISIBLE dibersihkan, dan kemudian memanggil ShowWindow dengan bendera SW_SHOW diatur untuk membuatnya terlihat.

Contoh

Misalnya, lihat Membuat Jendela Utama.

Persyaratan


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