Compartilhar via


IAgentCommands::Insert

[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]

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

Insere um objeto Command em uma coleçãocommands.

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

bszCaption

Um BSTR que especifica o valor do Caption texto exibido para o comando .

bszVoice

Um BSTR que especifica o valor da configuração de textode vozpara umde comando de.

bEnabled

Uma expressão booliana que especifica a configuração dehabilitada parapara um comando . Se o parâmetro estiver True, o de Comando do estará habilitado e poderá ser selecionado; se False, o de Comando do será desabilitado.

bVisible

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

dwRefID

A ID de um comando usada 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 de Comando doreferenciado; se False, o novo comando será colocado após o de Comando doreferenciado.

pdwID

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

Consulte Também

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