Loading the Dictionaries

Once SplInit creates the spelling checker handle, the function loads the four required dictionaries and any other optional dictionaries:

• First, SplInit loads the read-only main dictionary. Microsoft defines the main dictionary for each localized version of Windows CE. Currently, Windows CE does not support replacing the main directory with a dictionary supplied by an application. However, Windows CE can specify additional dictionaries to load while initializing the spelling checker.
• Next, in addition to loading the main directory, SplInit creates three internal user dictionaries for each spelling session. SplInit creates these dictionaries empty. During a spelling session, you can add to and modify these dictionaries. However, Windows CE does not specifically save these dictionaries when you exit a spelling session.

You can instruct SplInit to load external user dictionaries at the beginning of a spelling session. An external user dictionary is a dictionary that is defined by an application, user, or other third party. A common use of an external user directory is to store unique words that are not found in the main directory but are commonly used by an individual user. You can save the external dictionary at the end of a spelling session, and load it again at the beginning of the next spelling session.

Use the ppwz parameter of SplInit to point to a list of external user dictionaries. Each element on the list includes the dictionary path and file name. SplInit assigns identifiers to the internal user dictionaries and to any external user dictionaries pointed to by ppwsz.

The following table describes the values you can provide in the ppwz parameter.

Use the nID value to direct the spelling checker API to a specific dictionary. The clex value is the total number of external dictionaries you provide in the ppwz parameter.