rvspellchecker TRVSpellChecker

Свойства   Методы   События

<< Нажмите, чтобы показать Содержание >>

rvspellchecker TRVSpellChecker

Свойства   Методы   События

TRVSpellChecker – компонент, проверяющий орфографию документов, содержащихся в компонентах TRichView, TRichViewEdit, TDBRichView, TDBRichViewEdit, а также компонентах TSRichViewEdit, TDBSRichViewEdit из СРВ-Редактора (ScaleRichView).

В FireMonkey этот компонент также можно использовать как платформенный сервис для проверки орфографии в других визуальных компонентах (например, TEdit и TMemo).

Модуль [VCL/FMX] RVSpellChecker / fmxRVSpellChecker.

Синтаксис

TRVSpellChecker = class(TComponent)

Иерархия

TObject

TPersistent

TComponent

Доступность и языки

Если проверка орфографии возможна, IsAvailable возвращает True.

AvailableLanguages возвращает список кодов поддерживаемых языков (словарей). Чтобы отобразить их пользователю, используйте метод FillLanguageNames.

Чтобы выбрать язык (словарь), присвойте код языка свойству Language или номер языка свойству LanguageIndex.

Текущий язык (словарь) возвращается свойством CurrentLanguage или LangugeIndex.

Рекомендуемое использование

Вы можете проверять текст в редакторе, зарегистрировав его с помощью метода RegisterEditor

Если вы не используете Инструменты интерфейса ТРВ (RichViewActions), вызовите метод Execute.

Если вы используете Инструменты интерфейса ТРВ (RichViewActions):

▪разместите на форме компоненты TRVSpellChecker, TRVSpellInterface, TRVAControlPanel;

▪присвойте RVSpellInterface1.SpellChecker = RVSpellChecker1;

▪присвойте RVAControlPanel1.SpellInterface = RVSpellInterface1;

▪добавьте TrvActionSpellingCheck в TActionList и назначьте эту команду кнопке или пункту меню.

Инструменты интерфейса ТРВ добавляют команду проверки орфографии во всплывающее меню (TRVAPopupMenu), запускают проверку по нажатию кнопки или пункта меню и локализуют диалоги проверки орфографии (т.е. показывают текст в этих диалогах на выбранном языке).

Альтернативное использование

Можно использовать «низкоуровневые» методы:

▪IsWordValid проверяет слово на наличие орфографических ошибок (может использоваться в событии OnSpellingCheck редакторов);

▪Suggest возвращает варианты исправления слова с ошибкой;

▪AddToAutoReplaceList – команда «Заменить все»;

▪AddToIgnoreList – команда «Пропустить все»;

▪AddToDictionary – команда «Добавить в словарь».

Использование как сервиса FireMonkey

Этот компонент можно использовать как платформенный сервис для проверки орфографии в других редакторах FireMonkey, см. RegisterAsService.

Автоматическое исправление

Метод GetAutoCorrection позволяет получить вариант исправления для указанного слова.

Если используются инструменты интерфейса ТРВ (RichViewActions):

Используйте компонент TRVSpellInterface (см. раздел «Рекомендуемое использование» выше). Вызывайте RVSpellInterface1.AutoCorrectInKeyDown в событии OnKeyDown редактора и RVSpellInterface1.AutoCorrectInKeyPress в событии OnKeyPress.

Подсказки для завершения слова

Метод GuessCompletions позволяет получить возможные варианты завершения слова.

Эта возможность не используется ТРВ-Редактором.

Локализация диалогов

Если компонент не используется через TRVSpellInterface из Инструментов интерфейса ТРВ (RichViewActions), весь текст пользовательского интерфейса в диалогах проверки орфографии отображается на английском языке.

Если вы хотите локализовать формы самостоятельно, используйте событие OnSpellForm.

Если компонент используется через Инструменты интерфейса ТРВ (RichViewActions), локализация диалогов будет проводиться автоматически.

Поддержка платформ

Платформа

Используемое средство

Windows

Системная проверка орфографии (ISpellChecker), доступная начиная с Windows 8

macOS

Системная проверка орфографии (NSSpellChecker)

iOS

Системная проверка орфографии (UITextChecker)

Linux

Hunspell (может требовать его установки)

Android

–

Не все возможности доступны на всех платформах, см. SupportsFeatures.

См. также

Фоновая проверка орфографии в ТРВ-Редакторе