Insert, méthode
[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible dans les versions ultérieures de Windows.]
-
Description
-
Insère un objet Command dans la collection Commands .
-
Syntaxe
-
agent**. Caractères (« CharacterID »). Commands.Insert** Name, RefName, Before_
Légende, Voix, Activé, Visible
Élément Description Nom Obligatoire. Valeur de chaîne correspondant à l’ID que vous affectez à la commande. RefName Obligatoire. Valeur de chaîne correspondant au nom (ID) de la commande juste au-dessus ou au-dessous de l’emplacement où vous souhaitez insérer la nouvelle commande. Avant Optionnel. Valeur booléenne indiquant s’il faut insérer la nouvelle commande avant la commande spécifiée par RefName. True (valeur par défaut). La nouvelle commande sera insérée avant la commande référencée.
Faux La nouvelle commande sera insérée après la commande référencée.Caption Optionnel. Valeur de chaîne correspondant au nom qui apparaîtra dans le menu contextuel du caractère et dans la fenêtre Commandes lorsque l’application cliente est active en entrée. Pour plus d’informations, consultez la propriété Captionde l’objet Command. Voice Optionnel. Valeur de chaîne correspondant aux mots ou à l’expression à utiliser par le moteur vocal pour reconnaître cette commande. Pour plus d’informations sur la mise en forme des alternatives pour la chaîne, consultez la propriété Voice de l’objet Command. Activé Optionnel. Valeur booléenne indiquant si la commande est activée. La valeur par défaut est True. Pour plus d’informations, consultez la propriété Enabled de l’objet Command. Visible Optionnel. Valeur booléenne indiquant si la commande est visible dans la fenêtre Commandes lorsque l’application cliente est active en entrée. La valeur par défaut est True. Pour plus d’informations, consultez la propriété Visible de l’objet Command.
Notes
La valeur de la propriété Name d’un objet Command doit être unique au sein de sa collection Commands. Vous devez supprimer une commande avant de pouvoir en créer une avec le même paramètre de propriété Name . La tentative de création d’une commande avec une propriété Name qui existe déjà génère une erreur.
Cette méthode retourne également un objet Command . Cela vous permet de déclarer un objet et de lui attribuer une commande lorsque vous appelez la méthode 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"