GetMenuString是計算機程式語言函式。他的功能是將指定選單項的正文字元串拷貝到指定緩衝區。
基本介紹
- 外文名：GetMenuString
- hWenu：選單句柄
- uIDItem：定將被修改的選單項
- lpString：向緩衝區的指針
- nMaxCount：將被拷貝的字元串的最大字元數
函式原型,基本參數,
函式原型
int GetMenuString(HMENU hMenu,UINT uIDItem,LPTSTR lpString,int nMaxCount,UINT uFlag);
基本參數
hWenu：選單句柄。
uIDItem：指定將被修改的選單項，其含義由參數uFlag決定。
lpString：指向緩衝區的指針，該緩衝區接受以`\0’結束的字元串。如果此參數為NULL，則函式返回選單字元串的長度。
nMaxCount：指定將被拷貝的字元串的最大字元數。如果字元串長度比此參數指定的最大值還大，則多餘的字元被截去。如果此參數為0，則函式退回選單字元串的長度。
uFlag：指定參數ulDltem如何被解釋。此參數可取下列值之一：
MF_BYCOMMAND：表示參數uIDltem給出選單項的標識符。如果MF_BYCOMMAND和MF_BYPOSITION都沒被指定，則MF_BYCOMMAND是預設值。
MF_BYPOSITION：表示參數uIDltem給出選單項相對於零的位置。
返回值：如果函式調用成功，返回值是拷貝到緩衝區的字元數，不包括末尾‘\0’結束符：如果函式調用失敗，返回值是零。
參數nMaxCount的值必須比正文字元串的長度大一，以容納末尾的‘\0’結束符。如果參數nMaxCount的值為零，函式返回選單字元串的長度。
