次の方法で共有

IAgentCommandsEx::InsertEx

  • [アーティクル]

[Microsoft エージェントは Windows 7 の時点で非推奨となり、以降のバージョンの Windows では使用できない場合があります。]

HRESULT InsertEx(
   BSTR bszCaption,       // Caption setting for Command
   BSTR bszVoice,         // Voice setting for Command
   BSTR bszVoiceCaption,  // VoiceCaption setting for Command
   long bEnabled,         // Enabled setting for Command
   long bVisible,         // Visible setting for Command
   long ulHelpID,         // HelpContextID setting for Command
   long dwRefID,          // reference Command for insertion
   long dBefore,          // insertion position flag
   long * pdwID           // address for variable for Command ID
);

Command コレクションに Command オブジェクトを挿入 します 。

  • 操作が成功したことを示すS_OKを返します。

bszCaption

Command に表示されるキャプション テキストの値を指定する BSTR。

bszVoice

Command の音声テキスト設定の値を指定する BSTR。

bszVoiceCaption

Command コレクション内の Command に対して表示される VoiceCaption テキストの値を指定する BSTR。

bEnabled

Command の Enabled 設定を指定するブール式。 パラメーターが True の場合、 Command は有効になり、選択できます。 False の場合、 コマンド は無効になります。

bVisible

Command の Visible 設定を指定するブール式。 パラメーターが True の場合、 Command は文字のポップアップ メニューに表示されます ( Caption プロパティも設定されている場合)。

ulHelpID

Command オブジェクトに関連付けられているヘルプ トピックのコンテキスト番号。コマンドの状況依存のヘルプを提供するために使用されます。

dwRefID

新しい Command の相対挿入の参照として使用される Command の ID。

dBefore

Command を配置する場所を指定するブール式。 このパラメーターが True の場合、参照される Command の前に新しい Command が挿入 されます。 False の場合、新しい コマンド は、参照されている コマンドの後に配置されます。

pdwID

挿入された Command の ID を受け取る変数のアドレス。

IAgentCommandsEx::InsertEx は、HelpContextID プロパティを含めることで IAgentCommands::Insert を拡張します。 プロパティは、IAgentCommandsEx::SetHelpContextID を使用して設定することもできます。

参照

IAgentCommandsEx::AddEx、 IAgentCommandsEx::SetHelpContextID、 IAgentCommands::Add、 IAgentCommands::Remove、 IAgentCommands::RemoveAll