InitRC
- 0 2.0
Initializes an
RC structure with default values.
Note 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 )
Parameters
hwnd
Handle to a window.
lprc
Address of the
RC structure to initialize.
Return Value
This function does not return a value.
Comments
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 structure obsolete.
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.
InitRC 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.
InitRC 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 or
RecognizeData.
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
Panel.
Value
| Description
|
rc.alc
| ALC_DEFAULT. The function uses the complete alphabet and all gestures. The
exact character set depends on the recognizer.
|
rc.lRcOptions
| Zero.
|
rc.hwnd
| hwnd (the first argument of InitRC).
|
rc.wResultMode
| RRM_COMPLETE.
|
rc.rectBound
| (0,0,0,0) or client rectangle of hwnd if hwnd is not NULL.
|
rc.lPcm
| PCM_ADDDEFAULTS, or PCM_ADDDEFAULTS | PCM_RECTBOUND if hwnd is not NULL.
|
rc.rectExclude
| (0,0,0,0).
|
rc.guide
| (0,0,0,0,0,0,0).
|
rc.wRcOrient
| RCOR_NORMAL.
|
rc.wRcDirect
| 0x0103
|
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,
Recognize, 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 structure:
Value
| Description
|
rc.hrec
| RC_WDEFAULT
|
rc.lpfnYield
| RC_LDEFAULT
|
rc.lpUser
| RC_LDEFAULT
|
rc.wCountry
| RC_WDEFAULT
|
rc.wIntlPreferences
| RC_WDEFAULTFLAGS
|
rc.lpLanguage
| RC_LDEFAULT
|
rc.rglpdf
| RC_LDEFAULT
|
rc.wTryDictionary
| RC_WDEFAULT
|
rc.clErrorLevel
| RC_WDEFAULT
|
rc.wTimeOut
| RC_WDEFAULT
|
rc.wRcPreferences
| RC_WDEFAULTFLAGS
|
rc.nInkWidth
| RC_WDEFAULT
|
rc.rgbInk
| RC_LDEFAULT
|
rc.alcPriority
| ALC_NOPRIORITY
|
rc.rgbfAlc
| Array initialized to 0
|
The
RC 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.
See Also
Recognize,
RecognizeData,
RC, ALC_, PCM_, RCO_
- Software for developers
-
Delphi Components
.Net Components
Software for Android Developers
- More information resources
-
MegaDetailed.Net
Unix Manual Pages
Delphi Examples
