Ink.ClipboardCopy - метод (Strokes, InkClipboardFormats, InkClipboardModes)

Статья
11/04/2008

Обновлен: Ноябрь 2007

Copies a specified Strokes collection to the 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
The Strokes collection to copy.

formats
Тип: Microsoft.Ink.InkClipboardFormats
A member of the InkClipboardFormats enumeration that specifies the format for the Ink object. The default value is Default.

modes
Тип: Microsoft.Ink.InkClipboardModes
A member of the InkClipboardModes enumeration that specifies the mode for the Ink object. The default value is Default.

Возвращаемое значение

Тип: System.Windows.Forms.IDataObject
Returns the data object to be created. The default value is nullссылка null (Nothing в Visual Basic) (Nothing in Microsoft Visual Basic.NET).

Заметки

This method copies all properties of the Strokes collection, including any RecognitionResult property.

Setting the strokes parameter to nullссылка null (Nothing в Visual Basic) (Nothing in Visual Basic.NET) copies the entire Ink object to the Clipboard, including the CustomStrokes property. In addition, the RecognitionResult properties for strokes in the Ink object's CustomStrokes collection are maintained.

If an empty Strokes collection is passed, the method returns nullссылка null (Nothing в Visual Basic) (Nothing in Visual Basic.NET) and the contents of the Clipboard are not modified.

Предупреждение

To avoid potential memory leaks as a result of using the InkClipboardModes flag, call the System.Windows.Forms.Clipboard.SetDataObject(System.Object) method of the Clipboard object. This must be done before the application exits if the last call to the ClipboardCopy method used the DelayedCopy flag in enumeration InkClipboardModes..

Примечание о безопасности.
If using under partial trust, this method requires UIPermissionClipboard.OwnClipboard permission. See Security And Trust for more information.

Примеры

This C# example uses a menu's event handler to copy all of the ink from the InkCollector object, theInkCollector, to the 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.
    }
}

This Visual Basic.NET example uses a menu's event handler to copy all of the ink from the InkCollector object, theInkCollector, to the 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

Платформы

Windows Vista

Среды .NET Framework и .NET Compact Framework поддерживают не все версии каждой платформы. Поддерживаемые версии перечислены в разделе Требования к системе для .NET Framework.