Share via


SetEnabledUnicodeRanges 函式 (recapis.h)

在內容上啟用一或多個 Unicode 點範圍。

語法

HRESULT SetEnabledUnicodeRanges(
  HRECOCONTEXT    hrc,
  ULONG           cRanges,
  CHARACTER_RANGE *pcr
);

參數

hrc

辨識器內容的控制碼。

cRanges

pRanges緩衝區中的範圍數目。

pcr

CHARACTER_RANGE結構的陣列。 每個結構都會識別您想要在辨識器中啟用的 Unicode 點範圍。 陣列的順序是任意的。

傳回值

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

傳回碼 Description
S_OK
成功。
TPC_S_TRUNCATED
辨識器不支援其中一個指定的 Unicode 點範圍。
E_FAIL
發生未指定的錯誤。
E_INVALIDARG
收到不正確引數。
E_POINTER
其中一個參數是不正確指標。

備註

SetEnabledUnicodeRanges函式是選擇性的。

某些辨識器不支援啟用和停用特定字碼點,但可能仍包含 SetEnabledUnicodeRanges 函 式。 針對這類辨識器, SetEnabledUnicodeRanges 函式會傳回E_NOTIMPL。

每個辨識器都支援一或多個 Unicode 點範圍。 若要判斷辨識器支援的 Unicode 點範圍,請呼叫 GetUnicodeRanges 函式。 如果您未呼叫此函式,辨識器會使用一組預設的 Unicode 點範圍。 預設範圍是辨識器特定的。

Microsoft 手勢辨識器會使用來自0xF000的 Unicode 字元來0xF0FF。 此範圍中的每個單一 Unicode 值都代表單一手勢。 如需手勢的 Unicode 值完整清單,請參閱 手勢的 Unicode 範圍值

規格需求

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

另請參閱

CHARACTER_RANGE 結構

GetEnabledUnicodeRanges 函式

GetUnicodeRanges 函式