Windows.UI.Input.Inking Пространство имен

Обеспечивает поддержку ввода, обработки и управления для Windows Ink приложений. В том числе:

  • Рисование росчерков пером.
  • Захват штрихов.
  • Отрисовка росчерков.
  • Выделение штрихов.
  • Удаление штрихов.
  • Сохранение и загрузка штрихов.
  • Преобразование росчерков в текст с помощью распознавания рукописного ввода.
  • Копирование и вставка штрихов из буфера обмена.
  • Проверка попадания (или нацеливание на ход).

Классы

InkDrawingAttributes

Предоставляет свойства, связанные с рисунком inkStroke.

InkDrawingAttributesPencilProperties

Предоставляет набор статических свойств InkDrawingAttributes для отрисовки росчерка карандаша в InkCanvas.

Получите экземпляр этого класса, вызвав InkDrawingAttributes.CreateForPencil и перейдя к InkDrawingAttributes.PencilProperties.

InkInputConfiguration

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

InkInputProcessingConfiguration

Управляет обработкой входных данных объектом InkPresenter .

InkManager

Примечание

Для универсальных приложений для Windows, использующих xaml, рекомендуется использовать InkPresenter и элемент управления InkCanvas вместо InkManager.

Управляет вводом, обработкой и обработкой (включая распознавание рукописного ввода) одного или нескольких объектов InkStroke .

InkModelerAttributes

Определяет, какие типы атрибутов моделира рукописного ввода могут обрабатываться объектом InkPresenter .

InkPoint

Предоставляет необработанные входные данные для одной точки, используемой при построении InkStroke.

InkPresenter

Предоставляет свойства, методы и события для управления вводом, обработкой и отрисовкой рукописного ввода (стандартного и измененного) для элемента управления InkCanvas .

InkPresenterProtractor

Представляет визуальный набор элементов в виде протяжителя для рисования дуг и кривых, отображаемый в виде полупрозрачного наложения на inkCanvas.

Набор элементов преобразует способ отрисовки росчерка пера:

  • Он прикрепляет росчерк пера к краю трафарета, если кончик пера находится в пределах порогового расстояния (желоб).
  • Он действует как маска и предотвращает рисование росчерка пера в области, скрытой трафаретом.

InkPresenterRuler может управляться как программными средствами, так и пользователем. Он также масштабирует и преобразует с помощью InkCanvas.

InkPresenterRuler

Представляет визуальный набор элементов в виде правила прямого рисования прямых линий, отображаемого в виде полупрозрачного наложения на inkCanvas.

Набор элементов преобразует способ отрисовки росчерка пера:

  • Он прикрепляет росчерк пера к краю трафарета, если кончик пера находится в пределах порогового расстояния (желоб).
  • Он действует как маска и предотвращает рисование росчерка пера в области, скрытой трафаретом.

InkPresenterRuler может управляться как программными средствами, так и пользователем. Он также масштабирует и преобразует с помощью InkCanvas.

InkRecognitionResult

Предоставляет свойства и методы для управления данными распознавания рукописного ввода InkStroke .

Результаты распознавания создаются для каждого слова, обнаруженного InkRecognizer.

InkRecognizer

Управляет всеми аспектами распознавания рукописного ввода.

InkRecognizerContainer

Предоставляет свойства и методы для управления одним или несколькими объектами InkRecognizer , используемыми для распознавания рукописного ввода.

InkRecognizerContainer имеет значение NULL, если подсистема распознавания недоступна в системе.

InkStroke

Один росчерк пера, включая параметры кривой Безье, используемые для окончательной отрисовки росчерка.

InkStrokeBuilder

Создает штрихи из необработанных входных данных указателя.

Примечание

Для универсальных приложений для Windows, использующих xaml, рекомендуется использовать InkPresenter и элемент управления InkCanvas вместо InkManager.

Используйте CreateStrokeFromInkPoints и SetDefaultDrawingAttributes для программного построения штрихов для InkPresenter.

InkStrokeContainer

Предоставляет свойства и методы для хранения коллекции объектов InkStroke, отображаемой InkPresenter, и управления ею.

Изменения, внесенные в любой из росчерков пера в контейнере росчерков, сразу же отрисовываются в поверхности рисования, связанной с InkPresenter.

InkStrokeInput

Предоставляет свойства и события для StrokeInput, связанных с объектом InkPresenter .

InkStrokeRenderingSegment

Один сегмент полного росчерка пера.

Один сегмент состоит из начальной точки, конечной точки и двух контрольных точек Безье. Однако для ряда сегментов, составляющих росчерк, последняя точка предыдущего сегмента является первой точкой текущего сегмента. Это означает, что для представления полного росчерка требуется только конечная точка для каждого сегмента.

Каждый штрих является вектором объектов InkStrokeRenderingSegment с первым сегментом, определяемым одной начальной точкой, и всеми остальными сегментами, определяемыми конечной точкой и двумя контрольными точками Безье.

InkStrokesCollectedEventArgs

Содержит данные события strokesCollectedобъекта InkPresenter , связанного с элементом управления InkCanvas .

