共用方式為


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 方法