InitRC 

1.0     2.0     

Initializes an RC232HBHC 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.

void InitRC( HWND hwnd, LPRC lprc )

Parameters

hwnd

Handle to a window.

lprc

Address of the RC232HBHC 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 Recognize1AOD10 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 RC232HBHC 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 RecognizeData3BE5AP5.

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.

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 ProcessWriting1AOD18, Recognize1AOD10, or RecognizeData3BE5AP5, these values are replaced with the current system defaults before the RC232HBHC 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:

The RC232HBHC structure pointed to in the RCRESULT232HBID structure is a copy of the original RC structure passed as a parameter to Recognize1AOD10. 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