Ink.ClipboardCopy 메서드 (Rectangle, InkClipboardFormats, InkClipboardModes)

아티클
11/04/2008

업데이트: 2007년 11월

지정된 사각형에 포함된 Strokes 컬렉션을 Clipboard에 복사합니다.

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

구문

‘선언
Public Function ClipboardCopy ( _
    copyRectangle As Rectangle, _
    formats As InkClipboardFormats, _
    modes As InkClipboardModes _
) As IDataObject
‘사용 방법
Dim instance As Ink
Dim copyRectangle As Rectangle
Dim formats As InkClipboardFormats
Dim modes As InkClipboardModes
Dim returnValue As IDataObject

returnValue = instance.ClipboardCopy(copyRectangle, _
    formats, modes)

public IDataObject ClipboardCopy(
    Rectangle copyRectangle,
    InkClipboardFormats formats,
    InkClipboardModes modes
)

public:
IDataObject^ ClipboardCopy(
    Rectangle copyRectangle, 
    InkClipboardFormats formats, 
    InkClipboardModes modes
)

public IDataObject ClipboardCopy(
    Rectangle copyRectangle,
    InkClipboardFormats formats,
    InkClipboardModes modes
)

public function ClipboardCopy(
    copyRectangle : Rectangle, 
    formats : InkClipboardFormats, 
    modes : InkClipboardModes
) : IDataObject

매개 변수

copyRectangle
형식: System.Drawing.Rectangle
Clipboard에 복사할 Strokes 컬렉션이 포함된 사각형입니다.

formats
형식: Microsoft.Ink.InkClipboardFormats
Ink 개체의 서식을 지정하는 InkClipboardFormats 열거형의 멤버입니다. 기본값은 Default입니다.

modes
형식: Microsoft.Ink.InkClipboardModes
Ink 개체의 모드를 지정하는 InkClipboardModes 열거형의 멤버입니다. 기본값은 Default입니다.

반환 값

형식: System.Windows.Forms.IDataObject
만들 데이터 개체를 반환합니다. 기본값은 nullNull 참조(Visual Basic의 경우 Nothing)(Microsoft Visual Basic.NET의 경우 Nothing)입니다.

설명

사각형에서 Stroke 개체를 자르는 경우 복사된 데이터에서도 해당하는 Stroke 개체가 잘립니다.

Ink 개체의 모든 속성을 복사하려는 경우에는 전체 Ink 개체를 Clipboard에 복사하는 것이 유용할 수 있습니다. Ink 개체를 Clipboard에 복사하려면 strokes 매개 변수를 null(Visual Basic .NET의 경우 Nothing)로 설정하여 ClipboardCopy(Strokes, InkClipboardFormats, InkClipboardModes) 메서드를 호출합니다.

ClipboardCopy(Rectangle, InkClipboardFormats, InkClipboardModes) 메서드를 InkClipboardModes 모드에서 사용하는 경우에는 두 개 이상의 스트로크로 분할되는 Stroke 개체가 삭제되고 해당 위치에 새 스트로크가 추가됩니다.

Ink.InkDeleted 이벤트는 Strokes 컬렉션 내의 Stroke 개체 인덱스를 기반으로 발생합니다. 예를 들어 인덱스 0, 1, 2, 3, 5 및 6에 있는 Stroke 개체를 삭제하려는 경우에는 두 개의 이벤트가 발생합니다. 이벤트 하나는 인덱스 0, 1, 2 및 3의 Stroke 개체에 대해 발생하고, 다른 하나는 인덱스 5 및 6의 Stroke 개체에 대해 발생합니다. 즉, 각 연속 집합에 대해 이벤트가 하나씩 있는 것입니다. 이는 InkAdded 이벤트에도 적용되지만, 내부 알고리즘에 따라 Strokes 컬렉션의 새로 추가된 Stroke 개체 인덱스가 결정되고 InkAdded 이벤트가 발생하는 방식이 변경됩니다.

이벤트 처리기 내에서 Strokes 컬렉션의 Count 속성에 대해 쿼리하면 아직 이벤트를 발생시키지 않은 Stroke 개체를 포함하여 전체 작업을 통해 추가된 Stroke 개체의 총 수가 결과로 나옵니다.

경고

InkClipboardModes 플래그를 사용할 때 메모리 누수가 발생하지 않게 하려면 Clipboard 개체의 System.Windows.Forms.Clipboard.SetDataObject(System.Object) 메서드를 호출합니다. 이 메서드는 ClipboardCopy 메서드를 마지막으로 호출할 때 InkClipboardModes 열거형에 DelayedCopy 플래그를 사용한 경우 응용 프로그램이 종료되기 전에 호출해야 합니다.

보안 정보:
부분 신뢰 환경에서 사용하는 경우 이 메서드에 UIPermissionClipboard.OwnClipboard 권한이 필요합니다. 자세한 내용은 Security And Trust를 참조하십시오.

예제

이 C# 예제에서는 InkCollector 개체인 theInkCollector에 대한 Rectangle 구조체인 theRectangle의 모든 잉크를 Clipboard에 복사합니다.

try
{
    theInkCollector.Ink.ClipboardCopy(theRectangle,
        InkClipboardFormats.Default, InkClipboardModes.Copy);
}
catch
{
    // Place exception handling code here.
}

이 Visual Basic .NET 예제에서는 InkCollector 개체인 theInkCollector에 대한 Rectangle 구조체인 theRectangle의 모든 잉크를 Clipboard에 복사합니다.

Try
    theInkCollector.Ink.ClipboardCopy(theRectangle,
        InkClipboardFormats.Default, InkClipboardModes.Copy)
Catch
    'Place exception handling code here.
End Try