次の方法で共有


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_BYCOMMANDMF_BYPOSITION がどちらも設定されていないときの既定の設定になります。

    MF_BYPOSITION

    パラメータを既存のメニュー項目の位置で指定することを示します。最初の項目位置は 0 です。

戻り値

実際にバッファにコピーされた文字数を返します。文字数には文字列の終わりを示す NULL 文字は含みません。

解説

パラメータ nMaxCount の値は、ラベルの文字数よりも 1 文字分以上大きくして、文字列の終わりを示す NULL 文字が入るようにしてください。

使用例

CMenu::InsertMenu」の例を参照してください。

必要条件

ヘッダー : afxwin.h

参照

参照

CMenu クラス

階層図

CMenu::GetMenuState

CMenu::ModifyMenu

GetMenuString

その他の技術情報

CMenu のメンバ