Расширение декорации формы для картинки.ТекстНевыбраннойКартинки

Очистить и восстановить картинку-декорацию управляемой формы

Декорация содержит библиотечную картинку непосредственно. В отличие от поля картинки, ей не нужен ПутьКДанным с адресом временного хранилища.

Подготовка

1. Нужна отдельная учебная конфигурация без рабочих данных. В Конфигураторе создайте Общие → Общие картинки → УчебныйМаркер. Не изменяйте общие картинки КА2/УНФ/УТ.

2. В картинку УчебныйМаркер импортируйте собственный PNG owned-book-marker-32.png из подпапки lesson-assets рядом с этим руководством. Если файла нет, в каталоге руководства запустите C:\Python314\python.exe make-lesson-picture-fixture.py. Это включённая учебная отметка 32×32, не скачивание из интернета.

3. Обновите только учебную конфигурацию. Имя УчебныйМаркер используется в БиблиотекаКартинок.УчебныйМаркер; произвольную двоичную картинку нельзя присвоить вместо библиотечной в рассматриваемых свойствах.

4. В этой учебной базе создайте внешнюю обработку с новой пустой управляемой формой. ПриСозданииНаСервере свяжите с одноимённой процедурой. Реквизиты, картинку и команду вручную не создавайте.

5. Вставьте полный модуль на уровне модуля формы. Каждый урок — отдельная копия; настольный тонкий/толстый или веб-клиент. Данные не записываются в базу.

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    Новые = Новый Массив;
    Новые.Добавить(Новый РеквизитФормы("УчебнаяПоказана", Новый ОписаниеТипов("Булево")));
    Новые.Добавить(Новый РеквизитФормы("УчебныйИндекс", Новый ОписаниеТипов("Число")));
    ЭтаФорма.ИзменитьРеквизиты(Новые);
    ЭтаФорма.УчебнаяПоказана = Истина;
    ЭтаФорма.УчебныйИндекс = 0;
    Картинка = Элементы.Добавить("УчебнаяДекорация", Тип("ДекорацияФормы"));
    Картинка.Вид = ВидДекорацииФормы.Картинка;
    Картинка.Картинка = БиблиотекаКартинок.УчебныйМаркер;
    Картинка.Гиперссылка = Ложь;
    Картинка.РазрешитьНачалоПеретаскивания = Ложь;
    Картинка.РазрешитьПеретаскивание = Ложь;
    Картинка.СпособПеретаскиванияФайлов = СпособПеретаскиванияФайлов.КакСсылкаНаФайл;
    Картинка.ТекстНевыбраннойКартинки = "Учебная декорация скрыта";


    КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
    КомандаДействия.Действие = "УчебноеДействие";
    КомандаДействия.Заголовок = "Проверить учебную картинку";
    КомандаДействия.Подсказка = "Действие только над данными учебной формы";
    КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
    Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
    Кнопка.ИмяКоманды = КомандаДействия.Имя;
    Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры

&НаКлиенте
Процедура УчебноеДействие(Команда)
    Картинка = Элементы.УчебнаяДекорация;
    ЭтаФорма.УчебнаяПоказана = НЕ ЭтаФорма.УчебнаяПоказана;
    Если ЭтаФорма.УчебнаяПоказана Тогда
        Картинка.Картинка = БиблиотекаКартинок.УчебныйМаркер;
        Сообщить(Картинка.Картинка.Ширина() = 32 И Картинка.Картинка.Высота() = 32);
    Иначе
        Картинка.Картинка = Новый Картинка;
        Сообщить("Декорация очищена, общий ресурс не удалён");
    КонецЕсли;
    Сообщить(ЭтаФорма.УчебныйИндекс = 0);
КонецПроцедуры

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

1. Элемент создаётся как ДекорацияФормы, Вид = Картинка. Это не ПолеФормы.

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

3. ТекстНевыбраннойКартинки объясняет пустое состояние; изменение Картинка на клиенте требует обращения к серверу согласно справке.

4. Гиперссылка и перетаскивание выключены, внешних обработчиков нет. Индекс своего числового реквизита не меняется.

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

1. Первое нажатие: сообщение очистки и Истина. Второе: два Истина, ресурс снова 32×32.

2. Декорации не назначается ПутьКДанным.

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

Декорация отделена от связанного с данными поля картинки.

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

1. Нельзя переносить прямое .Картинка на расширение поля картинки: там другой контракт.

2. Не подменяйте библиотечную картинку двоичной в этом свойстве.

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