|
<< Нажмите, чтобы показать Содержание >>
|
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, см. 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.