Método Insert

[O Microsoft Agent foi preterido a partir do Windows 7 e pode não estar disponível em versões subsequentes do Windows.]

Descrição

Insere um objeto Command na coleção Commands.

Sintaxe

agente**. Personagens ("CharacterID"). Commands.Insert** nome, RefName, antes_

Legenda, Voz, Ativado, Visível

Peça	Descrição
Nome	Necessário. Um valor de cadeia de caracteres correspondente ao ID atribuído ao Command.
RefName	Necessário. 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 booleano 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. Falso 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 de entrada. Para obter mais informações, consulte a propriedade CaptionCaption do Command do objeto.
Voz	Opcional. Um valor de cadeia de caracteres correspondente às palavras ou frases 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 CommandVoice do objeto.
ativado	Opcional. Um valor booleano que indica se o comando está habilitado. O valor padrão é True. Para obter mais informações, consulte o CommandEnabled propriedade do objeto.
visível	Opcional. Um valor booleano que indica se o comando está visível na janela Comandos quando o aplicativo cliente está ativo de entrada. O valor padrão é True. Para obter mais informações, consulte a propriedade Visible do objetoCommand.

Comentários

O valor de um Command propriedadeNamedo objeto deve ser exclusivo dentro de sua coleçãoCommands. Você deve remover uma de Comando antes de criar uma nova de Comando com a mesma configuração de propriedade Nome . A tentativa de criar um de comando com uma propriedade Name que já existe gera um erro.

Esse método também retorna um Command objeto. Isso permite que você declare um objeto e atribua um de comando a ele quando você chama 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"

Ver também

método Add, Remove métodométodo RemoveAll