Partager via

IAgentCommandsEx::InsertEx

  • Article

[Microsoft Agent est déconseillé à partir de Windows 7 et peut ne pas être disponible dans les versions ultérieures de Windows.]

HRESULT InsertEx(
   BSTR bszCaption,       // Caption setting for Command
   BSTR bszVoice,         // Voice setting for Command
   BSTR bszVoiceCaption,  // VoiceCaption setting for Command
   long bEnabled,         // Enabled setting for Command
   long bVisible,         // Visible setting for Command
   long ulHelpID,         // HelpContextID 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 de légende affiché pour la commande.

bszVoice

BSTR qui spécifie la valeur du paramètre de texte Voix pour une commande.

bszVoiceCaption

BSTR qui spécifie la valeur du texte VoiceCaption affiché pour une commande dans une collection Commands .

bEnabled

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

bVisible

Expression booléenne qui spécifie le paramètre Visible pour une commande. Si le paramètre a la valeur True, la commande est visible dans le menu contextuel du caractère (si la propriété Caption est également définie).

ulHelpID

Numéro de contexte de la rubrique d’aide associée à l’objet Command ; permet de fournir une aide contextuelle pour la commande.

dwRefID

ID d’une commande utilisée comme référence pour l’insertion relative de la nouvelle commande.

dBefore

Expression booléenne qui spécifie où placer la commande. Si ce paramètre a la valeur True, la nouvelle commande est insérée avant la commande référencée ; Si la valeur est False, la nouvelle commande est placée après la commande référencée.

pdwID

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

IAgentCommandsEx::InsertEx étend IAgentCommands::Insert en incluant la propriété HelpContextID . Vous pouvez également définir la propriété à l’aide de IAgentCommandsEx::SetHelpContextID

Voir aussi

IAgentCommandsEx::AddEx, IAgentCommandsEx::SetHelpContextID, IAgentCommands::Add, IAgentCommands::Remove, IAgentCommands::RemoveAll