SetGuide 函式 (recapis.h)

設定用於 Boxed 或 lined 輸入的辨識指南。您必須先呼叫此函式，才能將筆劃新增至內容。

語法

HRESULT SetGuide(
  HRECOCONTEXT     hrc,
  const RECO_GUIDE *pGuide,
  ULONG            iIndex
);

hrc

辨識器內容的句柄。

pGuide

用於方塊或線條輸入的指南。將此參數設定為 NULL 表示內容沒有指南。這是預設值，表示辨識器處於免費輸入模式。如需指南詳細數據，請參閱 RECO_GUIDE 結構。

iIndex

要用於內容中第一個方塊或行的索引值。

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

傳回碼	描述
S_OK	成功。
E_POINTER	內容無效，或其中一個參數是無效的指標。
E_OUTOFMEMORY	無法配置記憶體來完成作業。
E_INVALIDARG	嘗試設定辨識模式 (免費、換行、Boxed 等) ，或RECO_GUIDE域值不合法，例如 () 。
E_FAIL	發生未指定的錯誤。
TPC_E_OUT_OF_ORDER_CALL	嘗試在 reco 內容中已經有一些筆跡時設定指南，或者，在東亞字元辨識器的情況下，先前會呼叫 SetCACMode 。

參考線方塊是根據 iIntex 值編號。

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