InkPresenter.ActivateCustomDrying 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
指示应用需要完全控制墨迹输入呈现。
默认情况下,墨迹输入在低延迟后台线程上进行处理,并在绘制时呈现“墨迹未干”。 笔划完成 (笔或手指抬起,或者鼠标按钮松开) 时,笔划在 UI 线程上进行处理,并“干”呈现到应用程序内容上方 (呈现层,并替换湿墨) 。
InkPresenter 托管模型
通过调用 ActivateCustomDrying(在加载 InkCanvas 之前),应用创建 InkSynchronizer 对象以自定义如何向 SurfaceImageSource 或 VirtualSurfaceImageSource 呈现墨迹已干的笔划墨迹。 例如,笔划墨迹可以光栅化并集成到应用程序内容中,而非作为单独的 InkCanvas 图层。
InkDesktopHost (Windows 10 版本 1511 及更新的)
Win32 应用可以使用 DirectComposition 可视化树在 InkDesktopHost 中托管 InkPresenter。
这需要 IInkD2DRenderer 对象来管理墨迹输入 (查看 复杂墨迹示例) 。
CoreInkPresenterHost (Windows 10 Fall Creators Update 及更新)
在你自己的 Windows 中托管 InkPresenter。Ui。没有关联 InkCanvas 控件的合成树。
public:
virtual InkSynchronizer ^ ActivateCustomDrying() = ActivateCustomDrying;
InkSynchronizer ActivateCustomDrying();
public InkSynchronizer ActivateCustomDrying();
function activateCustomDrying()
Public Function ActivateCustomDrying () As InkSynchronizer
返回
用于自定义墨迹笔划呈现的对象。
注解
错误代码
E_ILLEGAL_METHOD_CALL (0x8000000E)
如果在加载 InkCanvas 后调用 ActivateCustomDrying,则引发。
必须在加载 InkCanvas 之前调用此方法。
自定义干燥和 InkToolbar
默认情况下,墨迹输入在低延迟后台线程上进行处理,并在绘制时呈现“墨迹未干”。 笔划完成时(抬起笔或手指,或者释放鼠标按钮),笔划将在 UI 线程上进行处理并向 InkCanvas 图层呈现“墨迹已干”(在应用程序内容之上,并且替换未干墨迹)。 墨迹平台支持你替代此行为并通过自定义烘干墨迹输入来完全自定义墨迹书写体验。
如果应用使用自定义干燥实现替代 InkPresenter 的默认墨迹呈现行为,则呈现的墨迹笔划不再可用于 InkToolbar , 并且 InkToolbar 的内置擦除命令无法按预期工作。 若要提供擦除功能,必须处理所有指针事件、在每个笔划上执行命中测试,并替代内置的“清除所有墨迹”命令。
有关自定义烘干的详细信息,请参阅 UWP 应用中的笔交互和 Windows Ink。