Compartilhar via


HitTestFilterBehavior Enumeração

Definição

Especifica o comportamento de retorno de um teste de clique em um método de retorno de chamada de filtro de teste de clique.

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

Campos

Continue 6

Realiza o teste de clique com relação ao Visual atual e seus descendentes.

ContinueSkipChildren 2

Realiza o teste de clique com relação ao Visual atual, mas não seus descendentes.

ContinueSkipSelf 4

Não faz teste de clique com relação ao Visual atual, mas faz teste de clique em relação aos seus descendentes.

ContinueSkipSelfAndChildren 0

Não faz teste de clique com relação ao Visual atual ou seus descendentes.

Stop 8

Interromper teste de clique no Visual atual.

Exemplos

O exemplo a seguir mostra como retornar um HitTestFilterBehavior valor de um método de retorno de chamada de filtro de teste de clique. Nesse caso, o filtro ignora rótulos e seus descendentes e o hit testa todo 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

Comentários

O valor retornado do retorno de chamada do filtro de teste de ocorrência é um HitTestFilterBehavior, que determina que tipo de ação deve ser tomada ao processar a árvore visual para teste de ocorrência. Por exemplo, se o retorno de chamada do filtro de teste de clique retornar o valor ContinueSkipSelfAndChildren, você poderá remover o objeto visual atual e seus descendentes da avaliação de resultados do teste de clique.

Observação

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

Aparando uma árvore visual usando um filtro de teste de clique
Aparando uma árvore visual

Aplica-se a