IAgentCommands::Insert

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

HRESULT Insert(
   BSTR bszCaption,  // Caption setting for Command
   BSTR bszVoice,    // Voice setting for Command
   long bEnabled,    // Enabled setting for Command
   long bVisible,    // Visible 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 Caption- Texts angibt, der für den Commandangezeigt wird.

bszVoice

Ein BSTR, der den Wert der Voice- Texteinstellung für eine Commandangibt.

bEnabled

Ein boolescher Ausdruck, der die Einstellung Enabled für ein Command-angibt. Wenn der Parameter Trueist, ist das Command aktiviert und kann ausgewählt werden; wenn False, ist der Command deaktiviert.

bVisible

Ein boolescher Ausdruck, der die Einstellung Visible für eine Commandangibt. Wenn der Parameter Trueist, wird das Command- im Popupmenü des Zeichens angezeigt (wenn auch die eigenschaft Caption festgelegt ist).

dwRefID-

Die ID eines Command- als Verweis für die relative Einfügung des neuen Commandverwendet.

dBefore

Ein boolescher Ausdruck, der angibt, wo die Commandplatziert werden soll. Wenn dieser Parameter Trueist, wird das neue Command- vor dem verweisierten Command-eingefügt; wenn False, wird das neue Command nach dem verweisierten Commandplatziert.

pdwID-

Adresse einer Variablen, die die ID für das eingefügte Commandempfängt.

Siehe auch

IAgentCommands::Add, IAgentCommands::Remove, IAgentCommands::RemoveAll