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

Remplit un nouvel objet InkDisp avec des données binaires connues.

Syntaxe

HRESULT Load(
  [in] VARIANT Data
);

Paramètres

[in] Data

Flux qui contient les données manuscrites.

Pour plus d’informations sur la structure VARIANT, consultez Utilisation de la bibliothèque COM.

Valeur retournée

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

Code de retour	Description
S_OK	Réussite.
E_INVALIDARG	VARIANT n’était pas de type correct (tableau d’octets).
E_OUTOFMEMORY	Impossible d’allouer de la mémoire pour Stream.
E_UNEXPECTED	Type de paramètre ou de propriété inattendu.
E_INK_EXCEPTION	Une exception s’est produite à l’intérieur de la méthode.

Remarques

Vous pouvez charger l’entrée manuscrite uniquement dans un nouvel objet InkDisp vide, qui n’a pas collecté de traits ou qui n’a pas de propriétés attachées. Si vous essayez de charger l’entrée manuscrite dans un objet InkDisp qui a des traits collectés ou des propriétés jointes, même si les traits ou propriétés ont été supprimés de l’objet InkDisp , une exception est levée. Cela se produit en raison de la façon dont les ID de trait sont attribués. Un trait se voit attribuer un ID unique et cet ID n’est pas réutilisé, même si le trait a été supprimé d’un objet Ink. Cela signifie que, si un objet InkDisp contenait un trait avec un ID 1 et que vous avez supprimé le trait et chargé un autre objet InkDisp dans cet objet InkDisp , les ID de trait commencent à 2. Cela prêterait à confusion et n’est donc pas autorisé.

La méthode Save vous permet de conserver l’encre dans un objet InkDisp au format GIF (Graphics Interchange Format), qui se compose d’un tableau de données d’octets (le format de persistance tla_gif est spécifié dans le type d’énumération InkPersistenceFormat ). Une fois que vous avez le tableau de données d’octets, vous pouvez charger le tableau de données d’octets dans un autre objet InkDisp . Cela signifie que vous pouvez charger des données de tableau d’octets compatibles AVEC GIF dans un autre objet InkDisp de la même manière que si vous aviez appelé la méthode Save et reçu un tableau d’octets qui n’était pas au format GIF.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP Édition Tablet 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

Voir aussi

IInkDisp

Classe InkDisp

Save, méthode