HitTestFilterBehavior Enumeração

Definição

Especifica o comportamento de retorno de um teste de acerto num método de chamada de filtro de teste de sucesso.

public enum class HitTestFilterBehavior
public enum HitTestFilterBehavior
type HitTestFilterBehavior = 
Public Enum HitTestFilterBehavior
Herança
HitTestFilterBehavior

Campos

Name Valor Description
ContinueSkipSelfAndChildren 0

Não faça teste contra a corrente Visual ou os seus descendentes.

ContinueSkipChildren 2

Teste de acerto contra a corrente Visual, mas não contra os seus descendentes.

ContinueSkipSelf 4

Não faça teste contra a corrente Visual, mas sim contra os seus descendentes.

Continue 6

Teste contra a corrente Visual e os seus descendentes.

Stop 8

Pare de fazer testes de acerto na atualidade Visual.

Exemplos

O exemplo seguinte mostra como devolver um HitTestFilterBehavior valor de um método de callback de filtro de teste de acerto. Neste caso, o filtro salta rótulos e os seus descendentes e faz testes de sucesso a tudo o resto.

// Filter the hit test values for each object in the enumeration.
public HitTestFilterBehavior MyHitTestFilter(DependencyObject o)
{
    // Test for the object value you want to filter.
    if (o.GetType() == typeof(Label))
    {
        // Visual object and descendants are NOT part of hit test results enumeration.
        return HitTestFilterBehavior.ContinueSkipSelfAndChildren;
    }
    else
    {
        // Visual object is part of hit test results enumeration.
        return HitTestFilterBehavior.Continue;
    }
}
' Filter the hit test values for each object in the enumeration.
Public Function MyHitTestFilter(ByVal o As DependencyObject) As HitTestFilterBehavior
    ' Test for the object value you want to filter.
    If o.GetType() Is GetType(Label) Then
        ' Visual object and descendants are NOT part of hit test results enumeration.
        Return HitTestFilterBehavior.ContinueSkipSelfAndChildren
    Else
        ' Visual object is part of hit test results enumeration.
        Return HitTestFilterBehavior.Continue
    End If
End Function

Observações

O valor de retorno do callback do filtro do teste de acerto é um HitTestFilterBehavior, que determina que tipo de ação deve ser tomada ao processar a árvore visual para o teste de acertos. Por exemplo, se o callback do filtro do teste de acerto devolver o valor ContinueSkipSelfAndChildren, pode remover o objeto visual atual e os seus descendentes da avaliação dos resultados do teste de acerto.

Note

A poda da árvore visual de objetos diminui a quantidade de processamento necessária durante a avaliação dos resultados do teste de acerto.

Poda de uma árvore visual usando um filtro de teste de impacto
Podar uma árvore visual

Aplica-se a