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

Вырезает или копирует штрихи из существующего объекта InkDisp и вставляет их в новый объект InkDisp , используя известный прямоугольник, чтобы определить, какие штрихи следует извлечь.

Синтаксис

HRESULT ExtractWithRectangle(
  [in]           IInkRectangle   *Rectangle,
  [in, optional] InkExtractFlags extractFlags,
  [out, retval]  IInkDisp        **ExtractedInk
);

Параметры

[in] Rectangle

Указывает объект InkRectangle , который разделяет рукописный фрагмент, извлекаемый из объекта InkDisp .

[in, optional] extractFlags

Необязательный элемент. Указывает тип перечисления InkExtractFlags , который определяет, следует ли вырезать или скопировать рукописный фрагмент из существующего объекта InkDisp . Значение по умолчанию — IEF_DEFAULT, который вырезает штрихи из существующего объекта InkDisp .

[out, retval] ExtractedInk

При возврате этим методом содержит указатель на объект InkDisp , содержащий извлеченную коллекцию штрихов.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата	Описание
S_OK	Успешно.
E_POINTER	Параметр содержит недопустимый указатель.
E_INK_EXCEPTION	В методе произошло исключение.
E_INK_SOME_STROKES_NOT_EXTRACTED	Не все штрихи были извлечены.
E_OUTOFMEMORY	Не удается выделить память для завершения операции.
E_INVALIDARG	Недопустимые флаги извлечения.
REGDB_CLASSNOTREG	Объект Ink не зарегистрирован.

Комментарии

Новый объект InkDisp сохраняет атрибуты, свойства и координаты исходного объекта InkDisp .

Этот метод полезен для создания нового объекта InkDisp без удаления или вырезанных штрихов исходного объекта.

Чтобы извлечь штрихи из известной коллекции штрихов, вызовите метод ExtractStrokes.

К новому объекту InkDisp добавляется только часть росчерка внутри прямоугольника.

Если параметр extractFlags имеет значение RemoveFromOriginal или Default, все штрихи, пересекаемые прямоугольником, разделяются, а часть прямоугольника удаляется из существующего объекта InkDisp .

Требования

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

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

Метод ExtractStrokes

IInkDisp

Класс InkDisp

Перечисление InkExtractFlags

Класс InkRectangle

Коллекция InkStrokes