Konvertiert die Freihandeingabe in das angegebene InkPersistenceFormat, speichert die Freihandeingabe mithilfe des angegebenen InkPersistenceCompressionMode und gibt die Binärdaten in einem Bytearray zurück.
Optional. Legt einen der InkPersistenceFormat-Werte fest, der das Format des persistenten Freihands angibt. Der Standardwert ist InkSerializedFormat.
Name
BESCHREIBUNG
InkSerializedFormat
Freihand wird mithilfe des serialisierten Freihandformats (ISF) beibehalten.
Dabei handelt es sich um die kompakteste permanente Freihanddarstellung. Sie kann in ein binäres Dokumentformat eingebettet oder direkt in der Zwischenablage platziert werden. Dies ist der Standardwert.
Base64InkSerializedFormat
Freihand wird beibehalten, indem die ISF als Base64-Stream codiert wird.
Dieses Format wird bereitgestellt, sodass Freihand direkt in einer XML- oder HTML-Datei (Extensible Markup Language) codiert werden kann.
Gif
Freihand wird beibehalten, indem eine GIF-Datei (Graphics Interchange Format) verwendet wird, die ISF als Metadaten enthält, die in die Datei eingebettet sind.
Dadurch kann Freihand in Anwendungen angezeigt werden, die nicht freihandfähig sind, und die volle Freihandtreue beibehalten, wenn sie zu einer freihandfähigen Anwendung zurückkehrt. Dieses Format eignet sich ideal für den Transport von Freihandinhalten in einer HTML-Datei und macht sie für freihandfähige und nicht bekannte Anwendungen nutzbar.
Base64Gif
Die Freihandeingabe wird mithilfe eines base64-codierten Befestigten beibehalten.
Dieses GIFformat wird bereitgestellt, wenn Freihand direkt in einer XML- oder HTML-Datei mit späterer Konvertierung in ein Bild codiert werden soll. Dies kann in einem XML-Format verwendet werden, das generiert wird, um alle Freihandinformationen zu enthalten und als Möglichkeit zum Generieren von HTML durch Xslt (Extensible Stylesheet Language Transformations) verwendet wird.
[in, optional] CompressionMode
Optional. Einer der InkPersistenceCompressionMode-Werte , der den Komprimierungsmodus der persistenten Freihandeingabe angibt.
Der Standardwert ist IPCM_Default.
Name
BESCHREIBUNG
IPCM_Default
Wird verwendet, wenn der beste Kompromiss zwischen Zeitersparnis und Speicher für die typische Anwendung erforderlich ist.
IPCM_MaximumCompression
Wird verwendet, wenn die Minimierung des Speicherplatzes wichtiger ist als die Geschwindigkeit der Freihandspeicherung.
IPCM_NoCompression
Wird verwendet, wenn Zeitersparnis wichtiger ist als die Menge des verwendeten Speicherplatzes und wenn die Kompatibilität zwischen Versionen wichtig ist.
[out, retval] Data
Wenn diese Methode zurückgibt, enthält das Bytearray, das die persistente Freihand enthält.
Diese Methode kann einen dieser Werte zurückgeben.
Rückgabecode
BESCHREIBUNG
S_OK
Erfolg.
E_POINTER
Ein Parameter enthielt einen ungültigen Zeiger.
E_INK_EXCEPTION
Innerhalb der -Methode ist eine Ausnahme aufgetreten.
E_INVALIDARG
Ungültiger Komprimierungsmodus.
E_OUTOFMEMORY
Bytearray kann nicht zugeordnet werden.
E_UNEXPECTED
Tritt auf, wenn Sie versuchen, ein leeres Freihandobjekt im GIF-Format zu speichern.
Hinweise
Beim Versuch, ein leeres InkDisp-Objekt im GIF-Format zu speichern, wird ein Fehler generiert.
Hinweis Beim Aufrufen der Save-Methode mit einem InkPersistenceFormat-Wert von Base64InkSerializedFormat ist der Rückgabewert ein NULL -beendetes Bytearray. Um die gespeicherte Freihandeingabe in eine XML-Datei zu schreiben, entfernen Sie zuerst das letzte Byte aus dem Array, bevor Sie das Array in eine UTF-8-codierte Zeichenfolge (8-Bit Unicode Transformation Format) konvertieren.