次の方法で共有


CUserToolsManager::CreateNewTool

更新 : 2007 年 11 月

新しいユーザー ツールを作成します。

CUserTool* CreateNewTool();

戻り値

新しく作成されたユーザー ツールへのポインタ。ユーザー ツールの数が最大値を超えた場合は NULL。返される型は、pToolRTC パラメータとして CWinAppEx::EnableUserTools に渡される型と同じです。

解説

このメソッドは、CWinAppEx::EnableUserTools への呼び出しで指定された範囲で使用できる最初のメニュー コマンド ID を検索し、ユーザー ツールにこの ID を割り当てます。

ツールの数が最大値に達した場合、メソッドは失敗します。これは、範囲内のすべてのコマンド ID がユーザー ツールに割り当てられた場合に発生します。CUserToolsManager::GetMaxTools を呼び出して、ツールの最大数を取得できます。ツールの一覧には、CUserToolsManager::GetUserTools メソッドを呼び出してアクセスできます。

必要条件

ヘッダー : afxusertoolsmanager.h

参照

概念

MFC 階層図

参照

CUserToolsManager クラス