Fungsi GetSystemMenu (winuser.h)

Artikel
03/04/2024

Memungkinkan aplikasi mengakses menu jendela (juga dikenal sebagai menu sistem atau menu kontrol) untuk menyalin dan memodifikasi.

Sintaks

HMENU GetSystemMenu(
  [in] HWND hWnd,
  [in] BOOL bRevert
);

Parameter

[in] hWnd

Jenis: HWND

Handel ke jendela yang akan memiliki salinan menu jendela.

[in] bRevert

Jenis: BOOL

Tindakan yang akan diambil. Jika parameter ini FALSE, GetSystemMenu mengembalikan handel ke salinan menu jendela yang saat ini digunakan. Salinan awalnya identik dengan menu jendela, tetapi dapat dimodifikasi. Jika parameter ini TRUE, GetSystemMenu mengatur ulang menu jendela kembali ke status default. Menu jendela sebelumnya, jika ada, dihancurkan.

Nilai kembali

Jenis: HMENU

Jika parameter bRevertFALSE, nilai yang dikembalikan adalah handel ke salinan menu jendela. Jika parameter bRevertTRUE, nilai yang dikembalikan adalah NULL.

Keterangan

Jendela apa pun yang tidak menggunakan fungsi GetSystemMenu untuk membuat salinan menu jendela sendiri menerima menu jendela standar.

Menu jendela awalnya berisi item dengan berbagai nilai pengidentifikasi, seperti SC_CLOSE, SC_MOVE, dan SC_SIZE.

Item menu pada menu jendela mengirim pesan WM_SYSCOMMAND .

Semua item menu jendela yang telah ditentukan sebelumnya memiliki nomor pengidentifikasi yang lebih besar dari 0xF000. Jika aplikasi menambahkan perintah ke menu jendela, aplikasi harus menggunakan nomor pengidentifikasi kurang dari 0xF000.

Sistem secara otomatis memerintah item pada menu jendela standar, tergantung pada situasinya. Aplikasi dapat melakukan pemeriksaan atau abu-abu sendiri dengan menanggapi pesan WM_INITMENU yang dikirim sebelum menu ditampilkan.

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