Класс InkDisp
Представляет собранные росчерки рукописного ввода в пространстве рукописного ввода.
InkDisp имеет следующие типы элементов:
События
Класс InkDisp содержит эти события.
| Событие | Описание |
|---|---|
| InkAdded | Происходит при добавлении росчерка в объект InkDisp . |
| InkDeleted | Происходит при удалении росчерка из объекта InkDisp . |
Интерфейсы
Класс InkDisp определяет эти интерфейсы.
| Интерфейс | Описание |
|---|---|
| IInkDisp | Этот объект реализует COM-интерфейс IInkDisp . |
Методы
Класс InkDisp содержит эти методы.
| Метод | Описание |
|---|---|
| AddStrokesAtRectangle | Вставляет коллекцию росчерков в объект InkDisp в указанном прямоугольнике. |
| CanPaste | Указывает, можно ли преобразовать IDataObject в объект InkDisp . |
| Clip | Удаляет части росчерка или коллекции штрихов, которые находятся за пределами прямоугольника. |
| ClipboardCopy | Копирует коллекцию InkStrokes в буфер обмена. |
| Буфер обменаCopyWithRectangle | Копирует объекты IInkStrokeDisp , содержащиеся в известном прямоугольнике, в буфер обмена. |
| Буфер обменаPaste | Копирует объект IDataObject из буфера обмена в объект InkDisp . |
| Clone | Создает повторяющийся объект InkDisp . |
| CreateStroke | Создает росчерк на основе точек или данных пакетов. |
| CreateStrokes | Создает коллекцию InkStrokes для этого объекта InkDisp . |
| DeleteStroke | Удаляет росчерк из объекта InkDisp . |
| DeleteStrokes | Удаляет штрихи из объекта InkDisp . |
| Метод ExtractStrokes | Извлекает штрихи из объекта InkDisp и возвращает новый объект InkDisp , содержащий извлеченные штрихи. |
| Метод ExtractWithRectangle | Вырезает или копирует штрихи из существующего объекта Класса InkDisp и вставляет их в новый объект Класса InkDisp , используя известный прямоугольник, чтобы определить, какие штрихи следует извлечь. |
| GetBoundingBox | Извлекает ограничивающий прямоугольник всех штрихов в объекте InkDisp . |
| HitTestCircle | Извлекает коллекцию InkStrokes , которая полностью находится внутри или пересекается с помощью известного круга. |
| HitTestWithLasso | Извлекает штрихи в области выбора ломаной линии. |
| HitTestWithRectangle | Извлекает штрихи, содержащиеся в указанном прямоугольнике. |
| Загрузить | Заполняет новый объект InkDisp известными двоичными данными. |
| Ближайшие точки | Извлекает IInkStrokeDisp в объекте InkDisp , ближайшем к известной точке, при необходимости предоставляя дополнительные сведения. |
| Сохранить | Преобразует рукописный ввод в указанный формат и возвращает двоичные данные. |
Свойства
Класс InkDisp имеет следующие свойства.
| Свойство | Тип доступа | Описание |
|---|---|---|
|
CustomStrokes |
Только для чтения |
Возвращает коллекцию IInkCustomStrokes , сохраняемую с помощью рукописного ввода. |
|
Грязные |
Чтение/запись |
Возвращает или задает значение, указывающее, был ли изменен объект InkDisp с момента последнего сохранения рукописного ввода. |
|
ExtendedProperties |
Только для чтения |
Возвращает коллекцию данных, определяемых приложением. |
|
Strokes |
Только для чтения |
Возвращает коллекцию InkStrokes, содержащуюся в объекте InkDisp . |
Комментарии
Этот объект можно создать, вызвав метод CoCreateInstance в C++.
Примечание
При первом создании этого объекта также создается экземпляр GDI+. Побочный эффект заключается в том, что если вы используете один объект рукописного ввода в цикле и создаете и уничтожаете его в цикле, вы будете вызывать создание экземпляра GDI+ снова и снова. Это может привести к снижению производительности приложения. Чтобы избежать этого, всегда сохраняйте один экземпляр объекта рукописного ввода, пока приложение использует рукописный ввод.
Объект InkDisp — это контейнер данных обводки (точки). Данные росчерка или точки, собранные пером, помещаются в объект InkDisp . Свойство Strokes содержит данные для всех штрихов в объекте InkDisp .
Объект InkCollector , объект InkOverlay и элемент управления InkPicture собирает точки с устройства ввода и помещает их в объект InkDisp . Эти объекты по сути действуют в качестве источника, который распределяет рукописный ввод в один или несколько различных объектов InkDisp , которые действуют как контейнеры, в которых хранится распределенный рукописный ввод.
Пространство рукописного ввода — это виртуальное пространство координат, с которым сопоставляются координаты контекста планшета. Это пространство фиксируется в системе координат HIMETRIC. В координатах пространства рукописного ввода перемещение от 0 к 1 равно 1 единице HIMETRIC. Это сопоставление упрощает связывание нескольких объектов InkDisp .
Объект InkRenderer управляет сопоставлениями между рукописным вводом и окном отображения.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows XP Tablet PC Edition [только классические приложения] |
| Минимальная версия сервера |
Ни одна версия не поддерживается |
| Заголовок |
|
| Библиотека |
|