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

Удаляет части объекта IInkStrokeDisp или коллекции InkStrokes , которые находятся за пределами прямоугольника.

Синтаксис

HRESULT Clip(
  [in] IInkRectangle *Rectangle
);

Параметры

[in] Rectangle

Указывает прямоугольник, за пределами которого обрезаются штрихи или штрихи. Прямоугольник указывается в координатах пространства рукописного ввода.

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

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

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

Комментарии

Для объекта InkDisp все штрихи, пересекаемые прямоугольником, разбиваются в точках пересечения. Все части штрихов за пределами прямоугольника удаляются из объекта InkDisp . Метод может добавлять новые точки к штриху в точке, где штрих пересекается с прямоугольником. После вызова метода Clip для объекта InkDisp идентификаторы штрихов в коллекции штрихов объекта InkDisp гарантированно будут уникальными, но не гарантируют сохранение других сведений.

Этот метод не учитывает ширину пера при отсечении. Он обрезает только фактические данные рукописного ввода или росчерка .

Для объекта IInkStrokeDisp или коллекции InkStrokes метод Clip обновляет родительский объект InkDisp . При удалении рукописного фрагмента из объекта InkDisp все объекты IInkStrokeDisp или коллекции InkStrokes, определенные для этого объекта InkDisp , могут быть признаны недействительными.

Дополнительные сведения о данных рукописного ввода см. в разделе Данные рукописного ввода.

Требования

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

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

Метод HitTest(Rectangle, Single)

IInkDisp

Класс InkDisp

Класс InkRectangle