IAgentCommandsEx::InsertEx

[Der Microsoft-Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht mehr verfügbar.]

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
);

Fügt ein Command-Objekt in eine Commands-Auflistung ein.

  • Gibt S _ OK zurück, um anzugeben, dass der Vorgang erfolgreich war.

bszCaption

Ein BSTR, der den Wert des Beschriftungstexts angibt, der für den Befehlangezeigt wird.

bszVoice

Ein BSTR, der den Wert der Sprachtexteinstellung für einen Befehlangibt.

bszVoiceCaption

Ein BSTR, der den Wert des VoiceCaption-Texts angibt, der für einen Befehl in einer Commands-Auflistung angezeigt wird.

bEnabled

Ein boolescher Ausdruck, der die Einstellung Aktiviert für einen Befehlangibt. Wenn der Parameter True ist, ist der Befehl aktiviert und kann ausgewählt werden. False gibt an, dass der Befehl deaktiviert ist.

bVisible

Ein boolescher Ausdruck, der die Visible-Einstellung für einen Befehlangibt. Wenn der Parameter True ist, wird der Befehl im Popupmenü des Zeichens angezeigt (wenn auch die Caption-Eigenschaft festgelegt ist).

ulHelpID

Die Kontextnummer des Hilfethemas, das dem Command-Objekt zugeordnet ist. wird verwendet, um kontextbezogene Hilfe für den Befehl bereitzustellen.

dwRefID

Die ID eines Befehls, der als Verweis für die relative Einfügung des neuen Befehls verwendet wird.

dBefore

Ein boolescher Ausdruck, der angibt, wo der Befehlzu platzieren ist. Wenn dieser Parameter True ist, wird der neue Befehl vor dem Befehl eingefügt, auf den verwiesen wird. False gibt an, dass der neue Befehl nach dem Befehl platziert wird, auf den verwiesen wird.

pdwID

Adresse einer Variablen, die die ID für den eingefügten Befehlempfängt.

IAgentCommandsEx::InsertEx erweitert IAgentCommands::Insert um die HelpContextID-Eigenschaft. Sie können die Eigenschaft auch mit IAgentCommandsEx::SetHelpContextID festlegen.

Weitere Informationen

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