Метод IInkStrokes::Clip (msinkaut.h)
Удаляет части объекта IInkStrokeDisp или коллекции InkStrokes , которые находятся за пределами прямоугольника.
Синтаксис
HRESULT Clip(
[in] IInkRectangle *Rectangle
);
Параметры
[in] Rectangle
Указывает прямоугольник, за пределами которого обрезаются штрихи или штрихи. Прямоугольник указывается в координатах пространства рукописного ввода.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Код возврата | Описание |
|---|---|
|
Успешно. |
|
Параметр содержит недопустимый указатель. |
|
Объект InkDisp не зарегистрирован. |
|
Недопустимый прямоугольник клипа. |
|
В методе произошло исключение. |
|
Произошла неизвестная ошибка. |
Комментарии
Для объекта InkDisp все штрихи, пересекаемые прямоугольником, разбиваются в точках пересечения. Все части штрихов за пределами прямоугольника удаляются из объекта InkDisp . Метод может добавлять новые точки к штриху в точке, где штрих пересекается с прямоугольником. После вызова метода Clip для объекта InkDisp идентификаторы штрихов в коллекции штрихов объекта InkDisp гарантированно будут уникальными, но не гарантируют сохранение других сведений.
Этот метод не учитывает ширину пера при отсечении. Он обрезает только фактические данные рукописного ввода или росчерка.
Для объекта IInkStrokeDisp или коллекции InkStrokes метод Clip обновляет родительский объект InkDisp . При удалении рукописного фрагмента из объекта InkDisp все объекты IInkStrokeDisp или коллекции InkStrokes, определенные для этого объекта InkDisp , могут быть признаны недействительными.
Дополнительные сведения о данных рукописного ввода см. в разделе Данные рукописного ввода.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP Tablet PC Edition [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | msinkaut.h |
| Библиотека | InkObj.dll |