Share via

AdviseInkChange 函式 (recapis.h)

  • 發行項

停止辨識器處理筆跡，因為已新增或刪除筆劃。

語法

HRESULT AdviseInkChange(
  HRECOCONTEXT hrc,
  BOOL         bNewStroke
);

參數

hrc

辨識器內容的句柄。

bNewStroke

如果新增筆劃，則為TRUE。 如果筆劃已清除、分割、合併、擷取或刪除，則設定為 FALSE 。

傳回值

此函式可以傳回下列其中一個值。

傳回碼 描述
S_OK
 成功。 如果辨識器不支援此函式，此函式也會傳回S_OK。
E_POINTER
 其中一個參數是無效的指標。
E_FAIL
 發生未指定的錯誤。
E_INVALIDARG
 收到無效的自變數。

備註

建議的InkChange 函式會發出訊號，指出 AddStroke 函式會有額外的呼叫。 這可讓任何正在進行中的辨識在任何便利點停止。 辨識完成是這類點之一，因此 AdviseInkChange 可以安全地執行任何動作。

例如，如果您有兩個線程，一個線程可能會使用 AddStroke 和 Process 搭配其他函式來取得結果。 另一個線程可能會收集筆跡、回應它，以及排入第一個線程的佇列工作。 第二個線程會呼叫 AdviseInkChange 來通知辨識器即將推出變更。 這可讓第一個線程比不呼叫 AdviseInkChange 快回到呼叫端。 第一個線程接著可以使用更多筆跡再次呼叫辨識器。

如果您因為修改或刪除筆劃而將 bNewStroke 參數設定為 FALSE ，您也必須呼叫 ResetContext 函式，然後呼叫 AddStroke 函式，將 InkDisp 物件的筆劃新增至辨識器內容。 如果您將辨識器內容附加至 InkDisp 物件，就會自動完成此動作。

規格需求

需求 值
最低支援的用戶端 Windows XP Tablet PC Edition [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 recapis.h
Dll inkobjcore.dll