- 0 2.0
Initializes an RC
structure with default values.
This function is provided only for compatibility with version 1.0 of the Pen
API, and will not be supported in future versions.
InitRC( HWND hwnd, LPRC lprc )
Handle to a window.
Address of the RC
structure to initialize.
This function does not return a value.
InitRC serves little purpose in applications that conform to version 2.0 of the Pen
API. Under version 2.0, a recognizer maintains an HRC
object, which makes the RC
For suggestions on how to update a version 1.0 application to remove services
that rely on RC
, see the section "The RC Structure" in Appendix A.
initializes an RC
structure with default values, many of which come from the global RC
structure. The application can use the initialized RC
structure when calling the Recognize
function. Although an application can change any of these values, it should
be careful about changing those items that can be set by the user through the
Windows Control Panel.
sets the bounding rectangle to the client area of the window identified by hwnd
. The bounding rectangle is valid only until the window is resized or moved.
When this occurs, the application must again call InitRC
to update the rectBound
member of the RC
structure or correct rectBound
manually. If the window handle hwnd
is NULL, the bounding rectangle and hwnd
remain uninitialized. The application must set the hwnd
member to a valid window before calling Recognize
The following table describes the default values used to initialize the RC
structure. Values not listed in the table come from the global RC
. Some of the global default values can be modified by the user in Control
||ALC_DEFAULT. The function uses the complete alphabet and all gestures. The
exact character set depends on the recognizer.
||hwnd (the first argument of InitRC).
||(0,0,0,0) or client rectangle of hwnd if hwnd is not NULL.
||PCM_ADDDEFAULTS, or PCM_ADDDEFAULTS | PCM_RECTBOUND if hwnd is not NULL.
Members the user can change through the system Control Panel are filled with
values indicating that the system default should be used. These placeholder
values are RC_WDEFAULT or RC_LDEFAULT, depending on whether the member is a UINT or
LONG value. During the processing of ProcessWriting
, or RecognizeData
, these values are replaced with the current system defaults before the RC
structure is passed to the recognizer. If the PCM_ADDDEFAULTS flag is set in lPcm
, the values of the lPcm
member in the global RC
are combined with the current lPcm
values with OR operators at the time the recognizer is called. If the high
bit is set in wRcPreferences
, the values of the wRcPreferences
member in the global RC
are combined with the current wRcPreferences
values with bitwise-OR operators at the time the recognizer is called.
The following table gives the default values for the members of the RC
||Array initialized to 0
structure pointed to in the RCRESULT
structure is a copy of the original RC
structure passed as a parameter to Recognize
. In the copy, default values are replaced. All coordinates are in the tablet
coordinate system and the lRcOptions
member has the RCO_TABLETCOORD flag set.
, ALC_, PCM_, RCO_
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages