Propriedade ValidationRule.TestExpression (Visio)

Obtém ou define a expressão lógica que determina se o objeto de destino satisfaz a regra de validação. Leitura/gravação.

Sintaxe

expression. TestExpression

Expressão Uma variável que representa um objeto ValidationRule .

Valor de retorno

String

Comentários

Ao validar um diagrama chamando o método Validar ou clicando em Verificar Diagrama na guia Processo , o Microsoft Visio usa a expressão de teste que você define como o valor da propriedade TestExpression para determinar se o objeto de destino satisfaz a regra de validação. Se a expressão de teste for avaliada como Falso, o Visio gerará uma questão de validação. Se a expressão de teste for avaliada como True, nenhum problema de validação será gerado.

O Visio avalia a expressão de teste para objetos de destino somente quando o valor da propriedade FilterExpression do objeto ValidationRule é avaliado como True.

A sintaxe do valor da propriedade TestExpression é igual à de uma expressão ShapeSheet. Quando você define o valor da propriedade TestExpression, o Visio não verifica a sintaxe da expressão de teste. Se a expressão de teste não estiver sintaticamente correta, a avaliação da expressão falhará durante a validação e o Visio gerará uma questão de validação nesse momento.

Exemplo

O exemplo de VBA (Visual Basic for Applications) a seguir mostra como usar a propriedade TestExpression para determinar se um destino de forma específico satisfaz uma regra de validação.

' 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"

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.