Fungsi GetMenuDefaultItem (winuser.h)

Artikel
03/13/2024

Menentukan item menu default pada menu yang ditentukan.

Sintaks

UINT GetMenuDefaultItem(
  [in] HMENU hMenu,
  [in] UINT  fByPos,
  [in] UINT  gmdiFlags
);

Parameter

[in] hMenu

Jenis: HMENU

Handel ke menu untuk mengambil item menu default.

[in] fByPos

Jenis: UINT

Menunjukkan apakah akan mengambil pengidentifikasi item menu atau posisinya. Jika parameter ini FALSE, pengidentifikasi dikembalikan. Jika tidak, posisi dikembalikan.

[in] gmdiFlags

Jenis: UINT

Menunjukkan bagaimana fungsi harus mencari item menu. Parameter ini bisa nol atau lebih dari nilai berikut.

Nilai	Makna
GMDI_GOINTOPOPUPS 0x0002L	Jika item default adalah item yang membuka submenu, fungsinya adalah mencari secara rekursif di submenu yang sesuai. Jika submenu tidak memiliki item default, nilai pengembalian mengidentifikasi item yang membuka submenu. Secara default, fungsi mengembalikan item default pertama pada menu yang ditentukan, terlepas dari apakah itu item yang membuka submenu.
GMDI_USEDISABLED 0x0001L	Fungsinya adalah mengembalikan item default, meskipun dinonaktifkan. Secara default, fungsi melompati item yang dinonaktifkan atau berwarna abu-abu.

Mengembalikan nilai

Jenis: UINT

Jika fungsi berhasil, nilai yang dikembalikan adalah pengidentifikasi atau posisi item menu.

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

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)

Lihat juga

Konseptual

Referensi

SetMenuDefaultItem