Méthode IInkDisp::ClipboardCopy (msinkaut.h)

Article
08/24/2023

Copie la collection InkStrokes dans le Presse-papiers.

Syntaxe

HRESULT ClipboardCopy(
  [in, optional] IInkStrokes         *strokes,
  [in, optional] InkClipboardFormats ClipboardFormats,
  [in, optional] InkClipboardModes   ClipboardModes,
  [out, retval]  IDataObject         **DataObject
);

Paramètres

[in, optional] strokes

Facultatif. Spécifie les traits à copier. Si le paramètre strokes a la valeur NULL, la méthode ClipboardCopy copie la totalité de l’objet InkDisp . La valeur par défaut est NULL.

[in, optional] ClipboardFormats

Optionnel. Spécifie la valeur d’énumération InkClipboardFormats de l’objet InkDisp . La valeur par défaut est ICF_Default.

[in, optional] ClipboardModes

Optionnel. Spécifie la valeur d’énumération InkClipboardModes de l’objet InkDisp . La valeur par défaut est ICB_Default.

[out, retval] DataObject

Lorsque cette méthode est retournée, contient un pointeur vers l’objet de données nouvellement créé.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Réussite.
E_POINTER	Un paramètre contenait un pointeur non valide.
E_INK_EXCEPTION	Une exception s’est produite à l’intérieur de la méthode .
E_INK_MISMATCHED_INK_OBJECT	Le paramètre strokes est associé à un autre objet Ink.

Notes

Cette méthode copie toutes les propriétés du trait, y compris les résultats de la reconnaissance. La définition du paramètre strokes sur NULL copie l’objet InkDisp dans le Presse-papiers, y compris la propriété CustomStrokes, et les résultats de reconnaissance des traits dans la collection IInkCustomStrokes de l’objet InkDisp sont conservés.

Si une collection InkStrokes vide est passée, la méthode retourne NULL et le contenu du Presse-papiers n’est pas modifié.

RemarqueOleInitialize(NULL) doit être appelé pour que les API du Presse-papiers puissent fonctionner.

Attention Pour éviter les fuites de mémoire potentielles résultant de l’utilisation de l’indicateur ICB_DelayedCopy , vous devez appeler la méthode OleFlushClipboard ou OleSetClipboard . Cette opération doit être effectuée avant la fermeture de l’application si le dernier appel à la méthode ClipboardCopy utilisait l’indicateur ICB_DelayedCopy .

Spécifications


Client minimal pris en charge	Windows XP Édition Tablette PC [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	msinkaut.h
Bibliothèque	InkObj.dll