Auf Englisch lesen

Freigeben über


ValidationRule.TestExpression-Eigenschaft (Visio)

Ruft den logischen Ausdruck ab, mit dem bestimmt wird, ob das Zielobjekt der Überprüfungsregel entspricht, oder legt diesen fest. Lese-/Schreibzugriff.

Syntax

Ausdruck. TestExpression

Ausdruck Eine Variable, die ein ValidationRule-Objekt darstellt.

Rückgabewert

String

Hinweise

Wenn Sie ein Diagramm überprüfen, indem Sie die Validate-Methode aufrufen oder auf der Registerkarte Prozess auf Diagramm überprüfen klicken, verwendet Microsoft Visio den Testausdruck, den Sie als TestExpression-Eigenschaftswert festlegen, um zu bestimmen, ob das Zielobjekt die Validierungsregel erfüllt. Wird der Testausdruck als False ausgewertet, generiert Visio einen Überprüfungsproblem. Wenn der Testausdruck als True ausgewertet wird, wird kein Validierungsproblem generiert.

Visio wertet den Testausdruck nur dann für Zielobjekte aus, wenn der Wert der FilterExpression-Eigenschaft des ValidationRule-Objekts als True ausgewertet wird.

Die Syntax für den TestExpression-Eigenschaftswert entspricht der Syntax für einen ShapeSheet-Ausdruck. Wenn Sie den TestExpression-Eigenschaftswert festlegen, überprüft Visio die Syntax des Testausdrucks nicht. Wenn der Testausdruck syntaktisch nicht korrekt ist, schlägt die Auswertung des Ausdrucks während der Überprüfung fehl, und Visio generiert zu diesem Zeitpunkt ein Validierungsproblem.

Beispiel

Im folgenden beispiel für Visual Basic for Applications (VBA) wird gezeigt, wie die TestExpression-Eigenschaft verwendet wird, um zu bestimmen, ob ein bestimmtes Shape-Ziel eine Validierungsregel erfüllt.

' Add a validation rule to the document.
Set vsoValidationRule = vsoValidationRuleSet.Rules.Add("Unglued2DShape")
vsoValidationRule.Category = "Shapes"
vsoValidationRule.Description = "This 2-dimensional shape is not connected to
any other shape."
vsoValidationRule.Ignored = False
vsoValidationRule.TargetType = Visio.VisRuleTargets.visRuleTargetShape

' The validation function Is1D() returns a Boolean value that indicates 
' whether the shape is 1D (True) or 2D (False).
vsoValidationRule.FilterExpression = "NOT(Is1D())"

' The validation function GLUEDSHAPES returns a set of 
' shapes glued to the shape.
' It takes as input one parameter that indicates the direction of the glue.
' The direction values are equivalent to members of VisGluedShapesFlags:
' 0 = visGluedShapesAll1D, and 3 = visGluedShapesAll2D
' It takes as input one parameter indicating the direction of the glue.

' The validation function AGGCOUNT takes a set of shapes as its input, and 
' returns the number of shapes in the set.
vsoValidationRule.TestExpression = "AGGCOUNT(GLUEDSHAPES(0)) + AGGCOUNT(GLUEDSHAPES(3)) > 0"

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.