IAgentCommandsEx::AddEx

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

HRESULT AddEx(
   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 * pdwID           // address for variable for ID
);

Fügt einer Commands-Auflistung einen Befehl hinzu.

• Gibt S_OK zurück, um anzugeben, dass der Vorgang erfolgreich war.

bszCaption

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

bszVoice

Ein BSTR, der den Wert der Sprachtexteinstellung für einen Befehl in einer Commands-Auflistung angibt.

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 Enabled für einen Befehl in einer Commands-Auflistung angibt. Wenn der Parameter True ist, ist der Befehl aktiviert und kann ausgewählt werden. Bei False ist der Befehl deaktiviert.

bVisible

Ein boolescher Ausdruck, der die Visible-Einstellung für einen Befehl in einer Commands-Auflistung angibt. 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.

pdwID

Adresse einer Variablen, die die ID für den hinzugefügten Befehl empfängt.

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

Weitere Informationen

IAgentCommands::Add, IAgentCommandsEx::SetHelpContextID, IAgentCommand::SetCaption, IAgentCommand::SetEnabled, IAgentCommand::SetVisible, IAgentCommand::SetVoice, IAgentCommands::Insert, IAgentCommandsEx::Insert,IAgentCommandsEx, IAgentCommands::Remove, IAgentCommands::RemoveAll