Ink.HitTest 方法 (array<Point[], Single, array<Point[]%)
返回多边形选择边界所包含的 Strokes 集合。
命名空间： Microsoft.Ink
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）
语法
声明
Public Function HitTest ( _
points As Point(), _
percentIntersect As Single, _
<OutAttribute> ByRef lassoPoints As Point() _
) As Strokes
用法
Dim instance As Ink
Dim points As Point()
Dim percentIntersect As Single
Dim lassoPoints As Point()
Dim returnValue As Strokes
returnValue = instance.HitTest(points, _
percentIntersect, lassoPoints)
public Strokes HitTest(
Point[] points,
float percentIntersect,
out Point[] lassoPoints
)
public:
Strokes^ HitTest(
array<Point>^ points,
float percentIntersect,
[OutAttribute] array<Point>^% lassoPoints
)
public Strokes HitTest(
Point[] points,
float percentIntersect,
/** @attribute OutAttribute */ /** @ref */Point[] lassoPoints
)
public function HitTest(
points : Point[],
percentIntersect : float,
lassoPoints : Point[]
) : Strokes
参数
- points
类型：array<System.Drawing.Point[]
在选择边界中用于选择 Stroke 对象的点。选择区域是选择边界内的区域，边界在选择边界内首次与自己相交。
- percentIntersect
类型：System.Single
为达到命中而必须重叠的百分比。
- lassoPoints
类型：array<System.Drawing.Point[]%
此方法返回时包含一个 out 参数，该参数表示选择边界用于选择的特定部分。因为用户可以绘制许多不同形状的边界，其中一些会多次重叠，所以此方法对于说明边界的哪些部分用于选择很有用。该参数未经初始化即被传递。
返回值
类型：Microsoft.Ink.Strokes
指定的区域中所包含的 Strokes 集合。
备注
如果选择边界不与自己相交，则 HitTest 方法将一个点添加到数组末尾，从而创建一条从第一个点到最后一个点的直线。如果边界是选择边界之外的直线，则不选择任何 Stroke 对象。
如果点参数为 nullnull 引用（在 Visual Basic 中为 Nothing）（在 Microsoft Visual Basic.NET 中为 Nothing）或包含的点数少于三，则此方法将引发异常。
示例
此 C# 示例使用 Point 对象数组 theSelectionBoundary 从 Ink 对象 theInk 中选择 Strokes 集合。percentIntersect 参数设置为 50.0，因此，Stroke 对象必须有至少 50% 的点包含在选择边界内才能包含在 Strokes 集合 theStrokes 中。实际用于选择 Stroke 对象的点是在 Point 对象数组 selectedPointsUsed 中返回的。
Strokes theStrokes = theInk.HitTest(theSelectionBoundary, 50.0f, selectedPointsUsed);
此 Microsoft Visual Basic.NET 示例使用 Point 对象数组 theSelectionBoundary 从 Ink 对象 theInk 中选择 Strokes 集合。percentIntersect 参数设置为 50.0，因此，Stroke 对象必须有至少 50% 的点包含在选择边界内才能包含在 Strokes 集合 theStrokes 中。实际用于选择 Stroke 对象的点是在 Point 对象数组 selectedPointsUsed 中返回的。
Dim theStrokes As Strokes = theInk.HitTest(theSelectionBoundary, 50.0, selectedPointsUsed)
平台
Windows Vista
.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。
版本信息
.NET Framework
受以下版本支持：3.0