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

Artículo
10/28/2008

Actualización: noviembre 2007

Copia una colección Strokes especificada en el Portapapeles.

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

Sintaxis

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

Parámetros

strokes
Tipo: Microsoft.Ink.Strokes
La colección Strokes que se va a copiar.

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

Este método copia todas las propiedades de la colección Strokes, incluidas las propiedades RecognitionResult.

Al establecer el parámetro strokes en nullreferencia null (Nothing en Visual Basic) (Nothing en Visual Basic.NET), todo el objeto Ink se copia en el Portapapeles, incluida la propiedad CustomStrokes. Además, las propiedades RecognitionResult de trazos de la colección CustomStrokes del objeto Ink se mantienen.

Si se pasa una colección Strokes vacía, el método devuelve nullreferencia null (Nothing en Visual Basic) (Nothing en Visual Basic .NET) y no se modifica el contenido del Portapapeles.

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 usa el controlador de eventos de un menú para copiar todas las entradas manuscritas del objeto InkCollector, theInkCollector, en el Portapapeles.

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

En este ejemplo de Visual Basic.NET se usa el controlador de eventos de un menú para copiar todas las entradas manuscritas del objeto InkCollector, theInkCollector, en el Portapapeles.

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

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.