Check spelling based on Hunspell dictionaries

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

Overview

Default operating mode

Configuring the spell check

See also

Check spelling based on Hunspell dictionaries

Overview

WINDEV allows you to use the integrated spelling checker on several controls in WINDEV applications:

Word Processing control.
Versions 24 and later
edit control.
New in version 24
edit control.
edit control.
Versions 24 and later
column of Table control in edit mode.
New in version 24
column of Table control in edit mode.
column of Table control in edit mode.

This spell check can be performed on the user computer via Hunspell dictionaries. These dictionaries can be easily found on Internet. These dictionaries include a ".dic" file and a ".aff" file with the same name that must be found at the same location.

Note: We recommend that you to comply with the distribution license of each dictionary file used.

Default operating mode

Default setting

By default, if your project contains a control that uses a spelling checker (Word Processing, edit control, etc.):

The spelling checker is enabled in the controls, in English and French.
The FR and US dictionaries (and their readmexxx.txt licenses) are automatically copied into the generation directory of the application.

Versions 24 and later
Note: Up to version 23, the spelling in edit controls and Table columns was checked via OpenOffice. From version 24, it is possible to use the integrated spelling checker for these controls as well.

To configure the spelling checker used by the project:

Display the description window of project: on the "Project" pane, in the "Project" group, click "Description".
In the "Options" tab, in the "Spelling checker" area, select the spelling checker used for the project:
- Integrated checker: the spelling checker will be based on Hunspell dictionaries.
- Open Office checker: the spelling checker (on edit controls and Table columns) will be based on OpenOffice dictionaries.

New in version 24
Note: Up to version 23, the spelling in edit controls and Table columns was checked via OpenOffice. From version 24, it is possible to use the integrated spelling checker for these controls as well.

To configure the spelling checker used by the project:

Display the description window of project: on the "Project" pane, in the "Project" group, click "Description".
In the "Options" tab, in the "Spelling checker" area, select the spelling checker used for the project:
- Integrated checker: the spelling checker will be based on Hunspell dictionaries.
- Open Office checker: the spelling checker (on edit controls and Table columns) will be based on OpenOffice dictionaries.

Note: Up to version 23, the spelling in edit controls and Table columns was checked via OpenOffice. From version 24, it is possible to use the integrated spelling checker for these controls as well.

To configure the spelling checker used by the project:

Display the description window of project: on the "Project" pane, in the "Project" group, click "Description".
In the "Options" tab, in the "Spelling checker" area, select the spelling checker used for the project:
- Integrated checker: the spelling checker will be based on Hunspell dictionaries.
- Open Office checker: the spelling checker (on edit controls and Table columns) will be based on OpenOffice dictionaries.

Operating mode

The French and English dictionaries are automatically loaded. Spelling mistakes are underlined in red in the control. By right-clicking on the underlined word you can:

get a list of suggestions.
Versions 24 and later
add the word to the Hunspell dictionary. In this case, words added to the dictionary will be in the file "C:\Users\<User>\AppData\Roaming\PC SOFT\perso.dic".
New in version 24
add the word to the Hunspell dictionary. In this case, words added to the dictionary will be in the file "C:\Users\<User>\AppData\Roaming\PC SOFT\perso.dic".
add the word to the Hunspell dictionary. In this case, words added to the dictionary will be in the file "C:\Users\<User>\AppData\Roaming\PC SOFT\perso.dic".

Configuring the spell check

Overview

Several options and functions are used to configure the spell check:

Disable the automatic copy of dictionaries.
Load the dictionaries manually and associate them with a language.
Enabling or disabling the spelling checker.

Automatic copy of dictionaries

The management of dictionary copy is performed in the project options:

On the "Project" pane, in the "Project" group, click "Description".
In the "Options" tab, check or uncheck "Automatically copy the dictionaries into the generation directory".
Validate.

Manual load of dictionaries and association with a language

DictionaryLoad allows you to load a dictionary in Hunspell format and to associate it with a language or sublanguage. This function must be called before starting the spelling checker.

Notes on the Word Processing control:

A docx document contains information about the document language. This information is used to identify the dictionary language that will be used.
If the dictionary corresponding to the document language is placed beside the executable, it is automatically loaded and used to correct the document. If the dictionary corresponding to the document language is not found, the spell check is not available.
When creating a docx document via the Word Processing control, the document language corresponds to the current application language (defined by Nation for example).

Enable or disable the spelling checker

The spelling checker can be enabled:

by the end user (for the Word Processing control only): all you have to do is select "Enable the spell check" in the ribbon of the Word Processing control.
by programming via ..CheckSpell.
in the control description window :
- For the Word Processing control: "Enable [Check spelling] by default" option ("General" tab).
- For the edit control: "Check spelling" option ("Details" tab).
- For the columns of the Table control: "Check spelling" option ("Details" tab of the Text column description).