Тип: Строка. Содержит текст всплывающей подсказки, которая появляется при наведении курсора к декорации.
Полное описание, параметры и ограничения
ДекорацияФормы.Подсказка (FormDecoration.ToolTip)
ДекорацияФормы (FormDecoration)
Подсказка (ToolTip)
Доступен, начиная с версии 8.2.
Использование:
Чтение и запись.
Описание:
Тип: Строка.
Содержит текст всплывающей подсказки, которая появляется при наведении курсора к декорации.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Изменение свойства на клиенте требует обращения к серверу.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Подготовить свою форму для тестов без рабочих данных
Полный fixture создаёт два поля, статус, выбор, собственную панель, меню и безопасные учебные надписи.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Только собственная пустая конфигурация УчебнаяКонфигурацияСинтаксиса. Для первого урока создайте новую внешнюю обработку УчебныйИнтерфейсТестирования с пустой основной управляемой формой Форма.
Запустите два отдельных тонких клиента собственной учебной базы: тестируемый с /TESTCLIENT -TPort15380, менеджер с /TESTMANAGER. Порт 15380 — собственный учебный; убедитесь, что на нём не работает другой клиент. Не подключайте менеджер к рабочей базе/чужому приложению.
В fixture назначьте событие ПриСозданииНаСервере одноимённому обработчику и вставьте весь модуль первого урока. Элементы и реквизиты вручную не создавайте. Откройте эту обработку в /TESTCLIENT.
Каждый следующий урок — полный отдельный модуль формы другой обработки менеджера /TESTMANAGER с командой ВыполнитьПример. Перед каждым тестом заново откройте fixture; не выполняйте тест на изменённом состоянии предыдущего урока.
Исходно первое поле Книга, второе Ручка, статус Готово, выбор book/Книга. Любые кнопки/ссылки действуют только на этой памяти формы; нет записи базы и внешних URL.
Это код штатного механизма тестирования 1С, не браузерная проверка HTML. В данном окружении выполнение UI-тестов в настоящей 1С не подтверждено.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
ЭтаФорма.АвтоЗаголовок = Ложь;
ЭтаФорма.Заголовок = "Учебная форма guide-owned-form-2026";
Новые = Новый Массив;
Для Каждого ИмяРеквизита Из СтрРазделить("Первое,Второе,УчебныйСтатус,УчебныйВыбор", ",") Цикл
Новые.Добавить(Новый РеквизитФормы(ИмяРеквизита, Новый ОписаниеТипов("Строка")));
КонецЦикла;
ЭтаФорма.ИзменитьРеквизиты(Новые);
Первое = "Книга";
Второе = "Ручка";
УчебныйСтатус = "Готово";
УчебныйВыбор = "book";
Для Каждого ИмяРеквизита Из СтрРазделить("Первое,Второе,УчебныйСтатус,УчебныйВыбор", ",") Цикл
ИмяПоля = "Поле" + ИмяРеквизита;
Если ИмяРеквизита = "УчебныйСтатус" Тогда
ИмяПоля = "ПолеУчебногоСтатуса";
ИначеЕсли ИмяРеквизита = "УчебныйВыбор" Тогда
ИмяПоля = "ПолеУчебногоВыбора";
КонецЕсли;
Поле = Элементы.Добавить(ИмяПоля, Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = ИмяРеквизита;
Поле.Заголовок = ИмяРеквизита;
КонецЦикла;
Элементы.ПолеУчебногоСтатуса.ТолькоПросмотр = Истина;
Выбор = Элементы.ПолеУчебногоВыбора;
Выбор.СписокВыбора.Добавить("book", "Книга");
Выбор.СписокВыбора.Добавить("pen", "Ручка");
Выбор.РежимВыбораИзСписка = Истина;
Выбор.РедактированиеТекста = Ложь;
Выбор.КнопкаСпискаВыбора = Истина;
Панель = Элементы.Добавить("УчебнаяПанель", Тип("ГруппаФормы"));
Панель.Вид = ВидГруппыФормы.КоманднаяПанель;
Для Каждого ИмяКоманды Из СтрРазделить("УчебноеМеню,УчебноеЗакрытие", ",") Цикл
КомандаФормы = ЭтаФорма.Команды.Добавить(ИмяКоманды);
КомандаФормы.Действие = ИмяКоманды;
КомандаФормы.Заголовок = ИмяКоманды;
КомандаФормы.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("Кнопка" + ИмяКоманды, Тип("КнопкаФормы"), Панель);
Кнопка.ИмяКоманды = КомандаФормы.Имя;
Кнопка.Заголовок = ИмяКоманды;
КонецЦикла;
Элементы.КнопкаУчебноеЗакрытие.КнопкаПоУмолчанию = Истина;
Надпись = Элементы.Добавить("УчебнаяНадпись", Тип("ДекорацияФормы"));
Надпись.Вид = ВидДекорацииФормы.Надпись;
Надпись.Заголовок = "Нажать собственную надпись";
Надпись.Гиперссылка = Истина;
Надпись.Подсказка = "Меняет только собственный учебный статус";
Надпись.УстановитьДействие("Нажатие", "УчебнаяНадписьНажатие");
Форматированная = Элементы.Добавить("УчебнаяФорматированнаяНадпись", Тип("ДекорацияФормы"));
Форматированная.Вид = ВидДекорацииФормы.Надпись;
Форматированная.Гиперссылка = Ложь;
Форматированная.Заголовок = Новый ФорматированнаяСтрока("Открыть учебное пояснение", , , , "guide-owned-link-001");
ЭтаФорма.УстановитьДействие("ОбработкаНавигационнойСсылки", "УчебнаяНавигационнаяСсылка");
ЭтаФорма.Модифицированность = Ложь;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеМеню(Команда)
Значения = Новый СписокЗначений;
Значения.Добавить("book", "Книга");
Значения.Добавить("pen", "Ручка");
УчебныйСтатус = "Меню открыто";
ЭтаФорма.ПоказатьВыборИзМеню(Новый ОписаниеОповещения("УчебноеМенюЗавершено", ЭтотОбъект), Значения, Элементы.ПолеПервое);
КонецПроцедуры
&НаКлиенте
Процедура УчебноеМенюЗавершено(ВыбранныйЭлемент, ДополнительныеПараметры) Экспорт
Если ВыбранныйЭлемент = Неопределено Тогда
УчебныйСтатус = "Отмена меню";
Иначе
Если ТипЗнч(ВыбранныйЭлемент) <> Тип("ЭлементСпискаЗначений") Тогда
ВызватьИсключение "Результат учебного меню имеет неожиданный тип";
КонецЕсли;
Если ВыбранныйЭлемент.Значение <> "book" И ВыбранныйЭлемент.Значение <> "pen" Тогда
ВызватьИсключение "Получено не учебное значение";
КонецЕсли;
УчебныйСтатус = "Меню: " + ВыбранныйЭлемент.Значение;
КонецЕсли;
ЭтаФорма.Модифицированность = Ложь;
КонецПроцедуры
&НаКлиенте
Процедура УчебнаяНадписьНажатие()
УчебныйСтатус = "Надпись нажата";
ЭтаФорма.Модифицированность = Ложь;
КонецПроцедуры
&НаКлиенте
Процедура УчебнаяНавигационнаяСсылка(НавигационнаяСсылкаФорматированнойСтроки, СтандартнаяОбработка)
СтандартнаяОбработка = Ложь;
Если НавигационнаяСсылкаФорматированнойСтроки <> "guide-owned-link-001" Тогда
ВызватьИсключение "Ссылка не относится к собственному учебному сценарию";
КонецЕсли;
УчебныйСтатус = "Учебная ссылка обработана";
ЭтаФорма.Модифицированность = Ложь;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеЗакрытие(Команда)
ЭтаФорма.Модифицированность = Ложь;
ЭтаФорма.Закрыть();
КонецПроцедурыРазбор по шагам
Сначала проверяется имя собственной пустой конфигурации, затем программно создаются четыре строковых реквизита и элементы.
Кнопка меню вызывает неблокирующий ПоказатьВыборИзМеню; callback имеет ВыбранныйЭлемент, ДополнительныеПараметры и Экспорт.
Обычная надпись использует Нажатие() без параметров. Форматированная надпись имеет Гиперссылка=Ложь, ссылку в пятом параметре конструктора и обработчик навигации на уровне формы.
Событие формы навигации имеет два параметра; СтандартнаяОбработка=Ложь запрещает штатный переход. Отдельное одноимённое событие декорации не назначается.
Кнопка закрытия по умолчанию закрывает только эту память формы. Она не подтверждает запись документа и не завершает клиент.
Как проверить результат
В точной форме четыре поля: Книга, Ручка, Готово, Книга для значения book. Есть две надписи и две собственные кнопки.
После самостоятельного ручного нажатия надписей меняется только статус; сайт или документ не открывается. Перед тестами заново откройте форму.
Ожидаемый результат
Готов полностью заполненный независимый fixture для обучения автоматизации форм.
На что обратить внимание
Не открывайте в рабочей конфигурации и не заменяйте собственные селекторы на первый объект приложения.
Успешное построение модуля статически не является подтверждением UI-теста в 1С.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Настроить обычные и расширенные подсказки у надписи, поля и группы
Текст обычной подсказки и объект расширенной подсказки имеют разные API. Свойства возвращённых декораций проверяем до использования.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Создайте отдельную внешнюю обработку с новой пустой управляемой основной формой. Каждый урок — свой полный модуль и отдельная копия формы.
Не создавайте вручную УчебноеНазвание, УчебнаяГруппа, ПолеУчебногоНазвания и УчебнаяНадпись: код добавляет их сам.
В событиях формы назначьте ПриСозданииНаСервере одноимённому обработчику. Вставьте весь модуль на уровне модуля, включая клиентские процедуры.
Откройте сохранённую учебную EPF в настольном тонком/толстом или веб-клиенте. Данные принадлежат только этой форме; справочники, документы и регистры не используются.
Внешняя кнопка находится вне учебной группы и остаётся доступной для обратного переключения. Код не обходит ограничения на внешние обработки.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Новые = Новый Массив;
Новые.Добавить(Новый РеквизитФормы("УчебноеНазвание", Новый ОписаниеТипов("Строка")));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ЭтаФорма.УчебноеНазвание = "Книга";
Группа = Элементы.Добавить("УчебнаяГруппа", Тип("ГруппаФормы"));
Группа.Вид = ВидГруппыФормы.ОбычнаяГруппа;
Группа.Заголовок = "Собственные учебные данные";
Группа.Группировка = ГруппировкаПодчиненныхЭлементовФормы.Вертикальная;
Поле = Элементы.Добавить("ПолеУчебногоНазвания", Тип("ПолеФормы"), Группа);
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = "УчебноеНазвание";
Поле.Заголовок = "Название";
Надпись = Элементы.Добавить("УчебнаяНадпись", Тип("ДекорацияФормы"), Группа);
Надпись.Вид = ВидДекорацииФормы.Надпись;
Надпись.Заголовок = "Данные только в памяти формы";
Надпись.Подсказка = "Пояснение не сохраняется в документ";
Надпись.ОтображениеПодсказки = ОтображениеПодсказки.Всплывающая;
Поле.Подсказка = "Введите только собственное учебное название";
Поле.ОтображениеПодсказки = ОтображениеПодсказки.Всплывающая;
Группа.Подсказка = "Группа элементов, не группа справочника";
Группа.ОтображениеПодсказки = ОтображениеПодсказки.Всплывающая;
ПодсказкаНадписи = Надпись.РасширеннаяПодсказка;
ПодсказкаПоля = Поле.РасширеннаяПодсказка;
ПодсказкаГруппы = Группа.РасширеннаяПодсказка;
Если ПодсказкаНадписи <> Неопределено Тогда
ПодсказкаНадписи.Заголовок = "Текст декорации не меняет реквизит";
КонецЕсли;
Если ПодсказкаПоля <> Неопределено Тогда
ПодсказкаПоля.Заголовок = "Реквизит УчебноеНазвание принадлежит этой форме";
КонецЕсли;
Если ПодсказкаГруппы <> Неопределено Тогда
ПодсказкаГруппы.Заголовок = "Все элементы созданы только для этого урока";
КонецЕсли;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Выполнить учебное действие";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Сообщить("Подсказки описывают интерфейс, значение остаётся: " + ЭтаФорма.УчебноеНазвание);
КонецПроцедуры
Разбор по шагам
У каждого элемента задаём свой обычный текст, не используем одно объяснение для разных сущностей.
ОтображениеПодсказки настраивает способ показа; доступность и точный вид зависят от клиента.
РасширеннаяПодсказка возвращает декорацию, а не строку. Проверяем отсутствие перед чтением/записью Заголовок.
Не присваиваем новый объект самому свойству РасширеннаяПодсказка и не строим рекурсивные подсказки.
Как проверить результат
Изучите наведение на поле, надпись и группу: назначены разные учебные пояснения.
Кнопка выводит неизменённое название. Настройка подсказок не считает сумму и не записывает данные.
Ожидаемый результат
Разобраны обычный текст, режим отображения и возвращённые объекты расширенной подсказки.
На что обратить внимание
Не все варианты интерфейса одинаково показывают обычные/расширенные подсказки.
Подсказка не заменяет проверку данных и не является секретным хранилищем.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.