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.