Ink.ClipboardCopy, méthode (InkClipboardFormats, InkClipboardModes)

Article
11/05/2008

Mise à jour : November 2007

Copie l'objet Ink dans le Clipboard (page pouvant être en anglais).

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Function ClipboardCopy ( _
    formats As InkClipboardFormats, _
    modes As InkClipboardModes _
) As IDataObject
'Utilisation
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

Paramètres

formats
Type : Microsoft.Ink.InkClipboardFormats
Membre de l'énumération InkClipboardFormats qui spécifie le format de l'objet Ink. La valeur par défaut est Default.

modes
Type : Microsoft.Ink.InkClipboardModes
Membre de l'énumération InkClipboardModes qui spécifie le mode de l'objet Ink. La valeur par défaut est Default.

Valeur de retour

Type : System.Windows.Forms.IDataObject
Objet de données à créer. La valeur par défaut est nullune référence null (Nothing en Visual Basic) (Nothing en Microsoft Visual Basic.NET).

Notes

Cette méthode copie l'objet Ink dans le Clipboard (page pouvant être en anglais), y compris la propriété CustomStrokes. De plus, la propriété RecognitionResult des traits situés dans la collection CustomStrokes de l'objet Ink est conservée.

Si la collection Strokes de l'objet Ink est vide, la méthode retourne nullune référence null (Nothing en Visual Basic) (Nothing en Visual Basic .NET), et le contenu du Clipboard (page pouvant être en anglais) n'est pas modifié.

Attention :
Pour éviter les fuites de mémoire potentielles en utilisant l'indicateur InkClipboardModes, appelez la méthode SetDataObject de l'objet du Clipboard (page pouvant être en anglais). Ceci doit être effectué avant la fermeture de l'application si le dernier appel à la méthode ClipboardCopy a utilisé l'indicateur DelayedCopy dans l'énumération InkClipboardModes.

Note de sécurité :
Lors de l'utilisation en situation de confiance partielle, cette méthode requiert l'autorisation UIPermissionClipboard.OwnClipboard (page pouvant être en anglais). Pour plus d'informations, consultez Security and Trust.

Exemples

Cet exemple C# utilise le gestionnaire d'événements Click d'un menu pour copier toute l'entrée manuscrite de l'objet InkCollector, theInkCollector dans le Clipboard (page pouvant être en anglais).

private void menuEditCopyAll_Click(object sender, EventArgs e)
{    
    try
    {
        theInkCollector.Ink.ClipboardCopy(InkClipboardFormats.Default, 
            InkClipboardModes.Copy);    
    }    
    catch
    {
        // Place exception handling code here.
    }
}

Cet exemple Visual Basic .NET utilise le gestionnaire d'événements Click d'un menu pour copier toute l'entrée manuscrite de l'objet InkCollector, theInkCollector dans le Clipboard (page pouvant être en anglais).

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

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.