Тип: Картинка. Поле вида ПолеКартинки может отображать данные типов Число и Булево. В этом случае значение представляет собой индекс в наборе картинок, задаваемых этим свойством. Для типа Булево значение Истина означает индекс 0, а значение Ложь означает индекс 1.
Полное описание, параметры и ограничения
Расширение поля формы для поля картинки.КартинкаЗначений (Form field extension for a picture field.ValuesPicture)
Расширение поля формы для поля картинки (Form field extension for a picture field)
КартинкаЗначений (ValuesPicture)
Доступен, начиная с версии 8.2.
Использование:
Чтение и запись.
Описание:
Тип: Картинка.
Поле вида ПолеКартинки может отображать данные типов Число и Булево. В этом случае значение представляет собой индекс в наборе картинок, задаваемых этим свойством. Для типа Булево значение Истина означает индекс 0, а значение Ложь означает индекс 1.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Если картинка задается программно, может быть установлена картина вида Пустая или ИзБиблиотеки.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Показать библиотечную картинку для собственного числового значения 0
Поле связано с числовым реквизитом 0, а КартинкаЗначений задаёт ресурс для его отображения. Двоичный TIFF из других уроков не подменяет набор картинок значений.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Нужна отдельная учебная конфигурация без рабочих данных. В Конфигураторе создайте Общие → Общие картинки → УчебныйМаркер. Не изменяйте общие картинки КА2/УНФ/УТ.
В картинку УчебныйМаркер импортируйте собственный PNG owned-book-marker-32.png из подпапки lesson-assets рядом с этим руководством. Если файла нет, в каталоге руководства запустите C:\Python314\python.exe make-lesson-picture-fixture.py. Это включённая учебная отметка 32×32, не скачивание из интернета.
Обновите только учебную конфигурацию. Имя УчебныйМаркер используется в БиблиотекаКартинок.УчебныйМаркер; произвольную двоичную картинку нельзя присвоить вместо библиотечной в рассматриваемых свойствах.
В этой учебной базе создайте внешнюю обработку с новой пустой управляемой формой. ПриСозданииНаСервере свяжите с одноимённой процедурой. Реквизиты, картинку и команду вручную не создавайте.
Вставьте полный модуль на уровне модуля формы. Каждый урок — отдельная копия; настольный тонкий/толстый или веб-клиент. Данные не записываются в базу.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Новые = Новый Массив;
Новые.Добавить(Новый РеквизитФормы("УчебнаяПоказана", Новый ОписаниеТипов("Булево")));
Новые.Добавить(Новый РеквизитФормы("УчебныйИндекс", Новый ОписаниеТипов("Число")));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ЭтаФорма.УчебнаяПоказана = Истина;
ЭтаФорма.УчебныйИндекс = 0;
Поле = Элементы.Добавить("УчебноеПолеКартинки", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеКартинки;
Поле.ПутьКДанным = "УчебныйИндекс";
Поле.КартинкаЗначений = БиблиотекаКартинок.УчебныйМаркер;
Поле.Гиперссылка = Ложь;
Поле.ТекстНевыбраннойКартинки = "Библиотечный ресурс временно снят";
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Проверить учебную картинку";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Поле = Элементы.УчебноеПолеКартинки;
Если ЭтаФорма.УчебныйИндекс <> 0 Тогда
ВызватьИсключение "Этот урок использует только собственный индекс 0";
КонецЕсли;
ЭтаФорма.УчебнаяПоказана = НЕ ЭтаФорма.УчебнаяПоказана;
Если ЭтаФорма.УчебнаяПоказана Тогда
Поле.КартинкаЗначений = БиблиотекаКартинок.УчебныйМаркер;
Сообщить(Поле.КартинкаЗначений.Ширина() = 32 И Поле.КартинкаЗначений.Высота() = 32);
Иначе
Поле.КартинкаЗначений = Новый Картинка;
Сообщить("Ресурс значений снят, числовое значение не изменено");
КонецЕсли;
Сообщить(ЭтаФорма.УчебныйИндекс = 0);
КонецПроцедурыРазбор по шагам
Числовой ПутьКДанным — индекс картинки значения, а не строковый адрес изображения во временном хранилище.
Собственный PNG содержит одну картинку: урок использует только индекс 0, не выдумывает вторую пиктограмму.
КартинкаЗначений программно принимает Пустая/ИзБиблиотеки. Ветви очищают и восстанавливают ресурс, не числовой реквизит.
Для булева по справке Истина соответствует индексу 0, Ложь индексу 1. Набор из двух картинок нужен для обоих состояний; этот однокартинный урок не моделирует его.
КоличествоКадров TIFF и НаборВариантов картинки не являются этой коллекцией значков.
Как проверить результат
Первое нажатие: сообщение о снятии и Истина. Второе: два Истина, индекс всё ещё 0.
Проверьте показ первой картинки в своей учебной базе; ресурс и числовое поле подготовлены явно.
Ожидаемый результат
Показано назначение ресурса значений для одного проверяемого числового индекса.
На что обратить внимание
Не присваивайте Новый Картинка(ДанныеTIFF) в КартинкаЗначений.
Не переключайте индекс на 1 без реальной второй картинки в библиотечном наборе.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.