HitTestFilterBehavior Enumeração

Definição

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

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

Object

ValueType

Enum

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