Stroke.HitTest 方法

參考

定義

命名空間:: System.Windows.Ink

組件:: PresentationCore.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

傳回值，指出 Stroke 是否與特定區域交集或在特定區域內部。

多載

HitTest(Point)	傳回值，指出目前 Stroke 是否與指定點交集。
HitTest(IEnumerable<Point>, Int32)	傳回值，指出目前 Stroke 是否在特定界限內。
HitTest(IEnumerable<Point>, StylusShape)	傳回指定路徑是否使用指定的 Stroke 與 StylusShape 交集。
HitTest(Point, Double)	傳回值，指出目前 Stroke 是否與指定區域交集。
HitTest(Rect, Int32)	傳回值，指出 Stroke 是否位於指定矩形的界限內。

備註

您可以使用 HitTest 方法來判斷 Stroke 是否與特定點交集，或是在指定的界限內。

下列方法會檢查是否 Stroke 交集。

下列方法會檢查是否 Stroke 括住。

HitTest(Point)

傳回值，指出目前 Stroke 是否與指定點交集。

public:
 bool HitTest(System::Windows::Point point);

public bool HitTest (System.Windows.Point point);

member this.HitTest : System.Windows.Point -> bool

Public Function HitTest (point As Point) As Boolean

參數

point: Point

要進行點擊測試的 Point。

傳回

Boolean

如果 point 與目前筆劃交集，則為 true，否則為 false。

範例

如果它與特定區域交集，下列範例會變更的 Stroke 色彩。

Point myPoint = new Point(100, 100);

if (myStroke.HitTest(myPoint, 10))
{
    myStroke.DrawingAttributes.Color = Colors.Red;
}

Dim myPoint As New System.Windows.Point(100, 100)

If myStroke.HitTest(myPoint, 10) Then
    myStroke.DrawingAttributes.Color = Colors.Red
End If

備註

這個方法的行為與多載 HitTest(Point, Double) 方法在 1 時 diameter 的行為相同。

適用於

HitTest(IEnumerable<Point>, Int32)

傳回值，指出目前 Stroke 是否在特定界限內。

public:
 bool HitTest(System::Collections::Generic::IEnumerable<System::Windows::Point> ^ lassoPoints, int percentageWithinLasso);

public bool HitTest (System.Collections.Generic.IEnumerable<System.Windows.Point> lassoPoints, int percentageWithinLasso);

member this.HitTest : seq<System.Windows.Point> * int -> bool

Public Function HitTest (lassoPoints As IEnumerable(Of Point), percentageWithinLasso As Integer) As Boolean

參數

lassoPoints: IEnumerable<Point>

Point 型別的陣列，表示要進行點擊測試的區域界限。

percentageWithinLasso: Int32

Stroke 長度的百分比，必須在 lassoPoints 內這樣 Stroke 才會被視為已點擊。

傳回

Boolean

如果目前筆劃在指定界限內，則為 true，否則為 false。

範例

如果至少 80% 的筆劃在的界限 myPoints 內，下列範例會轉譯紫色的筆劃。

Point[] myPoints = new Point[] {
    new Point(100, 100),
    new Point(200, 100),
    new Point(200, 200),
    new Point(100, 200)};

if (aStroke.HitTest(myPoints, 80))
{
    aStroke.DrawingAttributes.Color = Colors.Purple;
}

Dim myPoints() As System.Windows.Point = _
                      {New System.Windows.Point(100, 100), _
                       New System.Windows.Point(200, 100), _
                       New System.Windows.Point(200, 200), _
                       New System.Windows.Point(100, 200)}

If aStroke.HitTest(myPoints, 80) Then
    aStroke.DrawingAttributes.Color = Colors.Purple
End If

備註

方法會 HitTest 連接中的 lassoPoints 第一個和最後一個點，以建立套索。

適用於

HitTest(IEnumerable<Point>, StylusShape)

傳回指定路徑是否使用指定的 Stroke 與 StylusShape 交集。

public:
 bool HitTest(System::Collections::Generic::IEnumerable<System::Windows::Point> ^ path, System::Windows::Ink::StylusShape ^ stylusShape);

