Fungsi GetMenuDefaultItem (winuser.h)

  • Artikel

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

Menu

Referensi

SetMenuDefaultItem