GeometryHitTestParameters Kelas

Definisi

Ruang nama:

System.Windows.Media

Rakitan:

PresentationCore.dll

Geometry Menentukan sebagai parameter yang akan digunakan untuk menguji pohon visual.

public ref class GeometryHitTestParameters : System::Windows::Media::HitTestParameters

public class GeometryHitTestParameters : System.Windows.Media.HitTestParameters

type GeometryHitTestParameters = class
    inherit HitTestParameters

Public Class GeometryHitTestParameters
Inherits HitTestParameters

Warisan

Object

HitTestParameters

GeometryHitTestParameters

Contoh

Contoh berikut menunjukkan cara menyiapkan pengujian hit menggunakan GeometryHitTestParameters untuk metode .HitTest Nilai Point yang diteruskan ke OnMouseDown metode digunakan untuk membuat Geometry objek untuk memperluas rentang pengujian hit.

// Respond to the mouse button down event by setting up a hit test results callback.
private void OnMouseDown(object sender, MouseButtonEventArgs e)
{
    // Retrieve the coordinate of the mouse position.
    Point pt = e.GetPosition((UIElement)sender);

    // Expand the hit test area by creating a geometry centered on the hit test point.
    EllipseGeometry expandedHitTestArea = new EllipseGeometry(pt, 10.0, 10.0);

    // Clear the contents of the list used for hit test results.
    hitResultsList.Clear();

    // Set up a callback to receive the hit test result enumeration.
    VisualTreeHelper.HitTest(myControl, null,
        new HitTestResultCallback(MyHitTestResultCallback),
        new GeometryHitTestParameters(expandedHitTestArea));

    // Perform actions on the hit test results list.
    if (hitResultsList.Count > 0)
    {
        ProcessHitTestResultsList();
    }
}

' Respond to the mouse button down event by setting up a hit test results callback.
Private Overloads Sub OnMouseDown(ByVal sender As Object, ByVal e As MouseButtonEventArgs)
    ' Retrieve the coordinate of the mouse position.
    Dim pt As Point = e.GetPosition(CType(sender, UIElement))

    ' Expand the hit test area by creating a geometry centered on the hit test point.
    Dim expandedHitTestArea As New EllipseGeometry(pt, 10.0, 10.0)

    ' Clear the contents of the list used for hit test results.
    hitResultsList.Clear()

    ' Set up a callback to receive the hit test result enumeration.
    VisualTreeHelper.HitTest(myControl, Nothing, New HitTestResultCallback(AddressOf MyHitTestResultCallback), New GeometryHitTestParameters(expandedHitTestArea))

    ' Perform actions on the hit test results list.
    If hitResultsList.Count > 0 Then
        ProcessHitTestResultsList()
    End If
End Sub

Properti IntersectionDetail dari GeometryHitTestResult memberikan informasi tentang hasil tes Geometry hit yang menggunakan sebagai parameter uji hit. Ilustrasi berikut menunjukkan hubungan antara geometri uji hit (lingkaran biru) dan objek target (persegi merah).

Persimpangan antara geometri uji tekan dan objek target

Keterangan

GeometryHitTestParameters Dengan kelas , Anda dapat menggunakan Geometry nilai untuk pengujian hit, untuk menentukan apakah ada objek visual yang bersinggungan Geometry dengan nilai .

Anda juga dapat mencapai pengujian dengan nilai dengan Point membuat PointHitTestParameters objek.

Nota

Pengujian hit Windows Presentation Foundation (WPF) hanya mempertimbangkan area geometri yang diisi selama tes hit. Jika Anda membuat titik Geometry, tes hit tidak akan bersinggungan apa pun karena titik tidak memiliki area.

Konstruktor

Nama	Deskripsi
GeometryHitTestParameters(Geometry)	Menginisialisasi instans GeometryHitTestParameters baru kelas, menggunakan Geometry.

Properti

Nama	Deskripsi
HitGeometry	Mendapatkan yang mendefinisikan geometri pengujian hit untuk instans Geometry ini GeometryHitTestParameters .