|
|
?/ ?/98 Entered into CVS 1/ 2/98 KSpell 0.3.1 11/25/97 KSpell 0.2.3 11/ /97 KSpell 0.2.2 9/21/97 KSpell 0.2 9/11/97 KSpell 0.1
KSpell offers easy access to International ISpell 3.1 as well as a typical spell-checker GUI ("Add", "Replace", etc.). You can use KSpell to automatically spell-check an ASCII file as well as to implement online spell-checking and to spell-check proprietary format and marked up (e.g. HTML, TeX) documents. The relevant methods for these three procedures are check(), checkWord(), and checkList().
KSpellConfig holds configuration information about KSpell as well as acting as an options-setting dialog.
|
KSpell emits ready() when it has verified that ispell is working properly. Pass the name of a slot -- do not pass zero! Be sure to call cleanUp() when you are done with KSpell.
inline bool |
Be sure your instance of KSpell isOk() before you use it. isOk()==TRUE would indicate that any memory that needed to be allocated was and that ispell is up and running. If you find that isOk()==FALSE, it's probably b/c either ispell isn't installed (and in $PATH) or an invalid path was given for the dictionary or personal dictionary (see KSpellConfig).
If an instance of KSpell is not Ok, then it never will be. Delete it, reconfigure a KSpellConfig and try again (perhaps with the system defaults).
void |
[virtual]
Clean up ISpell (write out the personal dictionary and close ispell's stdin). A "death()" signal will be emitted when the cleanup is complete, but the cleanUp() method will return immediately.
bool |
[virtual]
check() will spell check a buffer of many words in plain text format The _buffer is not modified. The signal done(char *) will be sent when check() is finished and the argument will be a spell-corrected version of _buffer. (See done() for more information.) The progress() signal is only sent when a misspelled word is found, so you may not get as fine a resolution as you requested; but you won't get a _finer_ resolution. The spell check may be stopped by the user before the entire buffer has been checked. You can check lastPosition() to see how far in _buffer check() reached before stopping.
bool |
[virtual]
checkList() is more flexible than check(). You could parse any type of document (HTML, TeX, etc.) into a list of spell-checkable words and send the list to checkList(). Sending a marked-up document to check() would result in the mark-up tags being spell checked. The progress() signals will be accurate here since words are checked one at a time.
bool |
[virtual]
checkWord() is the most flexible function. Some apps might need this flexibility.
checkWord () returns FALSE if buffer is not a word, otherwise it returns TRUE;
If usedialog is set to TRUE, KSpell will put up the standard dialog if the word is not found. The dialog results can be queried by using dlgResult() and replacement(). The possible dlgResult() values are (from kspelldlg.h): KS_CANCEL 0 KS_REPLACE 1 KS_REPLACEALL 2 KS_IGNORE 3 KS_IGNOREALL 4 KS_ADD 5 KS_STOP 7
The signal corrected() is emitted when the check is complete. You can look at suggestions() to see what the suggested replacements were. If the dialog box is not used, or the user chooses not to change the word, then new word is just word. pos=0 always.
void |
You can use this to manually hide the dialog box. You only _need_ to do this when you are done with checkWord();
inline QStrList * |
After calling checkWord (an in response to a misspelled() signal you can use this to get the list of suggestions (if any were available)
inline int |
After calling checkWord, you can use this to get the dialog box's result code.
void |
Moves the dialog. If the dialog is not currently visible, it will be placed at this position when it becomes visible.
const char * |
You might want the full buffer in its partially-checked state.
bool |
[virtual]
Tell ispell to ignore this word for the life of this KSpell instance. ignore() returns FALSE if word is not a word or there was an error communicating with ispell.
bool |
[virtual]
Add a word to the user's personal dictionary. Returns FALSE if word is not a word or there was an error communicating with ispell.
KSpellConfig |
[const]
Returns the KSpellConfig object being used by this KSpell.
void |
Set the resolution (in percent) of the progress() signals. E.g. setProgressResolution (10) instructs KSpell to send progress signals (at most) every 10% (10%, 20%, 30%...). The default is 10%.
~ |
[virtual]
The destructor instructs ispell to write out the personal dictionary and then terminates ispell.
void |
[signal]
This is emitted whenever a misspelled word is found by check() or by checkWord(). If it is emitted by checkWord(), pos=0. If it is emitted by check(), the pos indicates the position of the misspelled word in the _buffer. (The first position is zero.) If it is emitted by checkList(), pos is the index to the misspelled word in the QStrList passed to checkList().
These are called _before_ the dialog is opened, so that the calling program's GUI may be updated. (e.g. the misspelled word may be highlighted).
void |
[signal]
This is emitted after the dialog is closed, or if the word was corrected without calling the dialog (i.e., the user previously chose "Replace All" for this word). Results from the dialog may be checked with dlgResult() and replacement() (see notes for check() for more information).
void |
[signal]
This is emitted after KSpell has verified that ispell is running and working properly. The calling application should check isOk() in response to this signal before attempting to use any of the spell-checking methods (check(), et at). Those methods _don't_ check isOk() for you.
void |
[signal]
i is between 1 and 100 -- emitted only during a check ()
void |
[signal]
emitted when check() is done Copy the results of buffer if you need them. You can only rely on the contents of buffer for the life of the slot which was signaled by done(char *).
void |
[signal]
emitted when checkList() is done. If the argument is <i>TRUE</i>, then you should update your text from the wordlist, otherwise, don't.
void |
[signal]
emitted when cleanUp() is done
void |
[signal]
emitted on terminal errors