Расширение поля формы для поля табличного документа.ПриФормированииТекстаПодсказки

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

Событие вызывается в следующих случаях: Указатель мыши наведен на ячейку и остановлен на 2 сек, и панель множественного выделения не отображается. Отобржается подсказка для панели действий либо подсказка в панели действий уже открыта и изменилось выделение табличного документа. Подготовить подсказку для реальной области документа.

Подготовка

1. Создайте внешнюю учебную обработку с управляемой формой. Реквизиты формы: Статус (Строка 200), Счетчик (Число 10.0), РазрешитьСохранение (Булево). Выведите Статус и РазрешитьСохранение на форму.

2. Основной обработчик назначается событию указанного элемента Образец, а не событию формы. Код вставляется на уровне модуля формы с директивой НаКлиенте. Дополнительный серверный блок назначьте событию формы ПриСозданииНаСервере.

3. Открывайте обработку в настольном тонком клиенте. Каждый урок проверяйте в отдельном варианте формы; HTML показывает код, но не исполняет его.

4. Добавьте реквизит УчебныйДокумент типа ТабличныйДокумент и элемент Образец вида ПолеТабличногоДокумента, путь к данным УчебныйДокумент. У поля Редактирование Истина и Защита Ложь; ячейка A1 разрешена для интерактивного редактирования.

5. В свойствах элемента Образец → События назначьте ПриФормированииТекстаПодсказки процедуре ОбразецПриФормированииТекстаПодсказки. Подготовка использует текущую сигнатуру установленной справки плюс неявный параметр Элемент управляемой формы.

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

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    Счетчик = 0;
    РазрешитьСохранение = Ложь;
    Статус = "Готово";
    Документ = Новый ТабличныйДокумент;
    Ячейка = Документ.Область(1, 1);
    Ячейка.Текст = "Книга";
    Ячейка.Расшифровка = "УЧЕБНЫЙ-КОД";
    Ячейка.Защита = Ложь;
    УчебныйДокумент = Документ;
    Элементы.Образец.Редактирование = Истина;
    Элементы.Образец.Защита = Ложь;
    Элементы.Образец.Вывод = ИспользованиеВывода.Разрешить;
КонецПроцедуры

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

1. Дополнительный серверный блок создаёт собственные данные, элемент подготовлен в редакторе формы.

2. Платформа вызывает назначенный обработчик вследствие действия пользователя; процедуру с придуманными параметрами вручную не вызываем.

3. Обработчик меняет только явно названные данные своей формы или параметры текущего события.

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

1. Наведите указатель на A1 и задержитесь: подсказка содержит Учебная ячейка: Книга.

2. ТекстПодсказки получает ФорматированнаяСтрока, не объект документа и не готовую область; серверный вызов здесь не нужен.

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

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

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

1. Настольный тонкий клиент — контекст этого урока. Доступность и порядок событий в веб- и мобильном клиентах могут отличаться.

2. Код не открывает внешние страницы, не отправляет сообщения и не обращается к рабочим документам.

3. Свойство СтандартнаяОбработка и параметр Отказ имеют разные назначения: первый заменяет стандартное действие, второй отменяет операцию.

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