HitTestFilterBehavior Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 HitTestFilterBehaviorpublic enum HitTestFilterBehaviortype HitTestFilterBehavior = Public Enum HitTestFilterBehavior- Herança
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