getUnicodeRanges 函式 (recapis.h)
傳回辨識器支援的 Unicode 點範圍。
語法
HRESULT GetUnicodeRanges(
HRECOGNIZER hrec,
ULONG *pcRanges,
CHARACTER_RANGE *pcr
);
參數
hrec
辨識器的句柄。
pcRanges
在輸入時， 可以保存之類型 緩衝區的範圍數目。 輸出時， 會包含於其上的範圍 數目。
pcr
CHARACTER_RANGE 結構的陣列。 每個結構都包含辨識器支援的 Unicode 點範圍。 陣列的順序是任意的。 若要判斷緩衝區的必要大小，請將 其 設定為 NULL;使用範圍數目來配置 回應 緩衝區。
傳回值
此函式可以傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
成功。 |
|
其中一個參數是無效的指標。 |
|
此標識元緩衝區太小。 |
|
發生未指定的錯誤。 |
|
收到無效的自變數。 |
|
記憶體不足。 |
備註
此函式是選擇性的。
某些辨識器不支援這項功能，但仍可能包含 GetUnicodeRanges 函式函式 。 對於這類辨識器， GetUnicodeRanges 函 式會傳回E_NOTIMPL。
若要控制特定辨識器內容所使用的 Unicode 範圍，請使用 GetEnabledUnicodeRanges 和 SetEnabledUnicodeRanges 函 式。 這些範圍限制為 GetUnicodeRanges 所傳回之範圍的子集。
Microsoft 手勢辨識器會使用來自0xF000的 Unicode 字元來0xF0FF。 此範圍中的每個單一 Unicode 值都代表單一手勢。 如需手勢的 Unicode 值完整清單，請參閱 手勢的 Unicode 範圍值。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP Tablet PC Edition [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | recapis.h |
| Dll | inkobjcore.dll |