The GetMenuString function copies the text string of the specified menu item into the specified buffer.
The GetMenuString function function has been superseded. Use the GetMenuItemInfo function to retrieve the menu item text.
int GetMenuString(
HMENU hMenu, // handle to the menu
UINT uIDItem, // menu item identifier
LPTSTR lpString, // pointer to the buffer for the string
int nMaxCount, // maximum length of the string
UINT uFlag // menu flags
);
If lpString is NULL, the function returns the length of the menu string.
If nMaxCount is 0, the function returns the length of the menu string.
Value | Meaning |
---|---|
MF_BYCOMMAND | Indicates that uIDItem gives the identifier of the menu item. If neither the MF_BYCOMMAND nor MF_BYPOSITION flag is specified, the MF_BYCOMMAND flag is the default flag. |
MF_BYPOSITION | Indicates that uIDItem gives the zero-based relative position of the menu item. |
If the function succeeds, the return value specifies the number of characters copied to the buffer, not including the terminating null character.
If the function fails, the return value is zero.
The nMaxCount parameter must be one larger than the number of characters in the text string to accommodate the terminating null character.
If nMaxCount is 0, the function returns the length of the menu string.
Menus Overview, Menu Functions, GetMenuItemID