函数功能:该函数将指定菜单项的正文字符串拷贝到指定缓冲区。
1 |
int GetMenuString(HMENU hMenu,UINT uIDItem,LPTSTR lpString,int nMaxCount,UINT uFlag); |
参数:
hWenu:菜单句柄。
uIDItem:指定将被修改的菜单项,其含义由参数uFlag决定。
lpString:指向缓冲区的指针,该缓冲区接受以` ’结束的字符串。如果此参数为NULL,则函数返回菜单字符串的长度。
nMaxCount:指定将被拷贝的字符串的最大字符数。如果字符串长度比此参数指定的最大值还大,则多余的字符被截去。如果此参数为0,则函数退回菜单字符串的长度。
uFlag:指定参数ulDltem如何被解释。此参数可取下列值之一:
MF_BYCOMMAND:表示参数uIDltem给出菜单项的标识符。如果MF_BYCOMMAND和MF_BYPOSITION都没被指定,则MF_BYCOMMAND是缺省值。
MF_BYPOSITION:表示参数uIDltem给出菜单项相对于零的位置。
返回值:如果函数调用成功,返回值是拷贝到缓冲区的字符数,不包括末尾‘ ’结束符:如果函数调用失败,返回值是零。
备注:参数nMaxCount的值必须比正文字符串的长度大一,以容纳末尾的‘ ’结束符。如果参数nMaxCount的值为零,函数返回菜单字符串的长度。