StrokeCollection.GetIncrementalStrokeHitTester(StylusShape) Metoda

Definicja

Przestrzeń nazw:

System.Windows.Ink

Zestaw:

PresentationCore.dll

Tworzy element IncrementalStrokeHitTester , który sprawdza, StrokeCollection czy element ma ścieżkę wymazywania.

public:
 System::Windows::Ink::IncrementalStrokeHitTester ^ GetIncrementalStrokeHitTester(System::Windows::Ink::StylusShape ^ eraserShape);

public System.Windows.Ink.IncrementalStrokeHitTester GetIncrementalStrokeHitTester (System.Windows.Ink.StylusShape eraserShape);

member this.GetIncrementalStrokeHitTester : System.Windows.Ink.StylusShape -> System.Windows.Ink.IncrementalStrokeHitTester

Public Function GetIncrementalStrokeHitTester (eraserShape As StylusShape) As IncrementalStrokeHitTester

Parametry

eraserShape

StylusShape

Element StylusShape określający końcówkę rysika.

Zwraca

IncrementalStrokeHitTester

Element IncrementalStrokeHitTester , który trafi, testuje element StrokeCollection.

Przykłady

W poniższym przykładzie pokazano, jak uzyskać element IncrementalStrokeHitTester , którego można użyć do wymazania części obiektu Stroke. Aby utworzyć kontrolkę, która umożliwia użytkownikowi wymazywanie pisma odręcznego, zobacz How to: Erase Ink on a Custom Control (Instrukcje: wymazywanie pisma odręcznego w kontrolce niestandardowej).

// Prepare to collect stylus packets. Get the 
// IncrementalHitTester from the InkPresenter's 
// StrokeCollection and subscribe to its StrokeHitChanged event.
protected override void OnStylusDown(StylusDownEventArgs e)
{
    base.OnStylusDown(e);

    EllipseStylusShape eraserTip = new EllipseStylusShape(3, 3, 0);
    eraseTester = 
        presenter.Strokes.GetIncrementalStrokeHitTester(eraserTip);
    eraseTester.StrokeHit += new StrokeHitEventHandler(eraseTester_StrokeHit);
    eraseTester.AddPoints(e.GetStylusPoints(this));
}

' Prepare to collect stylus packets. Get the 
' IncrementalHitTester from the InkPresenter's 
' StrokeCollection and subscribe to its StrokeHitChanged event.
Protected Overrides Sub OnStylusDown(ByVal e As StylusDownEventArgs)

    MyBase.OnStylusDown(e)

    Dim eraserTip As New EllipseStylusShape(3, 3, 0)
    eraseTester = presenter.Strokes.GetIncrementalStrokeHitTester(eraserTip)
    AddHandler eraseTester.StrokeHit, _
        AddressOf eraseTester_StrokeHit
    eraseTester.AddPoints(e.GetStylusPoints(Me))

End Sub

Uwagi

Metoda GetIncrementalStrokeHitTester zwraca wartość IncrementalStrokeHitTester , która uznaje element za Stroke "trafiony", gdy ścieżka gumki przecina ją. Jest to przydatne w przypadku implementowania funkcji, takich jak możliwość wymazania części elementu Stroke. Właściwość InkCanvas używa IncrementalStrokeHitTester elementu , gdy właściwość jest ustawiona EditingMode na EraseByPointwartość .