HitTestFilterBehavior HitTestFilterBehavior HitTestFilterBehavior HitTestFilterBehavior Enum

Definition

Gibt das Rückgabeverhalten eines Treffertests in einer Treffertest-Filterrückrufmethode an.Specifies the return behavior of a hit test in a hit test filter callback method.

public enum class HitTestFilterBehavior
public enum HitTestFilterBehavior
type HitTestFilterBehavior = 
Public Enum HitTestFilterBehavior
Vererbung
HitTestFilterBehaviorHitTestFilterBehaviorHitTestFilterBehaviorHitTestFilterBehavior

Felder

Continue Continue Continue Continue 6

Treffertest für das aktuelle Visual und seine Nachfolger.Hit test against the current Visual and its descendants.

ContinueSkipChildren ContinueSkipChildren ContinueSkipChildren ContinueSkipChildren 2

Treffertest für das aktuelle Visual, jedoch nicht für seine Nachfolger.Hit test against the current Visual, but not its descendants.

ContinueSkipSelf ContinueSkipSelf ContinueSkipSelf ContinueSkipSelf 4

Kein Treffertest für das aktuelle Visual, jedoch für seine Nachfolger.Do not hit test against the current Visual, but hit test against its descendants.

ContinueSkipSelfAndChildren ContinueSkipSelfAndChildren ContinueSkipSelfAndChildren ContinueSkipSelfAndChildren 0

Kein Treffertest für das aktuelle Visual und seine Nachfolger.Do not hit test against the current Visual or its descendants.

Stop Stop Stop Stop 8

Beendet den Treffertest beim aktuellen Visual.Stop hit testing at the current Visual.

Beispiele

Das folgende Beispiel zeigt, wie Sie zurückgeben einer ContinueSkipSelfAndChildren Wert aus einer Treffertest-Filterrückrufmethode.The following example shows how to return a ContinueSkipSelfAndChildren value from a hit test filter callback method. In diesem Fall überspringt der Filter Bezeichnungen und ihre Nachfolgerelemente und alle anderen Elemente Treffertests.In this case, the filter skips labels and their descendants and hit tests everything else.

// 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

Hinweise

Der Rückgabewert der Treffertestfilter-Rückruf ist ein HitTestFilterBehavior, die bestimmt, welche Art von Aktion beim Verarbeiten der visuellen Struktur für Treffertests entnommen werden sollen.The return value of the hit test filter callback is a HitTestFilterBehavior, which determines what type of action should be taken when processing the visual tree for hit testing. Wenn Ihre Treffertestfilter-Rückrufs ContinueSkipSelfAndChildren, den Wert zurückgeben können Sie beispielsweise das aktuelle visuelle Objekt und seine Nachfolger aus der Auswertung der Treffertestergebnisse entfernen.For example, if your hit test filter callback return the value, ContinueSkipSelfAndChildren, you can remove the current visual object and its descendants from the hit test results evaluation.

Hinweis

Reduzieren der Verzweigungen in der visuellen Struktur von Objekten verringert die Menge der Verarbeitung, die während der Treffertest Ergebnisse Auswertungsübergabe erforderlich ist.Pruning the visual tree of objects decreases the amount of processing that is required during the hit test results evaluation pass.

Verzweigen einer visuellen Struktur mit einem TreffertestfilterPruning a visual tree using a hit test filter
Reduzieren der Verzweigungen in einer visuellen StrukturPruning a visual tree

Gilt für: