Ink.NearestPoint-Methode (Point)

Artikel
11/26/2008

Gibt das Stroke-Objekt innerhalb des Ink-Objekts zurück, das die kürzeste Entfernung zu dem in Freihandbereichkoordinaten angegebenen Point hat.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Function NearestPoint ( _
    point As Point _
) As Stroke
'Usage
Dim instance As Ink
Dim point As Point
Dim returnValue As Stroke

returnValue = instance.NearestPoint(point)

public Stroke NearestPoint(
    Point point
)

public:
Stroke^ NearestPoint(
    Point point
)

public Stroke NearestPoint(
    Point point
)

public function NearestPoint(
    point : Point
) : Stroke

Parameter

point
Typ: System.Drawing.Point
Der in Freihandbereichkoordinaten angegebene Punkt im Ink-Objekt.

Rückgabewert

Typ: Microsoft.Ink.Stroke
Das Stroke-Objekt, das einen Point enthält, der dem angegebenen point im Ink-Objekt am nächsten liegt. Wenn mehr als ein Strich einen Point enthält, der im gleichen Abstand vom bekannten Point liegt, ist der Wert dieses Ergebnisses willkürlich. Wenn das Ink-Objekt 0 (null) Stroke-Objekte enthält, ist der Rückgabewert nullNULL-Verweis (Nothing in Visual Basic) (Nothing in Visual Basic).

Beispiele

In diesem Beispiel wird die Farbe des Stroke-Objekts, das dem Mittelpunkt der Freihandeingabe am nächsten liegt, in Rot geändert.

Dim inkControl As Control = mInkOverlay.AttachedControl
' get the center of the ink control
Dim centerPt As Point = New Point(inkControl.Width / 2, inkControl.Height / 2)
Using g As Graphics = inkControl.CreateGraphics()
    ' convert center point to ink space coordinates
    mInkOverlay.Renderer.PixelToInkSpace(g, centerPt)
End Using
' get the nearest stroke
Dim nStroke As Stroke = mInkOverlay.Ink.NearestPoint(centerPt)
' nStroke will be null if there aren't any strokes
If Not IsNothing(nStroke) Then
    ' change the color of the nearest stroke to red
    nStroke.DrawingAttributes.Color = Color.Red
    inkControl.Invalidate()
End If

Control inkControl = mInkOverlay.AttachedControl;
// get the center of the ink control
Point centerPt = new Point(inkControl.Width / 2, inkControl.Height / 2);
using (Graphics g = inkControl.CreateGraphics())
{
    // convert center point to ink space coordinates
    mInkOverlay.Renderer.PixelToInkSpace(g, ref centerPt);
}

// get the nearest stroke
Stroke nStroke = mInkOverlay.Ink.NearestPoint(centerPt);

// nStroke will be null if there aren't any strokes
if (nStroke != null)
{
    // change the color of the nearest stroke to red
    nStroke.DrawingAttributes.Color = Color.Red;
    inkControl.Invalidate();
}

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.