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 ocorrência 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
| Nome | Valor | Description |
|---|---|---|
| ContinueSkipSelfAndChildren | 0 | Não pressione o teste em relação ao atual Visual ou aos seus descendentes. |
| ContinueSkipChildren | 2 | Pressione o teste em relação ao atual Visual, mas não aos seus descendentes. |
| ContinueSkipSelf | 4 | Não pressione o teste em relação ao teste atual Visual, mas faça um teste contra seus descendentes. |
| Continue | 6 | Teste de clique em relação ao atual Visual e seus descendentes. |
| Stop | 8 | Parar o teste de clique no momento Visual. |
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 faz testes de clique em 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.
Note
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
