Сравнить старый метод выделения с рекомендуемым свойством

ПолучитьВыделенныйТекст нужен для чтения старого кода. С версии 8.2 он не рекомендуется; новый код использует ВыделенныйТекст.

Подготовка

1. Создайте отдельную внешнюю обработку с обычной формой. Запускайте толстым клиентом в режиме обычных форм.

2. Добавьте реквизит УчебныйДокумент (ТекстовыйДокумент), ПолеТекстовогоДокумента с именем УчебноеПолеТекста и Данные = УчебныйДокумент.

3. Добавьте кнопку УчебнаяКоманда вне поля. ПриОткрытии свяжите с процедурой из полного модуля; Нажатие кнопки вручную не назначайте.

4. Каждый урок заменяет полный модуль отдельной копии. Две строки создаются в памяти; файлы не открываются и не сохраняются.

Процедура ПриОткрытии()
    УчебныйДокумент = Новый ТекстовыйДокумент;
    УчебныйДокумент.УстановитьТекст("Книга: 3" + Символы.ПС + "Ручка: 1");
    Кнопка = ЭтаФорма.ЭлементыФормы.УчебнаяКоманда;
    Кнопка.Заголовок = "Проверить собственный текст";
    Кнопка.УстановитьДействие("Нажатие", Новый Действие("ВыполнитьУчебнуюПроверку"));
КонецПроцедуры

Процедура ВыполнитьУчебнуюПроверку(Элемент) Экспорт
    Поле = ЭтаФорма.ЭлементыФормы.УчебноеПолеТекста;
    Если Поле.ВыделенныйТекст = "" Тогда
        Сообщить("Выделите Книга или Ручка в собственном документе");
        Возврат;
    КонецЕсли;
    ЧерезСвойство = Поле.ВыделенныйТекст;
    ЧерезСтарыйМетод = Поле.ПолучитьВыделенныйТекст();
    Сообщить(ЧерезСвойство);
    Сообщить(ЧерезСтарыйМетод = ЧерезСвойство);
    Сообщить("Для нового кода используйте свойство ВыделенныйТекст");
КонецПроцедуры

Разбор по шагам

1. Выделите одно слово в собственном документе. Проверка пустого выделения выполняется до сравнения.

2. Свойство и старый метод читаются последовательно при одном выделении.

3. Сравнение показывает одинаковый полученный фрагмент, но не делает старый метод рекомендуемым.

4. Документ не изменяется; урок предназначен для понимания и миграции старых модулей обычных форм.

Как проверить результат

1. При выделении Книга вывод Книга, Истина и рекомендация свойства; при Ручка — Ручка и Истина.

2. Без выделения показана только подсказка, текст остаётся исходным.

Ожидаемый результат

Исторический метод показан с явной рекомендацией современного свойства.

На что обратить внимание

1. Не копируйте старый метод в новый код без необходимости совместимости.

2. Метод доступен только толстому клиенту, не управляемому тонкому полю.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.