По умолчанию росчерк пера обрабатывается в фоновом потоке с низкой задержкой и отображается мокрым при рисовании. После завершения росчерка (нажатие пера или нажатия кнопки мыши) штрих обрабатывается в потоке пользовательского интерфейса и отображается сухим на уровне InkCanvas (над содержимым приложения). Если поток пользовательского интерфейса занят, при появлении потока может быть обработано (собрано) несколько росчерков рукописного ввода.

Это поведение можно переопределить, вызвав метод ActivateCustomDrying перед загрузкой InkCanvas.

InkStrokesErasedEventArgs

Содержит данные события для события StrokesErasedобъекта InkPresenter, связанного с элементом управления InkCanvas .

По умолчанию данные росчерка рукописного ввода и отрисовка полностью управляются элементом управления InkCanvas . Однако это поведение можно переопределить, вызвав метод ActivateCustomDrying перед загрузкой InkCanvas.

InkSynchronizer

Управляет синхронизацией рукописного ввода и предоставляет методы для его отображения в контексте устройства Direct2D универсального приложения для Windows вместо элемента управления InkCanvas по умолчанию. Для этого требуется объект IInkD2DRenderer для управления вводом рукописного ввода (см. пример сложного рукописного ввода).

По умолчанию рукописные данные обрабатываются в фоновом потоке с низкой задержкой и отображаются как «влажные» в процессе ввода. После завершения росчерка (когда пользователь поднял перо или палец либо отпустил кнопку мыши) росчерк обрабатывается в потоке пользовательского интерфейса и отображается «сухим» на слое InkCanvas (над содержимым приложения, вместо влажных рукописных данных).

Вызывая ActivateCustomDrying (до загрузки элемента InkCanvas), приложение создает объект InkSynchronizer, чтобы настроить отображение росчерка пера сухим в SurfaceImageSource или VirtualSurfaceImageSource. Например, росчерк пера можно преобразовать в растровый формат и интегрировать в содержимое приложения вместо отдельного слоя InkCanvas.

InkUnprocessedInput

Предоставляет свойства и события для пользовательской обработки рукописных данных из элемента управления InkCanvas . Данные не обрабатываются InkPresenter.

Используйте InkInputProcessingConfiguration , чтобы определить данные для передачи как UnprocessedInput.

PenAndInkSettings

Предоставляет доступ к пользовательским параметрам, связанным с приемом и преобразованием рукописного ввода в текстовый ввод в элементе управления текстом (при включении HandwritingView ).

Интерфейсы

IInkPointFactory

Определяет реализацию для типа, который создает объекты InkPoint , используемые при построении InkStroke.

IInkPresenterRulerFactory

Определяет реализацию для типа, который создает объекты InkPresenterRuler , используемые при построении InkPresenter.

IInkPresenterStencil

Представляет визуальный набор элементов, отображаемый в виде полупрозрачного наложения на InkCanvas.

Набор элементов преобразует способ отрисовки росчерка пера:

  • Он прикрепляет росчерк пера к краю трафарета, если кончик пера находится в пределах порогового расстояния (желоб).
  • Он действует как маска и предотвращает рисование росчерка пера в области, скрытой трафаретом.

Набор элементов может управляться как программными средствами, так и пользователем. Он также масштабирует и преобразует с помощью InkCanvas.

IInkRecognizerContainer

Представляет один или несколько объектов InkRecognizer .

IInkStrokeContainer

Представляет диспетчер для коллекции объектов InkStroke , отображаемых inkPresenter.

Изменения, внесенные в любой из росчерков пера в контейнере росчерков, сразу же отрисовываются в поверхности рисования, связанной с InkPresenter.

Перечисления

HandwritingLineHeight

Задает пространство рукописного ввода, доступное при использовании рукописного ввода для ввода текста в элементе управления текстом (если включен параметр HandwritingView ).

InkDrawingAttributesKind

Указывает тип атрибутов InkDrawingAttributes , связанных с inkStroke.

InkHighContrastAdjustment

Указывает, как объект InkPresenter обрабатывает входные данные (стандартные и измененные) из связанного элемента управления InkCanvas , когда система находится в режиме высокой контрастности.

InkInputProcessingMode

Указывает, как объект InkPresenter интерпретирует входные данные из связанного элемента управления InkCanvas .

По умолчанию входные данные обрабатываются как стандартные росчерки рукописного ввода или стирания или могут быть переданы в приложение как UnprocessedInput для пользовательской обработки.

InkInputRightDragAction

Указывает, как объект InkPresenter обрабатывает вторичные входные данные с кнопки пера, кончика ластика пера, правой кнопки мыши или аналогичного типа.

По умолчанию эти вторичные входные данные обрабатываются как основные входные данные и преобразуются в inkStroke (см. примечания).

InkManipulationMode

Задает режимы ввода рукописного ввода.

InkPersistenceFormat

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

InkPresenterPredefinedConfiguration

Указывает поведение рукописного ввода для одной или нескольких точек контакта. Используется с SetPredefinedConfiguration.

InkPresenterStencilKind

Указывает тип набора элементов, который может отображаться в InkCanvas.

InkRecognitionTarget

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

PenHandedness

Определяет предпочтительную рукописную руку, указанную пользователем в разделе Параметры —> Устройства —> & Windows Ink пера —> Выберите, с помощью какой руки вы пишете.

PenTipShape

Идентифицирует форму подсказки пера.

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