IAgentCommandsEx::InsertEx

[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do 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
);

Insere um objeto Command em uma coleção Commands .

• Retorna S_OK para indicar que a operação foi bem-sucedida.

bszCaption

Um BSTR que especifica o valor do texto Legenda exibido para o Comando.

bszVoice

Um BSTR que especifica o valor da configuração de texto de voz para um Comando.

bszVoiceCaption

Um BSTR que especifica o valor do texto VoiceCaption exibido para um Command em uma coleção Commands .

bEnabled

Uma expressão booliana que especifica a configuração Habilitada para um Comando. Se o parâmetro for True, o Comando será habilitado e poderá ser selecionado; se False, o Comando será desabilitado.

bVisible

Uma expressão booliana que especifica a configuração Visible para um Comando. Se o parâmetro for True, o Comando ficará visível no menu pop-up do caractere (se a propriedade Caption também estiver definida).

ulHelpID

O número de contexto do tópico de ajuda associado ao objeto Command ; usado para fornecer ajuda contextual para o comando.

dwRefID

A ID de um comando usado como referência para a inserção relativa do novo Comando.

dBefore

Uma expressão booliana que especifica onde colocar o Comando. Se esse parâmetro for True, o novo Comando será inserido antes do comando referenciado; se False, o novo Comando será colocado após o Comando referenciado.

pdwID

Endereço de uma variável que recebe a ID do Comando inserido.

IAgentCommandsEx::InsertEx estende IAgentCommands::Insert incluindo a propriedade HelpContextID . Você também pode definir a propriedade usando IAgentCommandsEx::SetHelpContextID

Consulte Também

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