InkPresenter.ActivateCustomDrying Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Указывает, что приложению требуется полный контроль над отрисовкой рукописного ввода.
По умолчанию рукописные данные обрабатываются в фоновом потоке с низкой задержкой и отображаются как «влажные» в процессе ввода. После завершения росчерка (нажатие пера или нажатия кнопки мыши) он обрабатывается в потоке пользовательского интерфейса и отображается "сухим" на уровне отрисовки (над содержимым приложения и заменой мокрого рукописного фрагмента).
Модели размещения InkPresenter
Вызывая ActivateCustomDrying (до загрузки элемента InkCanvas), приложение создает объект InkSynchronizer, чтобы настроить отображение росчерка пера сухим в SurfaceImageSource или VirtualSurfaceImageSource. Например, росчерк пера можно преобразовать в растровый формат и интегрировать в содержимое приложения вместо отдельного слоя InkCanvas.
InkDesktopHost (Windows 10 версии 1511 и более поздних версий)
Приложения Win32 могут размещать InkPresenter в InkDesktopHost с помощью визуального дерева DirectComposition.
Для этого требуется объект IInkD2DRenderer для управления вводом рукописного ввода (см. пример сложного рукописного ввода).
CoreInkPresenterHost (Windows 10 Fall Creators Update и более новые версии)
Разместите InkPresenter в вашей windows.Пользовательского интерфейса.Дерево композиции без связанного элемента управления InkCanvas .
public:
virtual InkSynchronizer ^ ActivateCustomDrying() = ActivateCustomDrying;
InkSynchronizer ActivateCustomDrying();
public InkSynchronizer ActivateCustomDrying();
function activateCustomDrying()
Public Function ActivateCustomDrying () As InkSynchronizer
Возвращаемое значение
Объект, используемый для пользовательской отрисовки росчерка рукописного ввода.
Комментарии
Коды ошибок
E_ILLEGAL_METHOD_CALL (0x8000000E)
Возникает при вызове ActivateCustomDrying после загрузки InkCanvas .
Этот метод необходимо вызвать перед загрузкой InkCanvas.
Пользовательская сушка и InkToolbar
По умолчанию рукописные данные обрабатываются в фоновом потоке с низкой задержкой и отображаются как «влажные» в процессе ввода. После завершения росчерка (когда пользователь поднял перо или палец либо отпустил кнопку мыши) росчерк обрабатывается в потоке пользовательского интерфейса и отображается «сухим» на слое InkCanvas (над содержимым приложения, вместо влажных рукописных данных). Платформа рукописного ввода позволяет переопределить это поведение и полностью настроить рукописный ввод за счет пользовательской сушки рукописных данных.
Если приложение переопределяет поведение отрисовки рукописного ввода по умолчанию InkPresenter с помощью пользовательской реализации сушки, отрисованные росчерки пера больше не доступны для InkToolbar , а встроенные команды очистки InkToolbar не работают должным образом. Для реализации функции стирания необходимо обрабатывать все события указателя, выполнять проверку нажатия для каждого штриха и переопределить встроенную команду «Удалить все рукописные данные».
Дополнительные сведения о пользовательской сушке см. в разделе Взаимодействие с пером и Windows Ink в приложениях UWP.
Применяется к
См. также раздел
- Взаимодействие с помощью пера
- Начало работы: поддержка рукописного ввода в приложении UWP
- Пример анализа рукописного ввода (базовый) (C#)
- Пример распознавания рукописного ввода (C#)
- Сохранение и загрузка росчерков пера из файла Ink Serialized Format (ISF)
- Сохранение и загрузка росчерков пера из буфера обмена
- Пример расположения и ориентации панели инструментов рукописного ввода (базовый)
- Пример расположения и ориентации панели инструментов рукописного ввода (динамичный)
- Пример раскраски
- Пример семейных заметок
- Пример рукописного ввода (JavaScript)
- Пример простого рукописного ввода (C#/C++)
- Пример сложного рукописного ввода (C++)
- Пример анализа рукописного ввода