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

Article
11/05/2008

Mise à jour : November 2007

Copie une collection Strokes spécifiée 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 ( _
    strokes As Strokes, _
    formats As InkClipboardFormats, _
    modes As InkClipboardModes _
) As IDataObject
'Utilisation
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

Paramètres

strokes
Type : Microsoft.Ink.Strokes
Collection Strokes à copier.

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
Retourne l'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 toutes les propriétés de la collection Strokes, y compris les propriétés RecognitionResult.

Affecter la valeur nullune référence null (Nothing en Visual Basic) (Nothing en Visual Basic.NET) au paramètre strokes copie l'objet Ink entier dans le Clipboard (page pouvant être en anglais), y compris la propriété CustomStrokes. De plus, les propriétés RecognitionResult des traits situés dans la collection CustomStrokes de l'objet Ink sont conservées.

Si une collection Strokes 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 des fuites de mémoire potentielles en utilisant l'indicateur InkClipboardModes, appelez la méthode System.Windows.Forms.Clipboard.SetDataObject(System.Object) (page pouvant être en anglais) 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.

Pour éviter des fuites de mémoire potentielles en utilisant l'indicateur InkClipboardModes, appelez la méthode System.Windows.Forms.Clipboard.SetDataObject(System.Object) (page pouvant être en anglais) 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énement 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(theInkCollector.Ink.Strokes,
            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(theInkCollector.Ink.Strokes,
            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.