Metodo Ink.ClipboardCopy (Strokes, InkClipboardFormats, InkClipboardModes)

Articolo
10/29/2008

Aggiornamento: novembre 2007

Copia un insieme Strokes specificato negli Appunti.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Function ClipboardCopy ( _
    strokes As Strokes, _
    formats As InkClipboardFormats, _
    modes As InkClipboardModes _
) As IDataObject
'Utilizzo
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

Parametri

strokes
Tipo: Microsoft.Ink.Strokes
Insieme Strokes da copiare.

formats
Tipo: Microsoft.Ink.InkClipboardFormats
Membro dell'enumerazione InkClipboardFormats che specifica il formato dell'oggetto Ink. Il valore predefinito è Predefinito.

modes
Tipo: Microsoft.Ink.InkClipboardModes
Membro dell'enumerazione InkClipboardModes che specifica la modalità dell'oggetto Ink. Il valore predefinito è Predefinito.

Valore restituito

Tipo: System.Windows.Forms.IDataObject
Restituisce l'oggetto dati da creare. Il valore predefinito è nullriferimento null (Nothing in Visual Basic) (Nothing in Microsoft Visual Basic.NET).

Note

Questo metodo copia tutte le proprietà dell'insieme Strokes, compresa qualsiasi proprietà RecognitionResult.

L'impostazione del parametro strokes su nullriferimento null (Nothing in Visual Basic) (Nothing in Visual Basic.NET) copia l'intero oggetto Ink negli Appunti, compresa la proprietà CustomStrokes. Inoltre, vengono gestite le proprietà RecognitionResult dei tratti nell'insieme CustomStrokes dell'oggetto Ink.

Se un insieme Strokes vuoto viene passato, il valore restituito dal metodo è nullriferimento null (Nothing in Visual Basic) (Nothing in Visual Basic.NET) e il contenuto degli Appunti non viene modificato.

Avviso

Per evitare perdite di memoria potenziali in seguito all'utilizzo del flag InkClipboardModes, chiamare il metodo System.Windows.Forms.Clipboard.SetDataObject(System.Object) dell'oggetto Appunti. Questa operazione deve essere eseguita prima di uscire dall'applicazione, se nell'ultima chiamata al metodo ClipboardCopy è stato utilizzato il flag DelayedCopy nell'enumerazione InkClipboardModes.

Nota sulla sicurezza:
Se utilizzato in attendibilità parziale, questo metodo richiede l'autorizzazione UIPermissionClipboard.OwnClipboard. Per ulteriori informazioni, vedere Security And Trust.

Esempi

In questo esempio di C# viene utilizzato un gestore eventi del menu per copiare tutti gli input penna dall'oggetto InkCollector, theInkCollector, negli Appunti.

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.
    }
}

In questo esempio di Visual Basic.NET viene utilizzato un gestore eventi del menu per copiare tutti gli input penna dall'oggetto InkCollector, theInkCollector, negli Appunti.

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

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.