Spécification d’actions de règle

Le modèle objet Rules prend en charge les actions et les conditions de règle les plus courantes. Chaque objet Rule possède une propriété Actions qui représente les actions de règle pour cette règle, ainsi qu’une propriété Conditions et une propriété Exceptions qui représentent les conditions de cette règle. Cette rubrique explique comment le modèle objet Rules prend en charge les actions de règle.

Les actions de règle pour une règle sont représentées par un objet de collection RuleActions . Un objet RuleActions comporte des propriétés qui correspondent à chaque action couramment utilisée dans une règle. Par exemple, si une règle spécifie deux actions : déplacer le message vers un dossier spécifique et lire un son, les propriétés MoveToFolder et PlaySound de l’objet de collection RuleActions de la règle retournent les objets d’action de règle respectifs qui sont activés (RuleAction.Enabled a la valeur True).

Les actions qui ne sont pas spécifiées dans une règle ne seront pas activées dans l’objet RuleAction correspondant (RuleAction.Enabled avec la valeur False). Ces objets d’action de règle sont représentés par l’objet \ RuleAction ou par des objets personnalisés dérivés de l’objet RuleAction . Dans le dernier exemple, plus précisément, la propriété RuleActions.MoveToFolder renvoie un objet MoveOrCopyRuleAction , et la propriété RuleActions.PlaySound renvoie un objet PlaySoundRuleAction , tous deux dérivés de l’objet RuleAction . L’objet RuleAction et ses objets dérivés comportent la propriété ActionType qui indiquent le type de l’action. Par exemple, MoveOrCopyRuleAction.ActionType indique la valeur olRuleActionMoveToFolder et PlaySoundRuleAction.ActionType indique olRuleActionPlay.

Remarque

Le modèle objet Rules maintient une parité partielle avec l’Assistant Règles et alertes. Cela signifie que s’il est possible d’utiliser l’Assistant pour créer des règles qui spécifient les actions et les conditions que vous voyez dans ce dernier, vous pouvez créer par programme des règles qui utilisent certaines de ces actions et conditions, mais pas toutes. En guise d’exemple d’action que le modèle objet Rules prend en charge pour les règles créées par l’Assistant mais pas pour celles créées par le modèle objet, on peut citer le fait de demander une réponse du serveur. Utilisez l’Assistant pour créer une règle spécifiant une réponse de serveur spécifique en tant qu’action.

À l’aide du modèle objet Rules, vous pouvez énumérer ces types de règles dans la collection Rules : pour chaque règle de la collection Rules , énumérez sa collection RuleActions et recherchez une action de règle activée pour une réponse de serveur. Dans le code, cela signifie pour chaque règle de la collection Rules , énumérer RuleActions.Item(Index) à l’aide de l’index de 1 à RuleActions.Count, et rechercher une action activée avec ActionType égal à olRuleActionServerReply. Vous pouvez également activer ou désactiver une action de ce type dans une règle. Toutefois, vous ne pouvez pas créer par programmation une règle qui spécifie l’action olRuleActionServerReply .

Le tableau suivant répertorie toutes les actions de règle prises en charge par l’Assistant Règles et alertes, et indique si chaque action de règle est prise en charge lors de la création d’une règle à l’aide du modèle objet Règles. Une action de règle qui n’est pas prise en charge dans les règles créées par le modèle objet Règles est prise en charge uniquement pour l’énumération programmatique et l’activation ou la désactivation dans les règles existantes créées par l’Assistant Règles et alertes. Ce tableau indique également si l’action s’applique aux règles de type olRuleReceive ou olRuleSend ou aux deux.

Action	Constante dans olRuleActionType	Prise en charge lors la création de règles par programme	Appliquer aux règles olRuleReceive	Appliquer aux règles olRuleSend
Affecter le message aux catégories spécifiées dans la propriété AssignToCategoryRuleAction.Categories	olRuleActionAssignToCategory	Oui	Oui	Oui
Copiez le message dans la liste de destinataires spécifiée dans la propriété SendRuleAction.Recipients	olRuleActionCcMessage	Oui	Non	Oui
Supprimer toutes les catégories pour le message	olRuleActionClearCategories	Oui	Oui	Oui
Copiez le message dans le dossier spécifié dans la propriété MoveOrCopyRuleAction.Folder	olRuleActionCopyToFolder	Oui	Oui	Oui
Exécuter une action personnalisée	olRuleActionCustomAction	Non	Oui	Oui
Différer la remise d’un nombre de minutes spécifié	olRuleActionDefer	Non	Non	Oui
Supprimer le message	olRuleActionDelete	Oui	Oui	Non
Supprimer le message définitivement	olRuleActionDeletePermanently	Oui	Oui	Non
Afficher une alerte sur le Bureau	olRuleActionDesktopAlert	Oui	Oui	Non
Effacer l’indicateur de message	olRuleActionFlagClear	Non	Oui	Non
Marquer le message avec la couleur spécifiée	olRuleActionFlagColor	Non	Oui	Non
Marquer le message qui doit être suivi d’une action dans les jours spécifiés	olRuleActionFlagForActionInDays	Non	Oui	Oui
Transmettre le message à la liste de destinataires spécifiée dans la propriété SendRuleAction.Recipients	olRuleActionForward	Oui	Oui	Non
Transmettre le message en tant que pièce jointe à la liste de destinataires spécifiée dans la propriété SendRuleAction.Recipients	olRuleActionForwardAsAttachment	Oui	Oui	Non
Marquer le message avec l’importance spécifiée	olRuleActionImportance	Non	Oui	Oui
Marquer le message en tant que tâche de suivi à l’aide des propriétés FlagTo et MarkInterval de l’objet MarkAsTaskRuleAction	olRuleActionMarkAsTask	Oui	Oui	Non
Marquer comme lu	olRuleActionMarkRead	Non	Oui	Non
Déplacer le message vers le dossier spécifié dans la propriété oveOrCopyRuleAction.Folder	olRuleActionMoveToFolder	Oui	Oui	Non
Afficher le message spécifié dans la propriété NewItemAlertRuleAction.Text	olRuleActionNewItemAlert	Oui	Oui	Non
Signaler que le message a été remis	olRuleActionNotifyDelivery	Oui	Non	Oui
Signaler que le message a été lu	olRuleActionNotifyRead	Oui	Non	Oui
Lire le fichier .wav spécifié dans la propriété PlaySoundRuleAction.FilePath	olRuleActionPlaysound	Oui	Oui	Non
Imprimer le message sur l’imprimante par défaut	olRuleActionPrint	Non	Oui	Non
Rediriger le message vers la liste de destinataires spécifiée dans la propriété SendRuleAction.Recipients	olRuleActionRedirect	Oui	Oui	Non
Démarrer un script	olRuleActionRunScript	Non	Oui	Non
Marquer le message avec la sensibilité spécifiée	olRuleActionSensitivity	Non	Non	Oui
Utiliser le message spécifié dans la réponse du serveur	olRuleActionServerReply	Non	Oui	Non
Démarrer un .exe	olRuleActionStartApplication	Non	Oui	Non
Ne plus traiter de règles	olRuleActionStop	Oui	Oui	Oui
Répondre à l’aide du fichier de modèle (.oft) spécifié	olRuleActionTemplate	Non	Oui	Non
Action de règle inconnue	olRuleActionUnknown	Non	Oui	Non

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.