Top | ![]() |
![]() |
![]() |
![]() |
GspellTextView * | gspell_text_view_get_from_gtk_text_view () |
void | gspell_text_view_basic_setup () |
GtkTextView * | gspell_text_view_get_view () |
gboolean | gspell_text_view_get_inline_spell_checking () |
void | gspell_text_view_set_inline_spell_checking () |
gboolean | gspell_text_view_get_enable_language_menu () |
void | gspell_text_view_set_enable_language_menu () |
gboolean | enable-language-menu | Read / Write |
gboolean | inline-spell-checking | Read / Write |
GtkTextView * | view | Read / Write / Construct Only |
GspellTextView extends the GtkTextView class with inline spell checking.
Misspelled words are highlighted with a PANGO_UNDERLINE_ERROR
, usually a red
wavy underline. Right-clicking a misspelled word pops up a context menu of
suggested replacements. The context menu also contains an “Ignore All” item
to add the misspelled word to the session dictionary. And an “Add” item to
add the word to the personal dictionary.
For a basic use-case, there is the gspell_text_view_basic_setup()
convenience
function.
The spell is checked only on the visible region of the GtkTextView. Note that if a same GtkTextBuffer is used for several views, the misspelled words are visible in all views, because the highlighting is achieved with a GtkTextTag added to the buffer.
If you don't use the gspell_text_view_basic_setup()
function, you need to
call gspell_text_buffer_set_spell_checker()
to associate a GspellChecker to
the GtkTextBuffer. GspellTextView handles automatically changes to the
following properties: “buffer”, “spell-checker”
and “language”.
Note that GspellTextView extends the GtkTextView class but without subclassing it, because the GtkSourceView library has already a GtkTextView subclass.
GspellTextView *
gspell_text_view_get_from_gtk_text_view
(GtkTextView *gtk_view
);
Returns the GspellTextView of gtk_view
. The returned object is guaranteed
to be the same for the lifetime of gtk_view
.
void
gspell_text_view_basic_setup (GspellTextView *gspell_view
);
This function is a convenience function that does the following:
Set a spell checker. The language chosen is the one returned by
gspell_language_get_default()
.
Set the “inline-spell-checking” property to TRUE
.
Set the “enable-language-menu” property to TRUE
.
Example:
1 2 3 4 5 |
GtkTextView *gtk_view; GspellTextView *gspell_view; gspell_view = gspell_text_view_get_from_gtk_text_view (gtk_view); gspell_text_view_basic_setup (gspell_view); |
This is equivalent to:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
GtkTextView *gtk_view; GspellTextView *gspell_view; GspellChecker *checker; GtkTextBuffer *gtk_buffer; GspellTextBuffer *gspell_buffer; checker = gspell_checker_new (NULL); gtk_buffer = gtk_text_view_get_buffer (gtk_view); gspell_buffer = gspell_text_buffer_get_from_gtk_text_buffer (gtk_buffer); gspell_text_buffer_set_spell_checker (gspell_buffer, checker); g_object_unref (checker); gspell_view = gspell_text_view_get_from_gtk_text_view (gtk_view); gspell_text_view_set_inline_spell_checking (gspell_view, TRUE); gspell_text_view_set_enable_language_menu (gspell_view, TRUE); |
Since: 1.2
gboolean
gspell_text_view_get_inline_spell_checking
(GspellTextView *gspell_view
);
void gspell_text_view_set_inline_spell_checking (GspellTextView *gspell_view
,gboolean enable
);
Enables or disables the inline spell checking.
gboolean
gspell_text_view_get_enable_language_menu
(GspellTextView *gspell_view
);
Since: 1.2
void gspell_text_view_set_enable_language_menu (GspellTextView *gspell_view
,gboolean enable_language_menu
);
Sets whether to enable the language context menu. If enabled, doing a right click on the GtkTextView will show a sub-menu to choose the language for the spell checking. If another language is chosen, it changes the “language” property of the “spell-checker” of the “buffer” of the “view”.
Since: 1.2
“enable-language-menu”
property “enable-language-menu” gboolean
When the context menu is shown, whether to add a sub-menu to select the language for the spell checking.
Flags: Read / Write
Default value: FALSE
Since: 1.2
“inline-spell-checking”
property “inline-spell-checking” gboolean
Whether the inline spell checking is enabled.
Flags: Read / Write
Default value: FALSE