IInkDisp::Load-Methode (msinkaut.h)

Füllt ein neues InkDisp-Objekt mit bekannten Binärdaten auf.

Syntax

HRESULT Load(
  [in] VARIANT Data
);

Parameter

[in] Data

Der Stream, der die Freihanddaten enthält.

Weitere Informationen zur VARIANT-Struktur finden Sie unter Verwenden der COM-Bibliothek.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_INVALIDARG	VARIANT war nicht vom richtigen Typ (Bytearray).
E_OUTOFMEMORY	Speicher für Stream kann nicht zugewiesen werden.
E_UNEXPECTED	Unerwarteter Parameter oder Eigenschaftstyp.
E_INK_EXCEPTION	Innerhalb der -Methode ist eine Ausnahme aufgetreten.

Hinweise

Sie können Freihandeingaben nur in ein neues, leeres InkDisp-Objekt laden, das keine Striche gesammelt hat oder keine angefügten Eigenschaften aufweist. Wenn Sie versuchen, Freihand in ein InkDisp-Objekt zu laden, das Striche oder angefügte Eigenschaften gesammelt hat, wird eine Ausnahme ausgelöst, selbst wenn die Striche oder Eigenschaften aus dem InkDisp-Objekt gelöscht wurden. Dies liegt daran, wie Strich-IDs zugewiesen werden. Einem Strich wird eine eindeutige ID zugewiesen, und diese ID wird nicht wiederverwendet, auch wenn der Strich aus einem Ink-Objekt gelöscht wurde. Dies bedeutet, dass, wenn ein InkDisp-Objekt einen Strich mit der ID 1 enthält und Sie den Strich gelöscht und ein anderes InkDisp-Objekt in dieses InkDisp-Objekt geladen haben, Strich-IDs bei 2 beginnen. Dies wäre verwirrend und ist daher nicht zulässig.

Hinweis Wenn Sie versuchen, Freihandeingabe in ein nicht leeres InkDisp-Objekt zu laden, gehen beim Aufrufen von Load alle Daten im InkDisp-Objekt verloren, einschließlich benutzerdefinierter Striche oder erweiterter Eigenschaften.

 

Mit der Save-Methode können Sie die Freihandeingabe in einem InkDisp-Objekt im GIF-Format (Graphics Interchange Format) beibehalten, das aus einem Array von Bytedaten besteht (das tla_gif Persistenzformat wird im InkPersistenceFormat-Enumerationstyp angegeben). Nachdem Sie über das Array von Bytedaten verfügen, können Sie das Array der Bytedaten in ein anderes InkDisp-Objekt laden. Dies bedeutet, dass Sie GIF-kompatible Bytearraydaten auf die gleiche Weise in ein anderes InkDisp-Objekt laden können, als hätten Sie die Save-Methode aufgerufen und ein Bytearray empfangen, das nicht im GIF-Format vorliegt.

Hinweis Sie können kein Image erstellen, dieses Bild als Bytearray beibehalten und dieses Bytearray dann in ein anderes InkDisp-Objekt laden. Dies liegt daran, dass Tablet PC das Format dieser Daten nicht mehr steuern kann, nachdem Sie Bytearraydaten als GIF geladen haben. Nachdem Sie das Image also erneut in einem Bytearray beibehalten haben, können Sie Load für diese Daten nicht aufrufen.

 

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	msinkaut.h
Bibliothek	InkObj.dll

Weitere Informationen

IInkDisp

InkDisp-Klasse

Save-Methode