InkPresenter.ActivateCustomDrying 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
表示您的應用程式需要完全控制筆跡輸入轉譯。
根據預設,筆墨輸入是在低延遲背景執行緒上處理,並在其繪製期間轉譯為「濕潤」狀態。 當筆劃完成 (畫筆或手指隨即放開,或放開滑鼠按鍵) 時,會在 UI 執行緒上處理筆劃,並將「幹」轉譯至應用程式內容上方的轉譯層 (,並取代濕度筆跡) 。
InkPresenter 裝載模型
藉由呼叫 ActivateCustomDrying (在載入 InkCanvas 之前),app 會建立 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 使用,且 InkToolbar 的內建清除命令無法如預期般運作。 若要提供清除功能,就必須處理所有指標事件、對每一個筆劃執行點擊測試,並且覆寫內建的「清除所有筆跡」命令。
如需自訂乾燥的詳細資訊,請參閱 UWP 應用程式中的手寫筆互動與 Windows Ink。