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