次の方法で共有


CMenu::GetMenuString

指定されたメニュー項目のラベルを指定されたバッファーにコピーします。

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 のメンバー