Ink.ClipboardCopy (Método) (Rectangle, InkClipboardFormats, InkClipboardModes)

Artículo
11/26/2008

Actualización: noviembre 2007

Copia en el Portapapeles la colección Strokes contenida en el rectángulo especificado.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

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

Parámetros

copyRectangle
Tipo: System.Drawing.Rectangle
Rectángulo que contiene la colección Strokes que se va a copiar en el Portapapeles.

formats
Tipo: Microsoft.Ink.InkClipboardFormats
Miembro de la enumeración InkClipboardFormats que especifica el formato para el objeto Ink. El valor predeterminado es Default.

modes
Tipo: Microsoft.Ink.InkClipboardModes
Miembro de la enumeración InkClipboardModes que especifica el modo para el objeto Ink. El valor predeterminado es Default.

Valor devuelto

Tipo: System.Windows.Forms.IDataObject
Devuelve el objeto de datos que se va a crear. El valor predeterminado es nullreferencia null (Nothing en Visual Basic) (Nothing en Microsoft Visual Basic.NET).

Comentarios

Si el rectángulo recorta los objetos Stroke, los objetos Stroke correspondientes se recortan en los datos copiados.

Puede resultar útil copiar un objeto Ink completo en el Portapapeles cuando desee copiar todas las propiedades del objeto Ink. Para copiar un objeto Ink en el Portapapeles, llame al método ClipboardCopy(Strokes, InkClipboardFormats, InkClipboardModes) con el parámetro strokes establecido en null (Nothing en Visual Basic .NET).

Cuando se usa el método ClipboardCopy(Rectangle, InkClipboardFormats, InkClipboardModes) en modo InkClipboardModes, se elimina un objeto Stroke que se divide en dos o más trazos y en su lugar se agregan los nuevos trazos.

Los eventos Ink.InkDeleted se generan según los índices de los objetos Stroke de la colección Strokes. Por ejemplo, si se van a eliminar los objetos Stroke de los índices 0, 1, 2, 3, 5 y 6, se generan dos eventos. Un evento se genera para los objetos Stroke con índices 0, 1, 2 y 3; y se genera otro evento para los objetos Stroke con índices 5 y 6. Es decir, hay un evento para cada conjunto contiguo. Esto también se aplica a los eventos InkAdded; sin embargo, un algoritmo interno determina los índices de los objetos Stroke agregados recientemente a la colección Strokes e influye en el modo en que se desencadenan los eventos InkAdded.

Si realiza consultas a la propiedad Count de la colección Strokes desde el controlador de eventos, el resultado es el número total de objetos Stroke que agrega toda la operación, incluidos los objetos Stroke que todavía no han generado eventos.

Advertencia

Para evitar las posibles pérdidas de memoria como resultado de usar el marcador InkClipboardModes, llame al método System.Windows.Forms.Clipboard.SetDataObject(System.Object) del objeto Clipboard. Esto se debe hacer antes de que la aplicación salga si la última llamada al método ClipboardCopy usó el marcador DelayedCopy en la enumeración InkClipboardModes.

Nota de seguridad:
Si se usa en entornos de confianza parcial, este método necesita el permiso UIPermissionClipboard.OwnClipboard. Vea Security and Trust para obtener más información.

Ejemplos

En este ejemplo de C# se copian todas las entradas manuscritas de la estructura Rectángulo, theRectangle, en el objeto InkCollector, theInkCollector en el Portapapeles.

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

En este ejemplo de Visual Basic .NET se copian todas las entradas manuscritas de la estructura Rectángulo, theRectangle, en el objeto InkCollector, theInkCollector en el Portapapeles.

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

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.