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

Artículo
10/28/2008

Actualización: noviembre 2007

Copia el objeto Ink en el Portapapeles.

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

Sintaxis

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

Parámetros

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
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 el objeto Ink en el Portapapeles, incluida la propiedad CustomStrokes. Además, la propiedad RecognitionResult de trazos de la colección CustomStrokes del objeto Ink se mantiene.

Si la colección Strokes del objeto Ink está 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 SetDataObject 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 clic 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(InkClipboardFormats.Default, 
            InkClipboardModes.Copy);    
    }    
    catch
    {
        // Place exception handling code here.
    }
}

En este ejemplo de Visual Basic .NET se usa el controlador de eventos de clic 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(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.