| Top |
| GspellChecker * | gspell_checker_new () |
| void | gspell_checker_set_language () |
| const GspellLanguage * | gspell_checker_get_language () |
| gboolean | gspell_checker_check_word () |
| GSList * | gspell_checker_get_suggestions () |
| void | gspell_checker_add_word_to_personal () |
| void | gspell_checker_add_word_to_session () |
| void | gspell_checker_clear_session () |
| void | gspell_checker_set_correction () |
GspellChecker is a spell checker. It is a wrapper around the Enchant library, to have an API based on GObject.
If the “language” property is NULL, it means that no
dictonaries are available, in which case the GspellChecker is in a
“disabled” (but allowed) state.
GspellChecker *
gspell_checker_new (const GspellLanguage *language);
Creates a new GspellChecker. If language
is NULL, the default language is
picked with gspell_language_get_default().
void gspell_checker_set_language (GspellChecker *checker,const GspellLanguage *language);
Sets the language to use for the spell checking. If language
is NULL, the
default language is picked with gspell_language_get_default().
const GspellLanguage *
gspell_checker_get_language (GspellChecker *checker);
gboolean gspell_checker_check_word (GspellChecker *checker,const gchar *word,gssize word_length,GError **error);
If the “language” is NULL, i.e. when no dictonaries are
available, this function returns TRUE to limit the damage.
GSList * gspell_checker_get_suggestions (GspellChecker *checker,const gchar *word,gssize word_length);
Gets the suggestions for word
. Free the return value with
g_slist_free_full(suggestions, g_free).
void gspell_checker_add_word_to_personal (GspellChecker *checker,const gchar *word,gssize word_length);
Adds a word to the personal dictionary. It is typically saved in the user's home directory.
void gspell_checker_add_word_to_session (GspellChecker *checker,const gchar *word,gssize word_length);
Adds a word to the session dictionary. Each GspellChecker instance has a
different session dictionary. The session dictionary is lost when the
“language” property changes or when checker
is destroyed or
when gspell_checker_clear_session() is called.
This function is typically called for an “Ignore All” action.
void
gspell_checker_clear_session (GspellChecker *checker);
Clears the session dictionary.
void gspell_checker_set_correction (GspellChecker *checker,const gchar *word,gssize word_length,const gchar *replacement,gssize replacement_length);
Informs the spell checker that word
is replaced/corrected by replacement
.
An error code used with GSPELL_CHECKER_ERROR in a GError returned
from a spell-checker-related function.
#define GSPELL_CHECKER_ERROR (gspell_checker_error_quark ())
Error domain for the spell checker. Errors in this domain will be from the GspellCheckerError enumeration. See GError for more information on error domains.
“language” property“language” GspellLanguage *
The GspellLanguage used.
Flags: Read / Write / Construct
“session-cleared” signalvoid user_function (GspellChecker *spell_checker, gpointer user_data)
Emitted when the session dictionary is cleared.
spell_checker |
the GspellChecker. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“word-added-to-personal” signalvoid user_function (GspellChecker *spell_checker, gchar *word, gpointer user_data)
Emitted when a word is added to the personal dictionary.
spell_checker |
the GspellChecker. |
|
word |
the added word. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“word-added-to-session” signalvoid user_function (GspellChecker *spell_checker, gchar *word, gpointer user_data)
Emitted when a word is added to the session dictionary. See
gspell_checker_add_word_to_session().
spell_checker |
the GspellChecker. |
|
word |
the added word. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last