Fungsi GetMenuStringA (winuser.h)

Menyalin string teks dari item menu yang ditentukan ke dalam buffer yang ditentukan.

Sintaksis

int GetMenuStringA(
  [in]            HMENU hMenu,
  [in]            UINT  uIDItem,
  [out, optional] LPSTR lpString,
  [in]            int   cchMax,
  [in]            UINT  flags
);

Parameter

[in] hMenu

Jenis: HMENU

Handel ke menu.

[in] uIDItem

Jenis: UINT

Item menu yang akan diubah, seperti yang ditentukan oleh parameter uFlag.

[out, optional] lpString

Jenis: LPTSTR

Buffer yang menerima string null-terminated. Jika string selama atau lebih lama dari lpString, string dipotong dan karakter null penghentian ditambahkan. Jika lpString NULL, fungsi mengembalikan panjang string menu.

[in] cchMax

Jenis: int

Panjang maksimum, dalam karakter, dari string yang akan disalin. Jika string lebih panjang dari maksimum yang ditentukan dalam parameter nMaxCount, karakter tambahan akan dipotong. Jika nMaxCount adalah 0, fungsi mengembalikan panjang string menu.

[in] flags

Jenis: UINT

Menunjukkan bagaimana parameter uIDItem ditafsirkan. Parameter ini harus menjadi salah satu nilai berikut.

Mengembalikan nilai

Jenis: int

Jika fungsi berhasil, nilai pengembalian menentukan jumlah karakter yang disalin ke buffer, tidak termasuk karakter null yang mengakhiri.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Jika item yang ditentukan bukan tipe MIIM_STRING atau MFT_STRING, maka nilai yang dikembalikan adalah nol.

Komentar

Parameter nMaxCount harus satu lebih besar dari jumlah karakter dalam string teks untuk mengakomodasi karakter null yang mengakhiri.

Jika nMaxCount adalah 0, fungsi mengembalikan panjang string menu.

Peringatan Keamanan