Stroke.NearestPoint 方法 (Point, Single%)

项目
11/04/2008

返回 Stroke 对象上最接近指定 Point 的位置以及该点与 Stroke 对象之间的距离。

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

语法

声明
Public Function NearestPoint ( _
    pt As Point, _
    <OutAttribute> ByRef distance As Single _
) As Single
用法
Dim instance As Stroke
Dim pt As Point
Dim distance As Single
Dim returnValue As Single

returnValue = instance.NearestPoint(pt, _
    distance)

public float NearestPoint(
    Point pt,
    out float distance
)

public:
float NearestPoint(
    Point pt, 
    [OutAttribute] float% distance
)

public float NearestPoint(
    Point pt,
    /** @attribute OutAttribute */ /** @ref */float distance
)

public function NearestPoint(
    pt : Point, 
    distance : float
) : float

参数

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

distance
类型：System.Single%
该点与 Stroke 对象之间的距离，采用浮点索引形式。

返回值

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

备注

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

示例

在此示例中，检查 InkOverlay 对象的所有选定 Stroke 对象。使用 NearestPoint 方法确定该笔画上最接近墨迹画布中心的点以及该中心与该点之间的距离（以 HIMETRIC 为单位）。如果该距离至少为 2000 HIMETRIC 单位，则创建一个新的 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 distance As Single
    Dim fIdx As Single = S.NearestPoint(centerPt, distance)
    If distance >= 2000.0 Then
        ' 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)
    End If
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 distance;
    float fIdx = S.NearestPoint(centerPt, out distance);
    if (distance >= 2000.0)
    {
        // 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);
    }
}