設定要用於方框或橫線輸入的辨識參考線。 您必須先呼叫此函式,才能將筆畫新增至內容。
語法
HRESULT SetGuide(
HRECOCONTEXT hrc,
const RECO_GUIDE *pGuide,
ULONG iIndex
);
參數
hrc
辨識器內容的句柄。
pGuide
框或線輸入的指南。 將此參數設定為 Null 表示內容沒有指南。 這是預設值,表示辨識器處於自由輸入模式。 如需指南詳細資訊,請參閱 RECO_GUIDE 結構。
iIndex
用於內容中第一個方塊或行的索引值。
返回值
此函式可以傳回其中一個值。
| 回傳碼 | Description |
|---|---|
|
成功。 |
|
內容無效,或其中一個參數是無效的指標。 |
|
無法配置記憶體來完成作業。 |
|
嘗試設定辨識器不支援的辨識模式 (自由、行內、框框等),或RECO_GUIDE欄位值非法 (例如負高度或寬度)。 |
|
發生未指定的錯誤。 |
|
當 reco 內容中已經有一些筆跡時,嘗試設定指南,或者,在東亞字元的辨識器的情況下,先前呼叫 SetCACMode 。 |
備註
導引框根據 iIntex 值進行編號。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows XP Tablet PC 版 [傳統型應用程式 |UWP 應用程式] |
| 支援的最低伺服器 | 不支援 |
| 目標平臺 | 窗戶 |
| Header | recapis.h |
| Library | inkobjcore.lib |
| DLL | inkobjcore.dll |