ポリライン選択境界に含まれている 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[]%
このメソッドの戻り値には、選択で使用される選択境界の特定部分を表す出力パラメータが含まれます。ユーザーはさまざまな形の境界をいくつでも描画でき、何度も重なり合う境界もあるため、これは境界のどの部分が選択で使用されるかを表す場合に便利です。このパラメータは初期化せずに渡されます。
戻り値
型 : Microsoft.Ink.Strokes
指定された領域に含まれる Strokes コレクション。
解説
選択境界がそれ自体と交差しない場合、HitTest メソッドは配列の最後にポイントを追加して最初のポイントと最後のポイントをつなぐ直線を作成します。境界が直線で、選択境界内に領域を持たない場合は、Stroke オブジェクトは選択されません。
ポイント パラメータが nullnull 参照 (Visual Basic では Nothing) (Microsoft Visual Basic.NET の場合は Nothing) であるか、含まれるポイントが 2 つ以下の場合、このメソッドは例外をスローします。
例
この C# の例では Point オブジェクトの配列 theSelectionBoundary を使用して、Ink オブジェクト theInk の Strokes コレクションを選択します。percentIntersect パラメータは 50.0 に設定されているため、Stroke オブジェクトを Strokes コレクション theStrokes に含めるためには、このオブジェクトのポイントの少なくとも 50% が選択境界内に含まれていることが必要です。Stroke オブジェクトを選択するために使用される実際のポイントは、Point オブジェクトの配列 selectedPointsUsed で返されます。
Strokes theStrokes = theInk.HitTest(theSelectionBoundary, 50.0f, selectedPointsUsed);
この Microsoft Visual Basic.NET の例では、Point オブジェクトの配列 theSelectionBoundary を使用して、Ink オブジェクト theInk の Strokes コレクションを選択します。percentIntersect パラメータは 50.0 に設定されているため、Stroke オブジェクトを Strokes コレクション theStrokes に含めるためには、このオブジェクトのポイントの少なくとも 50% が選択境界内に含まれていることが必要です。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