Ink.ExtractStrokes 메서드 (Strokes, ExtractFlags)

아티클
11/04/2008

업데이트: 2007년 11월

지정된 대로 잘라내기 또는 복사를 사용하여 Ink 개체에서 지정된 Stroke 개체를 추출하고 추출된 Stroke 개체가 포함된 새 Ink 개체를 반환합니다.

네임스페이스: Microsoft.Ink
어셈블리: Microsoft.Ink(Microsoft.Ink.dll)

구문

‘선언
Public Function ExtractStrokes ( _
    strokes As Strokes, _
    extractionFlags As ExtractFlags _
) As Ink
‘사용 방법
Dim instance As Ink
Dim strokes As Strokes
Dim extractionFlags As ExtractFlags
Dim returnValue As Ink

returnValue = instance.ExtractStrokes(strokes, _
    extractionFlags)

public Ink ExtractStrokes(
    Strokes strokes,
    ExtractFlags extractionFlags
)

public:
Ink^ ExtractStrokes(
    Strokes^ strokes, 
    ExtractFlags extractionFlags
)

public Ink ExtractStrokes(
    Strokes strokes,
    ExtractFlags extractionFlags
)

public function ExtractStrokes(
    strokes : Strokes, 
    extractionFlags : ExtractFlags
) : Ink

매개 변수

strokes
형식: Microsoft.Ink.Strokes
추출할 Strokes 컬렉션입니다.

extractionFlags
형식: Microsoft.Ink.ExtractFlags
잉크를 잘라낼지 새 Ink 개체에 복사할지를 지정하는 ExtractFlags 값 중 하나입니다.

반환 값

형식: Microsoft.Ink.Ink
추출된 Strokes 컬렉션이 들어 있는 Ink 개체를 반환합니다.

설명

새 Ink 개체는 원래 Ink 개체의 그리기 특성, 속성 및 좌표를 그대로 보유합니다.

이 메서드의 기본 동작은 원래 Ink 개체에서 Strokes 컬렉션을 제거하는 것입니다. 원래 Ink 개체의 Strokes 컬렉션을 유지하고 Ink의 복사본을 만들려면 이 메서드의 ExtractStrokes 또는 ExtractStrokes 오버로드를 호출하고 extractionFlags 매개 변수를 ExtractFlags 열거형의 CopyFromOriginal 값으로 설정합니다.

예제

이 예제에서는 InkOverlay 개체의 처음 두 Stroke 개체가 포함된 새 Ink 개체를 만듭니다. extractionFlags 매개 변수가 ExtractFlags 열거형의 CopyFromOriginal 값으로 설정되어 있으므로 Strokes 컬렉션은 원래 Ink 개체에서 유지됩니다.

' Access to the Strokes property returns a copy of the Strokes object.
' This copy must be implicitly (via using statement) or explicitly
' disposed of in order to asub a memory leak.
Using allStrokes As Strokes = mInkOverlay.Ink.Strokes
    If (allStrokes.Count > 2) Then
        Dim temp As Strokes = allStrokes.Ink.CreateStrokes()
        temp.Add(allStrokes(0))
        temp.Add(allStrokes(1))
        Dim newInk As Ink = allStrokes.Ink.ExtractStrokes(temp, ExtractFlags.CopyFromOriginal)
    End If
End Using

// Access to the Strokes property returns a copy of the Strokes object.
// This copy must be implicitly (via using statement) or explicitly
// disposed of in order to avoid a memory leak.
using (Strokes allStrokes = mInkOverlay.Ink.Strokes)
{
    if (allStrokes.Count > 2)
    {
        Strokes temp = allStrokes.Ink.CreateStrokes();
        temp.Add(allStrokes[0]);
        temp.Add(allStrokes[1]);
        Ink newInk = allStrokes.Ink.ExtractStrokes(temp, ExtractFlags.CopyFromOriginal);
    }
}