Metodo Ink.ClipboardCopy (InkClipboardFormats, InkClipboardModes)

Aggiornamento: novembre 2007

Copia l'oggetto Ink negli Appunti.

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

Sintassi

'Dichiarazione
Public Function ClipboardCopy ( _
    formats As InkClipboardFormats, _
    modes As InkClipboardModes _
) As IDataObject
'Utilizzo
Dim instance As Ink
Dim formats As InkClipboardFormats
Dim modes As InkClipboardModes
Dim returnValue As IDataObject

returnValue = instance.ClipboardCopy(formats, _
    modes)

public IDataObject ClipboardCopy(
    InkClipboardFormats formats,
    InkClipboardModes modes
)

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

public IDataObject ClipboardCopy(
    InkClipboardFormats formats,
    InkClipboardModes modes
)

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

Parametri

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
L'oggetto dati da creare. Il valore predefinito è nullriferimento null (Nothing in Visual Basic) (Nothing in Microsoft Visual Basic.NET).

Note

Questo metodo copia l'oggetto Ink negli Appunti, compresa la proprietà CustomStrokes. Inoltre, viene gestita la proprietà RecognitionResult di tratti nell'insieme CustomStrokesdell'oggetto Ink.

Se l'insieme Strokes dell'oggetto Ink è vuoto, il metodo restituisce 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 SetDataObject 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 Click 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(InkClipboardFormats.Default, 
            InkClipboardModes.Copy);    
    }    
    catch
    {
        // Place exception handling code here.
    }
}

In questo esempio di Visual Basic .NET viene utilizzato un gestore eventi Click 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(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.