SetFlags function (recapis.h)
Specifies how the recognizer interprets the ink and determines the result string.
Call this function before processing the ink for the first time. Therefore, call the SetFlags function before calling the Process function.
Syntax
HRESULT SetFlags(
[in] HRECOCONTEXT hrc,
[in] DWORD dwFlags
);
Parameters
[in] hrc
Handle to the recognizer context.
[in] dwFlags
The following table lists the flags that you may set to specify how the recognizer interprets the ink and determines the result string. Use the OR operator (|) to combine flags as appropriate.
Return value
This function can return one of these values.
HRESULT value | Description |
---|---|
|
Success. |
|
The flag is invalid. |
|
The recognizer does not support this function. |
|
Unable to allocate memory to complete the operation. |
|
An unspecified error occurred. |
|
The context is invalid or one of the parameters is an invalid pointer. |
Remarks
Prior to Microsoft Windows XP Tablet PC Edition Development Kit 1.7, Tablet PC Input Panel performed smart spacing. Starting with Tablet PC SDK 1.7, Input Panel continues to produce results with preliminary spacing recommendations. Tablet PC Input Panel's spacing results may however be changed by the recognizer's recommendations (results). The recognizer is able to do this by using text contextual information (based on the SetTextContext call made by Input Panel) and its internal language model rules.
Input Panel is able to determine whether the recognizer is capable of doing auto-spacing by calling this function with the RECOFLAG_AUTOSPACE flag set. If the recognizer does not support auto-spacing, E_INVALIDARG is returned.
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 |
See also
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for