Angeben von Regelbedingungen
Das Regelobjektmodell unterstützt die meisten Regelaktionen und -bedingungen. Jedes Rule -Objekt verfügt über eine Actions -Eigenschaft, die die Regelaktionen für diese Regel darstellt, sowie über eine Conditions -Eigenschaft und eine Exceptions -Eigenschaft, die die Bedingungen für diese Regel darstellen. In diesem Thema ist beschrieben, wie das Regelobjektmodell die Regelbedingungen unterstützt.
Regelbedingungen für eine Regel werden durch ein RuleConditions-Auflistungsobjekt dargestellt. Ein RuleConditions-Objekt verfügt über Eigenschaften, die jeder häufig verwendeten Regelbedingung in einer Regel entsprechen. Wenn eine Regel beispielsweise zwei Bedingungen angibt – die Nachricht ist wichtig und der Betreff enthält bestimmte Wörter –, geben die Importance - und Subject-Eigenschaften des RuleConditions-Auflistungsobjekts der Regel entsprechende Regelbedingungsobjekte zurück, die aktiviert sind (RuleCondition.Enabled ist True).
Bedingungen, die in einer Regel nicht angegeben sind, werden im entsprechenden RuleCondition-Objekt nicht aktiviert (RuleCondition.Enabled ist False). Regelbedingungsobjekte werden entweder durch das RuleCondition-Objekt oder benutzerdefinierte Objekte dargestellt, die vom RuleCondition-Objekt abgeleitet sind. Im letzten Beispiel gibt die RuleConditions.Importance-Eigenschaft ein ImportanceRuleCondition-Objekt zurück, und die RuleConditions.Subject-Eigenschaft gibt ein TextRuleCondition-Objekt zurück, das beide vom RuleCondition-Objekt abgeleitet sind. Das RuleCondition-Objekt und seine abgeleiteten Objekte verfügen über die ConditionType-Eigenschaft , die den Typ der Regelbedingung angibt, z. B. gibt ImportanceRuleCondition.ConditionType den Wert olConditionImportance an, und TextRuleCondition.ConditionType gibt olConditionSubject an.
Beachten Sie, dass das Regelobjektmodell teilweise Parität mit dem Assistenten für Regeln und Benachrichtigungen bewahrt. Das bedeutet, dass während Sie mit dem Assistenten Regeln erstellen, die im Assistenten angezeigte Aktionen und Bedingungen angeben, Sie Regeln programmgesteuert erstellen können, die einige, aber nicht alle dieser Aktionen und Bedingungen verwenden. Ein Beispiel für eine Bedingung, die das Regelobjektmodell für Regeln unterstützt, die durch den Assistenten erstellt wurden, jedoch nicht für solche, die durch das Objektmodell erstellt wurden, sind Nachrichten einer bestimmten Vertraulichkeitsstufe. Verwenden Sie den Assistenten, um eine Regel zu erstellen, die Vertraulichkeit als Bedingung angibt.
Mithilfe des Rules-Objektmodells können Sie diese Art von Regel in der Rules-Auflistung auflisten. Für jede Regel in der Rules-Auflistung können Sie deren RuleConditions-Auflistung auflisten und nach einer aktivierten Regelbedingung für die Vertraulichkeit suchen. Im Code bedeutet dies für jede Regel in der Rules-Auflistung , RuleConditions.Item(Index) mithilfe des Index von 1 bis RuleConditions.Count aufzulisten und nach einer aktivierten Bedingung mit RuleCondition.ConditionType gleich olConditionSensitivity zu suchen. Sie können eine solche Regelbedingung auch in einer Regel aktivieren oder deaktivieren. Sie können jedoch nicht programmgesteuert eine Regel erstellen, die die OlConditionSensitivity-Bedingung angibt.
In der folgenden Tabelle sind alle Regelbedingungen aufgeführt, die vom Regel- und Warnungs-Assistenten unterstützt werden, und ob jede Regelbedingung beim Erstellen einer Regel mithilfe des Regelobjektmodells unterstützt wird. Eine Regelbedingung, die in Regeln, die vom Rules-Objektmodell erstellt wurden, nicht unterstützt wird, wird nur für die programmgesteuerte Enumeration und das Aktivieren oder Deaktivieren in vorhandenen Regeln unterstützt, die vom Regel- und Warnungs-Assistenten erstellt wurden. Die Tabelle zeigt auch, ob die Regelbedingung auf Regeln mit den Regeltypen olRuleReceive oder olRuleSend angewendet wird, oder auf beide.
Hinweis Sie können eine Regelbedingung vom Typ olConditionOtherMachine nicht aktivieren oder deaktivieren. Diese Art von Regelbedingung gibt an, dass die Regel nur auf einem bestimmten Computer ausgeführt werden kann, aber der aktuelle Computer nicht dieser Computer ist. Dies geschieht, wenn die Regel auf einem Computer erstellt wird und die Regelbedingung olConditionLocalMachineOnly aktiviert ist, die angibt, dass die Regel nur auf diesem Computer ausgeführt werden kann. In bestimmten Fällen wird OlConditionLocalMachine automatisch festgelegt, aktivieren eine weitere regelbedingung wie olConditionAccount festgelegt ist. Wenn Sie die gleiche Regel auf einem anderen Computer ausführen, zeigt die Regel an, dass die Bedingung OlConditionOtherMachine aktiviert ist.
Bedingung | Konstante in olRuleConditionType | Unterstützt beim programmgesteuerten Erstellen neuer Regeln? | Anwenden auf olRuleReceive-Regeln? | Anwenden auf olRuleSend-Regeln? |
---|---|---|---|---|
Konto ist das in AccountRuleCondition.Account angegebene Konto. | olConditionAccount | Ja | Ja | Ja |
Der Nachricht wird jede Kategorie zugewiesen. | olConditionAnyCategory | Ja | Ja | Ja |
Nachrichtentext enthält in TextRuleCondition.Text angegebene Wörter. | olConditionBody | Ja | Ja | Ja |
Nachrichtentext oder Betreff enthält Wörter vom angegebenen TextRuleCondition.Text. | olConditionBodyOrSubject | Ja | Ja | Ja |
Der Nachricht wird die kategorie(n) zugewiesen, die in CategoryRuleCondition.Categories angegeben sind. | olConditionCategory | Ja | Ja | Ja |
Im Feld Cc der Nachricht ist mein Name enthalten. | olConditionCc | Ja | Ja | |
Nachricht wurde zwischen x und y empfangen, wobei x und y ganzzahlige Werte sind. | olConditionDateRange | Nein | Ja | Ja |
Nachricht ist für die angegebene Aktion gekennzeichnet. | olConditionFlaggedForAction | Nein | Ja | Ja |
Für die Nachricht wird das in FormNameRuleCondition.FormName angegebene Formular verwendet. | olConditionFormName | Ja | Ja | Ja |
Absender befindet sich in der in ToOrFromRuleCondition.Recipients angegebenen Empfängerliste. | olConditionFrom | Ja | Ja | Nein |
Nachricht wird aus einem beliebigen RSS-Abonnement generiert. | olConditionFromAnyRssFeed | Ja | Ja | Nein |
Nachricht wird aus einem angegebenen RSS-Abonnement generiert. | olConditionFromRssFeed | Ja | Ja | Nein |
Nachricht enthält eine Anlage. | olConditionHasAttachment | Ja | Ja | Ja |
Nachricht ist mit der angegebenen Wichtigkeitsstufe gekennzeichnet. | olConditionImportance | Ja | Ja | Ja |
Regel kann nur auf diesem Computer ausgeführt werden. | olConditionLocalMachineOnly | Ja | Ja | Ja |
Nachricht ist eine Einladung zu einer Besprechung oder eine Aktualisierung. | olConditionMeetingInviteOrUpdate | Ja | Ja | Ja |
Kopfzeile der Nachricht enthält in TextRuleCondition.Text angegebene Wörter. | olConditionMessageHeader | Ja | Ja | Nein |
Im Feld An der Nachricht ist mein Name nicht enthalten. | olConditionNotTo | Ja | Ja | Nein |
Nachricht wird nur an mich gesendet. | olConditionOnlyToMe | Ja | Ja | Nein |
Nachricht ist eine Abwesenheitsnachricht. | olConditionOOF | Nein | Ja | Nein |
Regel kann nur auf einem bestimmten Computer ausgeführt werden, bei dem es sich nicht um den aktuellen Computer handelt. | olConditionOtherMachine | Nein | Ja | Ja |
Dokumenteigenschaft entspricht genau den angegebenen Eigenschaften, enthält oder enthält nicht die angegebenen Eigenschaften. | olConditionProperty | Nein | Ja | Ja |
Empfängeradresse enthält in TextRuleCondition.Text angegebene Wörter. | olConditionRecipientAddress | Ja | Ja | Ja |
Absenderadresse enthält in TextRuleCondition.Text angegebene Wörter. | olConditionSenderAddress | Ja | Ja | Nein |
Absender befindet sich in der in AddressRuleCondition.Address angegebenen Adressliste. | olConditionSenderInAddressBook | Ja | Ja | Nein |
Nachricht ist mit der angegebenen Vertraulichkeitsstufe gekennzeichnet. | olConditionSensitivity | Nein | Ja | Ja |
Gesendet an Empfänger (An, Cc) befinden sich in der in ToOrFromRuleCondition.Recipients angegebenen Empfängerliste. | olConditionSentTo | Ja | Ja | Ja |
Nachrichtengröße liegt zwischen x und y in Einheiten zu KB, wobei x und y Date-Werte sind. Beispielsweise legt "10;50" die Größenbedingung zwischen 10 und 50 KB fest. | olConditionSizeRange | Nein | Ja | Ja |
Betreff enthält in TextRuleCondition.Text angegebene Wörter. | olConditionSubject | Ja | Ja | Ja |
Mein Name befindet sich im Feld An. | olConditionTo | Ja | Ja | Nein |
Im Feld An oder im Feld Cc der Nachricht ist mein Name enthalten. | olConditionToOrCc | Ja | Ja | Nein |
Unbekannte Regelbedingung. | olConditionUnknown | Nein | Ja | Nein |
Support und Feedback
Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.