Метод 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 , содержащий извлеченную коллекцию штрихов.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Код возврата | Описание |
|---|---|
|
Успешно. |
|
Параметр содержит недопустимый указатель. |
|
В методе произошло исключение. |
|
Не все штрихи были извлечены. |
|
Не удается выделить память для завершения операции. |
|
Недопустимые флаги извлечения. |
|
Объект Ink не зарегистрирован. |
Комментарии
Новый объект InkDisp сохраняет атрибуты, свойства и координаты исходного объекта InkDisp .
Этот метод полезен для создания нового объекта InkDisp без удаления или вырезанных штрихов исходного объекта.
Чтобы извлечь штрихи из известной коллекции штрихов, вызовите метод ExtractStrokes.
К новому объекту InkDisp добавляется только часть росчерка внутри прямоугольника.
Если параметр extractFlags имеет значение RemoveFromOriginal или Default, все штрихи, пересекаемые прямоугольником, разделяются, а часть прямоугольника удаляется из существующего объекта InkDisp .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP Tablet PC Edition [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | msinkaut.h |
| Библиотека | InkObj.dll |