InkPresenter.ActivateCustomDrying Метод

  • Ссылка

Определение

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

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

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

Модели размещения InkPresenter

InkCanvas

Вызывая 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

Возвращаемое значение

InkSynchronizer

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

Комментарии

Коды ошибок

E_ILLEGAL_METHOD_CALL (0x8000000E)

Возникает при вызове ActivateCustomDrying после загрузки InkCanvas .

Этот метод необходимо вызвать перед загрузкой InkCanvas.

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

Если приложение переопределяет поведение отрисовки рукописного ввода по умолчанию InkPresenter с помощью пользовательской реализации сушки, отрисованные росчерки пера больше не доступны для InkToolbar , а встроенные команды очистки InkToolbar не работают должным образом. Для реализации функции стирания необходимо обрабатывать все события указателя, выполнять проверку нажатия для каждого штриха и переопределить встроенную команду «Удалить все рукописные данные».

Дополнительные сведения о пользовательской сушке см. в разделе Взаимодействие с пером и Windows Ink в приложениях UWP.

Применяется к

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