SetEnabledUnicodeRanges function (recapis.h)
Enables one or more Unicode point ranges on the context.
Syntax
HRESULT SetEnabledUnicodeRanges(
HRECOCONTEXT hrc,
ULONG cRanges,
CHARACTER_RANGE *pcr
);
Parameters
hrc
The handle to the recognizer context.
cRanges
The number of ranges in the pRanges buffer.
pcr
An array of CHARACTER_RANGE structures. Each structure identifies a range of Unicode points that you want to enable in the recognizer. The order of the array is arbitrary.
Return value
This function can return one of these values.
| Return code | Description |
|---|---|
|
Success. |
|
The recognizer does not support one of the specified Unicode point ranges. |
|
An unspecified error occurred. |
|
An invalid argument was received. |
|
One of the parameters is an invalid pointer. |
Remarks
The SetEnabledUnicodeRanges function is optional.
Some recognizers do not support enabling and disabling specific code points, but may still include the SetEnabledUnicodeRanges function. For such recognizers, the SetEnabledUnicodeRanges function returns E_NOTIMPL.
Each recognizer supports one or more Unicode point ranges. To determine which Unicode point ranges the recognizer supports, call the GetUnicodeRanges function. If you do not call this function, the recognizer uses a default set of Unicode point ranges. The default ranges are recognizer specific.
The Microsoft gesture recognizer uses Unicode characters from 0xF000 to 0xF0FF. Each single Unicode value in this range represents a single gesture. For a complete list of Unicode values for gestures, see Unicode Range Values of Gestures.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP Tablet PC Edition [desktop apps | UWP apps] |
| Minimum supported server | None supported |
| Target Platform | Windows |
| Header | recapis.h |
| DLL | inkobjcore.dll |