Получает выделенный текст поля текстового документа.
Синтаксис
ПолучитьВыделенныйТекст()Примеры платформы
ВыделенныйТекст = ЭлементыФормы.ПолеТекста.ПолучитьВыделенныйТекст();Полное описание, параметры и ограничения
ПолеТекстовогоДокумента.ПолучитьВыделенныйТекст (TextDocumentField.GetSelectedText)
ПолеТекстовогоДокумента (TextDocumentField)
ПолучитьВыделенныйТекст (GetSelectedText)
Не рекомендуется использовать, начиная с версии 8.2.
Доступен, начиная с версии 8.0 (в режиме совместимости с версией 8.2 и последующими).
Синтаксис:
ПолучитьВыделенныйТекст()
Возвращаемое значение:
Тип: Строка.
Выделенный текст в виде строки.
Описание:
Получает выделенный текст поля текстового документа.
Доступность:
Толстый клиент.
Пример:
ВыделенныйТекст = ЭлементыФормы.ПолеТекста.ПолучитьВыделенныйТекст();
Использование в версии:
Доступен, начиная с версии 8.0 (в режиме совместимости с версией 8.2 и последующими).
Не рекомендуется использовать, начиная с версии 8.2.
Методическая информация
Практические примеры
Сравнить старый метод выделения с рекомендуемым свойством
ПолучитьВыделенныйТекст нужен для чтения старого кода. С версии 8.2 он не рекомендуется; новый код использует ВыделенныйТекст.
Где и как запускать
Полный модуль собственной обычной формы. Только толстый клиент с обычными формами; экспортный обработчик Нажатие получает инициирующий Элемент, хотя базовое событие Кнопка.Нажатие дополнительных параметров не имеет.
Подготовка
Создайте отдельную внешнюю обработку с обычной формой. Запускайте толстым клиентом в режиме обычных форм.
Добавьте реквизит УчебныйДокумент (ТекстовыйДокумент), ПолеТекстовогоДокумента с именем УчебноеПолеТекста и Данные = УчебныйДокумент.
Добавьте кнопку УчебнаяКоманда вне поля. ПриОткрытии свяжите с процедурой из полного модуля; Нажатие кнопки вручную не назначайте.
Каждый урок заменяет полный модуль отдельной копии. Две строки создаются в памяти; файлы не открываются и не сохраняются.
Процедура ПриОткрытии()
УчебныйДокумент = Новый ТекстовыйДокумент;
УчебныйДокумент.УстановитьТекст("Книга: 3" + Символы.ПС + "Ручка: 1");
Кнопка = ЭтаФорма.ЭлементыФормы.УчебнаяКоманда;
Кнопка.Заголовок = "Проверить собственный текст";
Кнопка.УстановитьДействие("Нажатие", Новый Действие("ВыполнитьУчебнуюПроверку"));
КонецПроцедуры
Процедура ВыполнитьУчебнуюПроверку(Элемент) Экспорт
Поле = ЭтаФорма.ЭлементыФормы.УчебноеПолеТекста;
Если Поле.ВыделенныйТекст = "" Тогда
Сообщить("Выделите Книга или Ручка в собственном документе");
Возврат;
КонецЕсли;
ЧерезСвойство = Поле.ВыделенныйТекст;
ЧерезСтарыйМетод = Поле.ПолучитьВыделенныйТекст();
Сообщить(ЧерезСвойство);
Сообщить(ЧерезСтарыйМетод = ЧерезСвойство);
Сообщить("Для нового кода используйте свойство ВыделенныйТекст");
КонецПроцедурыРазбор по шагам
Выделите одно слово в собственном документе. Проверка пустого выделения выполняется до сравнения.
Свойство и старый метод читаются последовательно при одном выделении.
Сравнение показывает одинаковый полученный фрагмент, но не делает старый метод рекомендуемым.
Документ не изменяется; урок предназначен для понимания и миграции старых модулей обычных форм.
Как проверить результат
При выделении Книга вывод Книга, Истина и рекомендация свойства; при Ручка — Ручка и Истина.
Без выделения показана только подсказка, текст остаётся исходным.
Ожидаемый результат
Исторический метод показан с явной рекомендацией современного свойства.
На что обратить внимание
Не копируйте старый метод в новый код без необходимости совместимости.
Метод доступен только толстому клиенту, не управляемому тонкому полю.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.