|
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_
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
More Online Helps
Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
