Facultatif. Définit l’une des valeurs InkPersistenceFormat qui indique le format de l’encre persistante. La valeur par défaut est InkSerializedFormat.
Nom
Description
InkSerializedFormat
L’entrée manuscrite est conservée à l’aide du format sérialisé manuscrit (ISF).
Le format ISF est la représentation persistante la plus compacte de l’entrée manuscrite. Vous pouvez l’intégrer dans un format de document binaire ou le placer directement dans le Presse-papiers. Il s’agit de la valeur par défaut.
Base64InkSerializedFormat
L’entrée manuscrite est conservée en encodant l’ISF en tant que flux de base64.
Ce format est fourni afin que l’entrée manuscrite puisse être encodée directement dans un fichier XML (Extensible Markup Language) ou HTML.
Gif
L’entrée manuscrite est conservée à l’aide d’un fichier GIF (Graphics Interchange Format) qui contient ISF en tant que métadonnées incorporées dans le fichier.
Cela permet d’afficher l’entrée manuscrite dans les applications qui ne sont pas compatibles avec l’entrée manuscrite et de maintenir sa fidélité totale lorsqu’elle retourne à une application avec entrée manuscrite. Ce format est idéal pour transporter du contenu manuscrit dans un fichier HTML et le rendre utilisable par les applications compatibles avec l’entrée manuscrite et ne prenant pas en charge l’entrée manuscrite.
Base64Gif
L’entrée manuscrite est conservée à l’aide d’un codé en base64 fortifié.
Ce format GIF est fourni lorsque l’entrée manuscrite doit être encodée directement dans un fichier XML ou HTML avec une conversion ultérieure en image. Une utilisation possible de cela serait dans un format XML qui est généré pour contenir toutes les informations manuscrites et utilisé comme un moyen de générer du code HTML par le biais de transformations XSLT (Extensible Stylesheet Language Transformations).
[in, optional] CompressionMode
facultatif. Une des valeurs InkPersistenceCompressionMode qui spécifie le mode de compression de l’encre persistante.
La valeur par défaut est IPCM_Default.
Nom
Description
IPCM_Default
Est utilisé lorsque le meilleur compromis entre le temps d’économies et le stockage pour l’application classique est nécessaire.
IPCM_MaximumCompression
Est utilisé lorsque la réduction de l’espace de stockage est plus importante que la vitesse d’enregistrement de l’entrée manuscrite.
IPCM_NoCompression
Est utilisé lorsque le temps d’économies est plus important que la quantité d’espace de stockage utilisé et lorsque la compatibilité entre les versions est importante.
[out, retval] Data
Lorsque cette méthode est retournée, contient le tableau d’octets qui contient l’entrée manuscrite persistante.
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_INVALIDARG
Mode de compression non valide.
E_OUTOFMEMORY
Impossible d’allouer un tableau d’octets.
E_UNEXPECTED
Se produit si vous tentez d’enregistrer un objet Ink vide au format GIF.
Remarques
La tentative d’enregistrement d’un objet InkDisp vide au format GIF génère une erreur.
Note Lors de l’appel de la méthode Save avec une valeur InkPersistenceFormat de Base64InkSerializedFormat, la valeur de retour est un tableau d’octets terminé par NULL . Pour écrire l’entrée manuscrite enregistrée dans un fichier XML, supprimez d’abord le dernier octet du tableau avant de convertir le tableau en chaîne encodée au format de transformation Unicode (UTF-8) 8 bits.
Configuration requise
Condition requise
Valeur
Client minimal pris en charge
Windows XP Édition Tablette PC [applications de bureau uniquement]