HitTestFilterBehavior Enum

Definisi

Menentukan perilaku pengembalian uji hit dalam metode panggilan balik filter uji.

public enum class HitTestFilterBehavior
public enum HitTestFilterBehavior
type HitTestFilterBehavior = 
Public Enum HitTestFilterBehavior
Warisan
HitTestFilterBehavior

Bidang

Continue 6

Tekan uji terhadap arus Visual dan keturunannya.

ContinueSkipChildren 2

Tekan uji terhadap saat ini Visual, tetapi bukan keturunannya.

ContinueSkipSelf 4

Jangan menekan uji terhadap saat ini Visual, tetapi tekan uji terhadap keturunannya.

ContinueSkipSelfAndChildren 0

Jangan tekan uji terhadap arus Visual atau keturunannya.

Stop 8

Hentikan pengujian pada saat ini Visual.

Contoh

Contoh berikut menunjukkan cara mengembalikan HitTestFilterBehavior nilai dari metode panggilan balik filter uji. Dalam hal ini, filter melompati label dan keturunannya dan menekan pengujian segala sesuatu yang lain.

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

Keterangan

Nilai yang dikembalikan dari panggilan balik filter uji hit adalah HitTestFilterBehavior, yang menentukan jenis tindakan apa yang harus diambil saat memproses pohon visual untuk pengujian hit. Misalnya, jika panggilan balik filter uji hit Anda mengembalikan nilai ContinueSkipSelfAndChildren, Anda dapat menghapus objek visual saat ini dan turunannya dari evaluasi hasil pengujian hit.

Catatan

Pemangkasan pohon visual objek mengurangi jumlah pemrosesan yang diperlukan selama lulus evaluasi hasil pengujian hit.

Memangkas pohon visual menggunakan filter uji hit
Memangkas pohon visual

Berlaku untuk