Stroke.NearestPoint 方法 (Point)

项目
11/04/2008

返回 Stroke 对象上最接近指定 Point 的位置。

命名空间： Microsoft.Ink
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）

语法

声明
Public Function NearestPoint ( _
    pt As Point _
) As Single
用法
Dim instance As Stroke
Dim pt As Point
Dim returnValue As Single

returnValue = instance.NearestPoint(pt)

public float NearestPoint(
    Point pt
)

public:
float NearestPoint(
    Point pt
)

public float NearestPoint(
    Point pt
)

public function NearestPoint(
    pt : Point
) : float

参数

pt
类型：System.Drawing.Point
指定点，采用墨迹空间 坐标。

返回值

类型：System.Single
返回 Stroke 对象上最接近指定 Point 的位置。

备注

浮点索引是一个浮点值，表示 Stroke 对象中两点之间的某个位置。例如，如果 0.0 是笔画中的第一个点，而 1.0 是笔画中的第二个点，则 0.5 位于第一个点和第二个点的正中间。与之类似，浮点索引值 37.25 表示位于笔画点 37 和 38 之间连线的 25% 的位置。

示例

在此示例中，检查 InkOverlay 对象的所有选定 Stroke 对象。使用 NearestPoint 方法确定笔画上最接近墨迹画布中心的点。然后，创建一个新的 Stroke 对象，该对象将该最近点与画布中心连接起来。

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
' examine each selected stroke
For Each S As Stroke In mInkOverlay.Selection
    ' get the index of the nearest point
    Dim fIdx As Single = S.NearestPoint(centerPt)
    ' create points from the center to the nearest point on the stroke
    Dim connectPts() As Point = _
    { _
        centerPt, _
        S.GetPoint(CType(Math.Round(fIdx, MidpointRounding.ToEven), Integer)) _
    }
    ' create the stroke
    S.Ink.CreateStroke(connectPts)
Next

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);
}

// examine each selected stroke
foreach (Stroke S in mInkOverlay.Selection)
{
    // get the index of the nearest point
    float fIdx = S.NearestPoint(centerPt);
    // create points from the center to the nearest point on the stroke
    Point[] connectPts = new Point[2] 
    {
        centerPt, 
        S.GetPoint((int)Math.Round(fIdx, MidpointRounding.ToEven))
    };
    // create the stroke
    S.Ink.CreateStroke(connectPts);
}