Тип: ДекорацияФормы. Описывает расширенную подсказку декорации формы.
Полное описание, параметры и ограничения
ДекорацияФормы.РасширеннаяПодсказка (FormDecoration.ExtendedTooltip)
ДекорацияФормы (FormDecoration)
РасширеннаяПодсказка (ExtendedTooltip)
Доступен, начиная с версии 8.3.3.
Использование:
Только чтение.
Описание:
Тип: ДекорацияФормы.
Описывает расширенную подсказку декорации формы.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.3.3.
Методическая информация
Практические примеры
Настроить обычные и расширенные подсказки у надписи, поля и группы
Текст обычной подсказки и объект расширенной подсказки имеют разные API. Свойства возвращённых декораций проверяем до использования.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Создайте отдельную внешнюю обработку с новой пустой управляемой основной формой. Каждый урок — свой полный модуль и отдельная копия формы.
Не создавайте вручную УчебноеНазвание, УчебнаяГруппа, ПолеУчебногоНазвания и УчебнаяНадпись: код добавляет их сам.
В событиях формы назначьте ПриСозданииНаСервере одноимённому обработчику. Вставьте весь модуль на уровне модуля, включая клиентские процедуры.
Откройте сохранённую учебную EPF в настольном тонком/толстом или веб-клиенте. Данные принадлежат только этой форме; справочники, документы и регистры не используются.
Внешняя кнопка находится вне учебной группы и остаётся доступной для обратного переключения. Код не обходит ограничения на внешние обработки.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Новые = Новый Массив;
Новые.Добавить(Новый РеквизитФормы("УчебноеНазвание", Новый ОписаниеТипов("Строка")));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ЭтаФорма.УчебноеНазвание = "Книга";
Группа = Элементы.Добавить("УчебнаяГруппа", Тип("ГруппаФормы"));
Группа.Вид = ВидГруппыФормы.ОбычнаяГруппа;
Группа.Заголовок = "Собственные учебные данные";
Группа.Группировка = ГруппировкаПодчиненныхЭлементовФормы.Вертикальная;
Поле = Элементы.Добавить("ПолеУчебногоНазвания", Тип("ПолеФормы"), Группа);
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = "УчебноеНазвание";
Поле.Заголовок = "Название";
Надпись = Элементы.Добавить("УчебнаяНадпись", Тип("ДекорацияФормы"), Группа);
Надпись.Вид = ВидДекорацииФормы.Надпись;
Надпись.Заголовок = "Данные только в памяти формы";
Надпись.Подсказка = "Пояснение не сохраняется в документ";
Надпись.ОтображениеПодсказки = ОтображениеПодсказки.Всплывающая;
Поле.Подсказка = "Введите только собственное учебное название";
Поле.ОтображениеПодсказки = ОтображениеПодсказки.Всплывающая;
Группа.Подсказка = "Группа элементов, не группа справочника";
Группа.ОтображениеПодсказки = ОтображениеПодсказки.Всплывающая;
ПодсказкаНадписи = Надпись.РасширеннаяПодсказка;
ПодсказкаПоля = Поле.РасширеннаяПодсказка;
ПодсказкаГруппы = Группа.РасширеннаяПодсказка;
Если ПодсказкаНадписи <> Неопределено Тогда
ПодсказкаНадписи.Заголовок = "Текст декорации не меняет реквизит";
КонецЕсли;
Если ПодсказкаПоля <> Неопределено Тогда
ПодсказкаПоля.Заголовок = "Реквизит УчебноеНазвание принадлежит этой форме";
КонецЕсли;
Если ПодсказкаГруппы <> Неопределено Тогда
ПодсказкаГруппы.Заголовок = "Все элементы созданы только для этого урока";
КонецЕсли;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Выполнить учебное действие";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Сообщить("Подсказки описывают интерфейс, значение остаётся: " + ЭтаФорма.УчебноеНазвание);
КонецПроцедуры
Разбор по шагам
У каждого элемента задаём свой обычный текст, не используем одно объяснение для разных сущностей.
ОтображениеПодсказки настраивает способ показа; доступность и точный вид зависят от клиента.
РасширеннаяПодсказка возвращает декорацию, а не строку. Проверяем отсутствие перед чтением/записью Заголовок.
Не присваиваем новый объект самому свойству РасширеннаяПодсказка и не строим рекурсивные подсказки.
Как проверить результат
Изучите наведение на поле, надпись и группу: назначены разные учебные пояснения.
Кнопка выводит неизменённое название. Настройка подсказок не считает сумму и не записывает данные.
Ожидаемый результат
Разобраны обычный текст, режим отображения и возвращённые объекты расширенной подсказки.
На что обратить внимание
Не все варианты интерфейса одинаково показывают обычные/расширенные подсказки.
Подсказка не заменяет проверку данных и не является секретным хранилищем.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.