Метод IInkDisp::Load (msinkaut.h)

Статья
08/24/2023

Заполняет новый объект 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 , который не является пустым, все данные в объекте InkDisp , включая любые пользовательские штрихи или расширенные свойства, будут потеряны при вызове Load.

Метод Save позволяет сохранять рукописный ввод в объекте InkDisp в формате GIF, который состоит из массива байтовых данных (формат сохраняемости tla_gif указан в типе перечисления InkPersistenceFormat ). Получив массив байтовых данных, можно загрузить массив байтовых данных в другой объект InkDisp . Это означает, что данные массива байтов, совместимые с GIF, можно загрузить в другой объект InkDisp так же, как если бы вы вызвали метод Save и получили массив байтов, который не был в формате GIF.

Примечание Невозможно создать изображение, сохранить его в виде массива байтов, а затем загрузить этот массив байтов в другой объект InkDisp . Это связано с тем, что после загрузки данных массива байтов в виде GIF планшетный компьютер не может управлять форматом этих данных. Таким образом, после повторного сохранения изображения в массиве байтов вы не сможете вызвать load для данных.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	msinkaut.h
Библиотека	InkObj.dll

См. также раздел

IInkDisp

Класс InkDisp

Метод Save

Поделиться через