Partager via


IAgentCommands ::Insert

[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible dans les versions ultérieures de 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
);

Insère un objet Command dans une collection Commands.

  • Retourne S_OK pour indiquer que l’opération a réussi.

bszCaption

BSTR qui spécifie la valeur du texte Légende affiché pour lacommande.

bszVoice

BSTR qui spécifie la valeur du paramètre de texte de Voice pour unecommande.

bEnabled

Expression booléenne qui spécifie le paramètre Activé pour une Command. Si le paramètre est True, l'commande est activée et peut être sélectionnée ; si false, la de commande est désactivée.

bVisible

Expression booléenne qui spécifie le paramètre visible pour unde commande. Si le paramètre est True, la Commande sera visible dans le menu contextuel du caractère (si la propriétélégendeest également définie).

dwRefID

ID d’une commande utilisée comme référence pour l’insertion relative du nouveau Commande.

dBefore

Expression booléenne qui spécifie où placer la Command. Si ce paramètre est True, la nouvelle commande est insérée avant l'de commanderéférencée ; si false, la nouvelle commande de est placée après le de commande référencé.

pdwID

Adresse d’une variable qui reçoit l’ID de la commande insérée.

Voir aussi

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