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

아티클
11/04/2008

업데이트: 2007년 11월

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

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

구문

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

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

public IDataObject ClipboardCopy(
    Strokes strokes,
    InkClipboardFormats formats,
    InkClipboardModes modes
)

public:
IDataObject^ ClipboardCopy(
    Strokes^ strokes, 
    InkClipboardFormats formats, 
    InkClipboardModes modes
)

public IDataObject ClipboardCopy(
    Strokes strokes,
    InkClipboardFormats formats,
    InkClipboardModes modes
)

public function ClipboardCopy(
    strokes : Strokes, 
    formats : InkClipboardFormats, 
    modes : InkClipboardModes
) : IDataObject

매개 변수

strokes
형식: Microsoft.Ink.Strokes
복사할 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)입니다.

설명

이 메서드는 모든 RecognitionResult 속성을 포함하여 Strokes 컬렉션의 모든 속성을 복사합니다.

strokes 매개 변수를 nullNull 참조(Visual Basic의 경우 Nothing)(Visual Basic.NET의 경우 Nothing)로 설정하면 CustomStrokes 속성을 포함하여 전체 Ink 개체가 Clipboard에 복사됩니다. 또한 Ink 개체의 CustomStrokes 컬렉션에 있는 스트로크의 RecognitionResult 속성을 유지 관리합니다.

빈 Strokes 컬렉션이 전달되는 경우 메서드는 nullNull 참조(Visual Basic의 경우 Nothing)(Visual Basic .NET의 경우 Nothing)을 반환하고 Clipboard의 내용은 수정되지 않습니다.

경고

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

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

예제

이 C# 예제에서는 메뉴의 이벤트 처리기를 사용하여 InkCollector 개체인 theInkCollector의 모든 잉크를 Clipboard에 복사합니다.

private void menuEditCopyAll_Click(object sender, EventArgs e)
{
    try
    {
        theInkCollector.Ink.ClipboardCopy(theInkCollector.Ink.Strokes,
            InkClipboardFormats.Default, InkClipboardModes.Copy);
    }
    catch
    {
        // Place exception handling code here.
    }
}

이 Visual Basic.NET 예제에서는 메뉴의 이벤트 처리기를 사용하여 InkCollector 개체인 theInkCollector의 모든 잉크를 Clipboard에 복사합니다.

Private Sub menuEditCopy_Click(Dim sender As Object, Dim e As EventArgs)
    Try
        theInkCollector.Ink.ClipboardCopy(theInkCollector.Ink.Strokes,
            InkClipboardFormats.Default, InkClipboardModes.Copy)
    Catch
        'Place exception handling code here.
    End Try
End Sub