共用方式為


SetGuide 函數 (recapis.h)

設定要用於方框或橫線輸入的辨識參考線。 您必須先呼叫此函式,才能將筆畫新增至內容。

語法

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

參數

hrc

辨識器內容的句柄。

pGuide

框或線輸入的指南。 將此參數設定為 Null 表示內容沒有指南。 這是預設值,表示辨識器處於自由輸入模式。 如需指南詳細資訊,請參閱 RECO_GUIDE 結構。

iIndex

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

返回值

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

回傳碼 Description
S_OK
成功。
E_POINTER
內容無效,或其中一個參數是無效的指標。
E_OUTOFMEMORY
無法配置記憶體來完成作業。
E_INVALIDARG
嘗試設定辨識器不支援的辨識模式 (自由、行內、框框等),或RECO_GUIDE欄位值非法 (例如負高度或寬度)。
E_FAIL
發生未指定的錯誤。
TPC_E_OUT_OF_ORDER_CALL
當 reco 內容中已經有一些筆跡時,嘗試設定指南,或者,在東亞字元的辨識器的情況下,先前呼叫 SetCACMode

備註

導引框根據 iIntex 值進行編號。

需求

Requirement 價值觀
最低支援的用戶端 Windows XP Tablet PC 版 [傳統型應用程式 |UWP 應用程式]
支援的最低伺服器 不支援
目標平臺 窗戶
Header recapis.h
Library inkobjcore.lib
DLL inkobjcore.dll

另請參閱

GetGuide 函式

RECO_GUIDE結構