Метод IInkStrokeDisp::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 |