Тип: Булево. Содержит признак того, что поле картинки является гиперссылкой. Если значение свойства Истина, то при щелчке мышью в поле картинки возникает событие Нажатие. В колонке таблицы значение данного свойства игнорируется.
Полное описание, параметры и ограничения
Расширение поля формы для поля картинки.Гиперссылка (Form field extension for a picture field.Hyperlink)
Расширение поля формы для поля картинки (Form field extension for a picture field)
Гиперссылка (Hyperlink)
Доступен, начиная с версии 8.2.
Использование:
Чтение и запись.
Описание:
Тип: Булево.
Содержит признак того, что поле картинки является гиперссылкой. Если значение свойства Истина, то при щелчке мышью в поле картинки возникает событие Нажатие.
В колонке таблицы значение данного свойства игнорируется.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Изменение свойства на клиенте требует обращения к серверу.
Использование в версии:
Доступен, начиная с версии 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 без реальной второй картинки в библиотечном наборе.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Сравнить масштаб картинки 100 и 200
Масштаб задаётся в процентах и применяется дополнительно к масштабу формы. Он не является номером кадра или увеличением разрешения TIFF.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Создайте отдельную внешнюю обработку с пустой управляемой основной формой. Вставьте полный модуль; каждый урок — отдельная копия формы.
Свяжите ПриСозданииНаСервере формы с одноимённой процедурой. Реквизиты, поле картинки и кнопку вручную не создавайте.
Двухстраничный TIFF 32×32 включён в код: первая страница светло-серая, вторая тёмно-серая. Это собственные контрольные пиксели, не скан рабочего документа.
Картинка помещается во временное хранилище с идентификатором этой формы. Адрес действителен в её сеансе; не сохраняйте его в справочник как постоянный файл.
Нет загрузки из сети, чтения чужого файла, записи документа или печати. Настольный тонкий/толстый клиент; отдельные визуальные свойства можно сравнить в веб-клиенте.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Новые = Новый Массив;
Новые.Добавить(Новый РеквизитФормы("АдресУчебнойКартинки", Новый ОписаниеТипов("Строка")));
Новые.Добавить(Новый РеквизитФормы("ПолныйУчебныйАдрес", Новый ОписаниеТипов("Строка")));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ДанныеTIFF = Base64Значение("SUkqAAgAAAAJAAABBAABAAAAIAAAAAEBBAABAAAAIAAAAAIBAwABAAAACAAAAAMBAwABAAAAAQAAAAYBAwABAAAAAQAAABEBBAABAAAA7AAAABUBAwABAAAAAQAAABYBBAABAAAAIAAAABcBBAABAAAAAAQAAHoAAAAJAAABBAABAAAAIAAAAAEBBAABAAAAIAAAAAIBAwABAAAACAAAAAMBAwABAAAAAQAAAAYBAwABAAAAAQAAABEBBAABAAAA7AQAABUBAwABAAAAAQAAABYBBAABAAAAIAAAABcBBAABAAAAAAQAAAAAAADw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDw8PDwQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQA==");
СвояКартинка = Новый Картинка(ДанныеTIFF);
Если СвояКартинка.КоличествоКадров() <> 2 Тогда
ВызватьИсключение "В учебном TIFF должно быть две страницы";
КонецЕсли;
ЭтаФорма.ПолныйУчебныйАдрес = ПоместитьВоВременноеХранилище(СвояКартинка, ЭтаФорма.УникальныйИдентификатор);
ЭтаФорма.АдресУчебнойКартинки = ЭтаФорма.ПолныйУчебныйАдрес;
Поле = Элементы.Добавить("УчебнаяКартинка", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеКартинки;
Поле.ПутьКДанным = "АдресУчебнойКартинки";
Поле.Заголовок = "Собственные две страницы TIFF";
Поле.Гиперссылка = Ложь;
Поле.РазрешитьНачалоПеретаскивания = Ложь;
Поле.РазрешитьПеретаскивание = Ложь;
Поле.СпособПеретаскиванияФайлов = СпособПеретаскиванияФайлов.КакСсылкаНаФайл;
Поле.РазмерКартинки = РазмерКартинки.РеальныйРазмер;
Поле.Масштабировать = Истина;
Поле.Масштаб = 100;
Поле.Высота = 6;
Поле.Ширина = 20;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Проверить свою картинку";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Поле = Элементы.УчебнаяКартинка;
Если Поле.Масштаб = 100 Тогда
Поле.Масштаб = 200;
Иначе
Поле.Масштаб = 100;
КонецЕсли;
Сообщить(Поле.Масштаб);
Сообщить(Поле.Масштабировать);
Сообщить(Поле.ПолучитьКоличествоКадров() = 2);
КонецПроцедурыРазбор по шагам
РеальныйРазмер выбран для сравнения дополнительного масштаба, а не растягивания до размеров поля.
Начальный Масштаб 100 соответствует значению по умолчанию. Кнопка переключает 100↔200.
Масштабировать разрешает команды изменения масштаба и прокрутку, когда изображение не помещается.
Проверяем, что TIFF остаётся двухстраничным. Никакой новый файл высокого разрешения не создаётся.
Как проверить результат
Первое нажатие: 200, Истина, Истина; второе: 100, Истина, Истина.
Сравните вид страницы при своём масштабе формы. Для маленьких 32×32 пикселей полоса прокрутки может не понадобиться.
Ожидаемый результат
Увеличение представления не подменяется обработкой или улучшением исходного изображения.
На что обратить внимание
Не трактуйте Масштаб=2 как двукратный масштаб: здесь проценты.
Отсутствие полосы прокрутки у маленького изображения не является ошибкой.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.