- 0 2.0
Sets the current default settings for the global RC
structure. In version 2.0 of the Pen API, the RC
structure is made obsolete by the HRC
This function is provided only for compatibility with version 1.0 of the Pen
API and will not be supported in future versions.
UINT SetGlobalRC( LPRC lprc, LPSTR lpszDefRecog, LPSTR lpszDefDict )
Address of an RC
structure or NULL.
Address of string specifying the name of the default recognizer module
(maximum 128 bytes).
Address of a string specifying the default dictionary path. The list should
end with two null characters.
Returns the value SGRC_OK if successful. If an error occurs, the return value
consists of one or more of the following values, combined using the bitwise-OR
||An invalid user name was found in the supplied RC structure. The call to SetGlobalRC has no effect.
||One or more invalid parameters were detected. The call to SetGlobalRC has no effect.
||The supplied recognition context lprc has entries, other than the user name, that contain invalid settings for a
global recognition context. The supplied recognition context is ignored.
||The supplied recognizer module name lpszDefRecog is invalid or the recognizer cannot be loaded. The supplied recognizer module
name is ignored.
||The supplied dictionary path lpszDefDict is invalid or some dictionaries on the path cannot be loaded. The supplied
dictionary path is ignored.
||An error was encountered while saving the new global recognition context
settings to the pen section of the system registry. The new settings are lost after
Because the default RC
values are shared among all version 1.0 applications running, the values
should be changed only through the Control Panel. Whenever a change is made to the
values, the WM_PENMISCINFO message is sent to all top-level windows. The wParam
values are not used, and they are set to 0.
Any of the parameters can be NULL to indicate that the calling application
does not want the value changed.
uses only the following members of the RC
structure pointed to by the lprc
(PCM_TIMEOUT and PCM_RANGE bits) lpLanguage lpUser nInkWidth rgbInk wCountry wIntlPreferences wRcDirect wRcPreferences wTimeOut wTryDictionary
is called for a new recognizer from within the SetGlobalRC
call, the RC
structure that is passed in contains the new values for all members except hrec
. No new recognizer and dictionaries have been set up at this point.
When a version 1.0 application receives a WM_PENMISCINFO message, it should
with a WCR_RCCHANGE subfunction request. This should be done for all
recognizers that the application has loaded, excluding the default recognizer. The RC
Manager calls ConfigRecognizer
in the new default recognizer with a WCR_RCCHANGE subfunction request.
does not save the RCP_MAPCHAR flag in the wRcPreferences
member of the RC
structure to the system registry. The RCP_MAPCHAR flag is reflected in the
for the current session only.
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages