Word List - Microsoft Windows Pen API Programmer's Reference

Microsoft Windows Pen API Programmer's Reference

Custom Search

Word List

An application can select a word list from any number of lists to attach to an HRC. A word list, referenced by a handle, consists of words the recognizer should consider when translating a handwritten word or phrase. For example, Figure 5.1 shows a case in which the recognizer must decide between the valid interpretations of "boy" and "looy".

By consulting a word list that contains the entry "boy" but not "looy", the recognizer can select the first choice with more confidence.

An application must call the CreateHWL function to create a word list. The function accepts a pointer to a word list already in memory. Alternatively, an application can fill the word list from an existing file through the ReadHWL function. The SetWordlistHRC function attaches the word list to a particular HRC, and DestroyHWL returns the memory occupied by the list to the operating system.

The function SetWordlistCoercionHRC allows an application to establish the word list's influence over the recognizer's interpretations. The function accepts the following values to set the degree of coercion:

Coercion value	Description
SCH_ADVISE	The recognizer should use the word list only for hints; results are not strongly coerced to match the word list. This is the default coercion value.
SCH_FORCE	If the recognizer does not find an exact match in the word list, it should return the best fit. For example, if the recognizer interprets a handwritten word as "swoden," it will return "Sweden," given a word list of country names.
SCH_NONE	Cancels any coercion currently in effect.

The following code fragment illustrates all these steps by reading a list of country names from the fictitious file COUNTRY.LST and attaching the list to the HRC identified by the handle hrc1. It calls SetWordlistCoercionHRC to force the recognizer to return only names found in the COUNTRY.LST file. The code assumes vhwl is a global variable, visible in all parts of the program.

HWL vhwl; // Handle to word list

HFILE hfile; // File handle

OFSTRUCT OFstruct; // Receives info about open file

int iRet; // Return code

// In intialization procedure, open and read the word list

hfile = OpenFile( "COUNTRY.LST", (LPOFSTRUCT) &OFstruct, OF_READ );

if (hfile != HFILE_ERROR)

{

hwl = CreateHWL( hrec1, NULL, WLT_EMPTY ); // Create empty list

iRet = ReadHWL( vhwl, hfile ); // Read list from file

}

// After creating hrc1, attach word list vhwl to it

SetWordlistHRC( hrc1, vhwl ); // Attach list to hrc1

SetWordlistCoercionHRC( hrc1, SCH_FORCE ); // Establish coercion

//Before terminating, destroy word list

DestroyHWL( vhwl );

Note that an application must first set the word list with SetWordlistHRC before calling SetWordlistCoercionHRC.

Last news from Greatis Software

    Nostalgia .Net     .Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More »

Recommended software for developers

    Ultimate Pack     Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More »

    Form Designer .Net     Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More »

    Print Suite .Net     Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More »

    Gradient Controls .Net     Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More »

    Greatis iGrid     iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More »

All the contacts and projects

Dmitry Vasiliev (just.dmitry)

More Online Helps

Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages

greatis just4fun network