Ink.HitTest 메서드 (array<Point[], Single, array<Point[]%)

아티클
11/04/2008

업데이트: 2007년 11월

다중선 경계 내에 들어 있는 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)이거나 매개 변수에 포함된 점 수가 세 개 미만인 경우 이 메서드는 예외를 throw합니다.

예제

이 C# 예제에서는 Ink 개체인 theInk에서 Strokes 컬렉션을 선택하기 위해 Point 개체인 theSelectionBoundary를 사용합니다. percentIntersect 매개 변수가 50.0으로 설정되어 있으므로 Stroke 개체는 선택 경계에 들어 있는 해당 점의 50% 이상을 Strokes 컬렉션인 theStrokes에 포함시켜야 합니다. Stroke 개체를 선택하는 데 사용되는 실제 점은 Point 개체인 selectedPointsUsed의 배열에 반환됩니다.

Strokes theStrokes = theInk.HitTest(theSelectionBoundary, 50.0f, selectedPointsUsed);

이 Microsoft Visual Basic.NET 예제에서는 Ink 개체인 theInk에서 Strokes 컬렉션을 선택하기 위해 Point 개체인 theSelectionBoundary의 배열을 사용합니다. 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에서 지원

참고 항목

참조

다음을 통해 공유