Класс InkDisp

Статья
06/13/2023

Представляет собранные росчерки рукописного ввода в пространстве рукописного ввода.

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 .

При первом создании этого объекта также создается экземпляр GDI+. Побочный эффект заключается в том, что если вы используете один объект рукописного ввода в цикле и создаете и уничтожаете его в цикле, вы будете вызывать создание экземпляра GDI+ снова и снова. Это может привести к снижению производительности приложения. Чтобы избежать этого, всегда сохраняйте один экземпляр объекта рукописного ввода, пока приложение использует рукописный ввод.

Объект InkDisp — это контейнер данных обводки (точки). Данные росчерка или точки, собранные пером, помещаются в объект InkDisp . Свойство Strokes содержит данные для всех штрихов в объекте InkDisp .

Объект InkCollector , объект InkOverlay и элемент управления InkPicture собирает точки с устройства ввода и помещает их в объект InkDisp . Эти объекты по сути действуют в качестве источника, который распределяет рукописный ввод в один или несколько различных объектов InkDisp , которые действуют как контейнеры, в которых хранится распределенный рукописный ввод.

Пространство рукописного ввода — это виртуальное пространство координат, с которым сопоставляются координаты контекста планшета. Это пространство фиксируется в системе координат HIMETRIC. В координатах пространства рукописного ввода перемещение от 0 к 1 равно 1 единице HIMETRIC. Это сопоставление упрощает связывание нескольких объектов InkDisp .

Объект InkRenderer управляет сопоставлениями между рукописным вводом и окном отображения.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Заголовок	Msinkaut.h (также требуется Msinkaut_i.c)
Библиотека	InkObj.dll

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

Интерфейс IInkStrokeDisp
Коллекция InkStrokes
Интерфейс IInkTablet