Metodo Ink.ClipboardCopy (Rectangle, InkClipboardFormats, InkClipboardModes)

Aggiornamento: novembre 2007

Copia l'insieme Strokes contenuto nel rettangolo specificato negli Appunti.

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

Sintassi

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

Parametri

• copyRectangle
  Tipo: System.Drawing.Rectangle
  Rettangolo che contiene l'insieme Strokes da copiare negli Appunti.

• 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

Se il rettangolo ritaglia gli oggetti Stroke, gli oggetti Stroke corrispondenti vengono ritagliati nei dati copiati.

Può essere utile copiare un oggetto Ink negli Appunti quando si desidera copiare tutte le proprietà dell'oggetto Ink. Per copiare un oggetto Ink negli Appunti, chiamare il metodo ClipboardCopy(Strokes, InkClipboardFormats, InkClipboardModes) con il parametro strokes impostato su null (Nothing in Visual Basic .NET).

Quando si utilizza il metodo ClipboardCopy(Rectangle, InkClipboardFormats, InkClipboardModes) nella modalità InkClipboardModes, un oggetto Stroke, che è suddiviso in due o più tratti, viene eliminato e i nuovi tratti vengono aggiunti nella posizione corrispondente.

Gli eventi Ink.InkDeleted vengono generati in base agli indici degli oggetti Stroke all'interno dell'insieme Strokes. Ad esempio, se gli oggetti Stroke a indici 0, 1, 2, 3, 5 e 6 devono essere eliminati, vengono generati due eventi. Un evento viene generato per gli oggetti Stroke con indici 0, 1, 2 e 3; l'altro evento viene generato per gli oggetti Stroke con gli indici 5 e 6, ovvero esiste un unico evento per ciascun insieme contiguo. Ciò è valido anche per gli eventi InkAdded; tuttavia, un algoritmo interno determina gli indici degli oggetti Stroke appena aggiunti nell'insieme Strokes e influisce su come vengono generati gli eventi InkAdded.

Se si esegue una query per la proprietà Count dell'insieme Strokes dall'interno del gestore eventi, il risultato è il numero totale di oggetti Stroke aggiunti con l'intera operazione, compresi gli oggetti Stroke che non hanno ancora generato eventi.

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# vengono copiati tutti gli input penna dalla struttura Rectangle, theRectangle, dell'oggetto InkCollector, theInkCollector negli Appunti.

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

In questo esempio di Visual Basic .NET vengono copiati tutti gli input penna dalla struttura Rectangle, theRectangle, dell'oggetto InkCollector, theInkCollector negli Appunti.

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

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.

Informazioni sulla versione

.NET Framework

Supportato in: 3.0

Vedere anche

Riferimenti

Ink Classe

Membri Ink

Overload ClipboardCopy

Spazio dei nomi Microsoft.Ink

ClipboardPaste