IInkDisp：：Load 方法 (msinkaut.h)

  • 發行項

使用已知的二進位數據填入新的 InkDisp 物件。

語法

HRESULT Load(
  [in] VARIANT Data
);

參數

[in] Data

包含筆跡數據的數據流。

如需 VARIANT 結構的詳細資訊，請參閱 使用 COM 連結庫。

傳回值

這個方法可以傳回其中一個值。

傳回碼 描述
S_OK
 成功。
E_INVALIDARG
 VARIANT 的類型不正確， (位元組陣列) 。
E_OUTOFMEMORY
 無法為 Stream 配置記憶體。
E_UNEXPECTED
 非預期的參數或屬性類型。
E_INK_EXCEPTION
 方法內發生例外狀況。

備註

您只能將筆跡載入新的空白 InkDisp 物件 - 未收集任何筆劃或沒有任何附加屬性的物件。 如果您嘗試將筆跡載入已收集筆劃或附加屬性的 InkDisp 物件，即使筆劃或屬性已從 InkDisp 物件中刪除，也會擲回例外狀況。 這是因為如何指派筆劃標識碼。 筆劃會指派唯一標識符，而且即使筆劃已從 Ink 物件中刪除，也不會重複使用此識別符。 這表示，如果 InkDisp 物件包含標識符為 1 的筆劃，而且您刪除筆劃並將另一個 InkDisp 物件載入此 InkDisp 物件，筆劃標識符會從 2 開始。 這會造成混淆，因此不允許這麼做。

注意如果您嘗試將筆跡載入非空白的 InkDisp 物件，則當您呼叫 Load 時，InkDisp 物件中的所有資料都會遺失，包括任何自定義筆劃或擴充屬性。
 
Save 方法可讓您將 InkDisp 物件中的筆墨保存在圖形交換格式 (GIF) 格式中，此格式是由位元組數據的數位所組成， (tla_gif 持續性格式是在 InkPersistenceFormat 列舉類型) 中指定。 取得位元組資料的陣列之後，您可以將位元組資料的陣列載入另一個 InkDisp 物件。 這表示您可以將 GIF 相容的位元組數位資料載入另一個 InkDisp 物件，就像您呼叫 Save 方法，並收到不是 GIF 格式的位元組數位一樣。
注意 您無法建立影像、將該影像保存為位元組陣列，然後將該位元組陣組載入另一個 InkDisp 物件。 這是因為當您將位元組數位數據載入為 GIF 之後，平板電腦就無法控制該資料的格式。 因此，在您再次將映像保存到位元組陣組之後，就無法在該數據上呼叫 Load 。
 

規格需求

需求 值
最低支援的用戶端 Windows XP Tablet PC Edition [僅限傳統型應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 msinkaut.h
程式庫 InkObj.dll

另請參閱

IInkDisp

InkDisp 類別

Save 方法