HitTestFilterBehavior Enumeração
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
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.
Podar uma árvore visual