CMenu::GetMenuString
更新 : 2007 年 11 月
指定されたメニュー項目のラベルを指定されたバッファにコピーします。
int GetMenuString(
UINT nIDItem,
LPTSTR lpString,
int nMaxCount,
UINT nFlags
) const;
int GetMenuString(
UINT nIDItem,
CString& rString,
UINT nFlags
) const;
パラメータ
nIDItem
メニュー項目の整数の ID またはメニュー内のメニュー項目のオフセットを指定します。どちらを指定するかは nFlags の値で決まります。lpString
ラベルを受け取るバッファへのポインタ。rString
コピーされるメニュー文字列を受け取る CString オブジェクトへの参照。nMaxCount
コピーされるラベルの最大長を (文字単位で) 指定します。ラベルが nMaxCount で指定した最大長よりも長いときは、文字は切り詰められます。nFlags
nIDItem の解釈を指定します。次のいずれかの値を指定できます。nFlags
nIDItem の解釈
MF_BYCOMMAND
パラメータを既存のメニュー項目のコマンド ID で指定することを示します。MF_BYCOMMAND と MF_BYPOSITION がどちらも設定されていないときの既定の設定になります。
MF_BYPOSITION
パラメータを既存のメニュー項目の位置で指定することを示します。最初の項目位置は 0 です。
戻り値
実際にバッファにコピーされた文字数を返します。文字数には文字列の終わりを示す NULL 文字は含みません。
解説
パラメータ nMaxCount の値は、ラベルの文字数よりも 1 文字分以上大きくして、文字列の終わりを示す NULL 文字が入るようにしてください。
使用例
「CMenu::InsertMenu」の例を参照してください。
必要条件
ヘッダー : afxwin.h