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

Article
11/05/2008

Mise à jour : November 2007

Copie la collection Strokes contenue dans le rectangle spécifié 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 ( _
    copyRectangle As Rectangle, _
    formats As InkClipboardFormats, _
    modes As InkClipboardModes _
) As IDataObject
'Utilisation
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

Paramètres

copyRectangle
Type : System.Drawing.Rectangle
Rectangle qui contient la collection Strokes à copier dans le Clipboard (page pouvant être en anglais).

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

Si le rectangle découpe des objets Stroke, les objets Stroke correspondants sont découpés dans les données copiées.

Il peut être utile de copier un objet Ink entier dans le Clipboard (page pouvant être en anglais) lorsque vous souhaitez copier toutes les propriétés de l'objet Ink. Pour copier un objet Ink dans le Clipboard (page pouvant être en anglais), appelez la méthode ClipboardCopy(Strokes, InkClipboardFormats, InkClipboardModes) avec le paramètre strokes défini à null (Nothing en Visual Basic .NET).

Lorsque vous utilisez la méthode ClipboardCopy(Rectangle, InkClipboardFormats, InkClipboardModes) en mode InkClipboardModes, un objet Stroke fractionné en deux traits ou plus est supprimé et de nouveaux traits le remplacent.

Les événements Ink.InkDeleted sont générés selon les indices des objets Stroke dans la collection Strokes. Par exemple, si les objets Stroke avec les indices 0, 1, 2, 3, 5 et 6 sont supprimés, deux événements sont générés. Un événement est généré pour les objets Stroke avec les indices 0, 1, 2 et 3 ; et un événement est généré pour les objets Stroke avec les indices 5 et 6. Il y a donc un événement pour chaque ensemble contigu. Ceci s'applique également aux événements InkAdded ; toutefois, un algorithme interne détermine les indices des objets Stroke récemment ajoutés dans la collection Strokes et influence la façon dont les événements InkAdded se déclenchent.

Si vous interrogez la propriété Count de la collection Strokes à partir du gestionnaire d'événements, le résultat est le nombre total d'objets Stroke ajoutés dans toute l'opération, y compris les objets Stroke qui n'ont pas encore généré d'événements.

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# copie toute l'entrée manuscrite de la structure Rectangle, theRectangle (page pouvant être en anglais), située à l'intérieur de l'objet InkCollector, theInkCollector, dans le Clipboard (page pouvant être en anglais).

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

Cet exemple Visual Basic .NET copie toute l'entrée manuscrite de la structure Rectangle, theRectangle (page pouvant être en anglais), située à l'intérieur de l'objet InkCollector, theInkCollector dans le Clipboard (page pouvant être en anglais).

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

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.