Método Insert

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

Descrição

Insere um objeto Command na coleção Commands .

Sintaxe

agent**. Caracteres ("CharacterID"). Commands.Insert** Name, RefName, Before_

Legenda, Voz, Habilitado, Visível

Parte	Descrição
Nome	Obrigatórios. Um valor de cadeia de caracteres correspondente à ID que você atribui ao Comando.
Refname	Obrigatórios. Um valor de cadeia de caracteres correspondente ao nome (ID) do comando logo acima ou abaixo de onde você deseja inserir o novo comando.
Antes	Opcional. Um valor booliano que indica se o novo comando deve ser inserido antes do comando especificado por RefName. True (padrão). O novo comando será inserido antes do comando referenciado. False O novo comando será inserido após o comando referenciado.
Legenda	Opcional. Um valor de cadeia de caracteres correspondente ao nome que aparecerá no menu pop-up do caractere e na janela Comandos quando o aplicativo cliente estiver ativo na entrada. Para obter mais informações, consulte a propriedade Captiondo objeto Command.
Voz	Opcional. Um valor de cadeia de caracteres correspondente às palavras ou frase a serem usadas pelo mecanismo de fala para reconhecer esse comando. Para obter mais informações sobre alternativas de formatação para a cadeia de caracteres, consulte a propriedade Voice do objeto Command.
Enabled	Opcional. Um valor booliano que indica se o comando está habilitado. O valor padrão é True. Para obter mais informações, consulte a propriedade Enabled do objeto Command.
Visível	Opcional. Um valor booliano que indica se o comando está visível na janela Comandos quando o aplicativo cliente está ativo na entrada. O valor padrão é True. Para obter mais informações, consulte a propriedade Visible do objeto Command.

Comentários

O valor da propriedade Name de um objeto Command deve ser exclusivo em sua coleção Commands. Você deve remover um Comando antes de criar um novo Comando com a mesma configuração de propriedade Name . A tentativa de criar um Command com uma propriedade Name que já existe gera um erro.

Esse método também retorna um objeto Command . Isso permite que você declare um objeto e atribua um Command a ele ao chamar o método Insert .

   Dim Cmd2 as IAgentCtlCommandEx
   Set Cmd2 = Genie.Commands.Insert ("my second command", "my first command",_ True, "Test", "Test", True, True)
   Cmd2.VoiceCaption = "this is a test"

Consulte Também

Método Add, Método Remove, Método RemoveAll