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