public bool HitTest (System.Collections.Generic.IEnumerable<System.Windows.Point> path, System.Windows.Ink.StylusShape stylusShape);

member this.HitTest : seq<System.Windows.Point> * System.Windows.Ink.StylusShape -> bool

Public Function HitTest (path As IEnumerable(Of Point), stylusShape As StylusShape) As Boolean

參數

path: IEnumerable<Point>

後續用於點擊測試的路徑 stylusShape 。

stylusShape: StylusShape

要用來點擊測試的 path 圖案。

傳回

Boolean

如果 stylusShape 與目前筆劃交集，則為 true，否則為 false。

範例

如果筆劃與的路徑 myPoints 交集，下列程式碼會呈現紫色的筆劃。

Point[] myPoints = new Point[] {
    new Point(100, 100),
    new	Point(200, 100),
    new	Point(200, 200),
    new	Point(100, 200)};

EllipseStylusShape myStylus = new EllipseStylusShape(5.0, 5.0, 0.0);

if (aStroke.HitTest(myPoints, myStylus))
{
    aStroke.DrawingAttributes.Color = Colors.Purple;
}

Dim myPoints() As System.Windows.Point = _
                      {New System.Windows.Point(100, 100), _
                       New System.Windows.Point(200, 100), _
                       New System.Windows.Point(200, 200), _
                       New System.Windows.Point(100, 200)}

Dim myStylus As New EllipseStylusShape(5.0, 5.0, 0.0)

If aStroke.HitTest(myPoints, myStylus) Then
    aStroke.DrawingAttributes.Color = Colors.Purple
End If

備註

方法 HitTest 會使用 stylusShape 來點擊測試沿著 eraserPath 的筆劃。

適用於

HitTest(Point, Double)

傳回值，指出目前 Stroke 是否與指定區域交集。

public:
 bool HitTest(System::Windows::Point point, double diameter);

public bool HitTest (System.Windows.Point point, double diameter);

member this.HitTest : System.Windows.Point * double -> bool

Public Function HitTest (point As Point, diameter As Double) As Boolean

參數

point: Point

Point，定義要點擊測試的區域中央。

diameter: Double

要點擊測試的區域直徑。

傳回

Boolean

如果指定區域與目前筆劃交集，則為 true，否則為 false。

範例

如果它與特定區域交集，下列範例會變更的 Stroke 色彩。

Point myPoint = new Point(100, 100);

if (myStroke.HitTest(myPoint, 10))
{
    myStroke.DrawingAttributes.Color = Colors.Red;
}

Dim myPoint As New System.Windows.Point(100, 100)

If myStroke.HitTest(myPoint, 10) Then
    myStroke.DrawingAttributes.Color = Colors.Red
End If

適用於

HitTest(Rect, Int32)

傳回值，指出 Stroke 是否位於指定矩形的界限內。

public:
 bool HitTest(System::Windows::Rect bounds, int percentageWithinBounds);

public bool HitTest (System.Windows.Rect bounds, int percentageWithinBounds);

member this.HitTest : System.Windows.Rect * int -> bool

Public Function HitTest (bounds As Rect, percentageWithinBounds As Integer) As Boolean

參數

bounds: Rect

Rect，表示要點擊測試的區域界限。

percentageWithinBounds: Int32

Stroke 長度的百分比，必須在 percentageWithinBounds 內這樣 Stroke 才會被視為已點擊。

傳回

Boolean

如果目前筆劃位於 bounds 的界限內，則為 true；否則為 false。

範例

如果筆劃中至少有 80% 的筆劃位於內 Rect ，下列範例會呈現紫色筆劃。

Rect rect1 = new Rect(100, 100, 100, 100);

if (aStroke.HitTest(rect1, 80))
{
    aStroke.DrawingAttributes.Color = Colors.Purple;
}

Dim rect1 As New Rect(100, 100, 100, 100)

If aStroke.HitTest(rect1, 80) Then
    aStroke.DrawingAttributes.Color = Colors.Purple
End If

適用於