Тип: ОписаниеТипов. Содержит объект, описывающий допустимые типы значений для рисунка.
Полное описание, параметры и ограничения
РисунокТабличногоДокумента.ТипЗначения (SpreadsheetDocumentDrawing.ValueType)
РисунокТабличногоДокумента (SpreadsheetDocumentDrawing)
ТипЗначения (ValueType)
Доступен, начиная с версии 8.0.
Использование:
Чтение и запись.
Описание:
Тип: ОписаниеТипов.
Содержит объект, описывающий допустимые типы значений для рисунка.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Доступно только для рисунков типа Текст, если в рисунке хранится значение (свойство СодержитЗначение равно Истина).
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Показать отрицательное число в текстовом рисунке
СодержитЗначение включает типизированное значение. Формат регулирует представление, но число остаётся числом и пригодно для вычислений.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = Новый ТабличныйДокумент;
Надпись = ТабДок.Рисунки.Добавить(ТипРисункаТабличногоДокумента.Текст);
Надпись.Имя = "УчебнаяНадпись";
Надпись.Лево = 5;
Надпись.Верх = 5;
Надпись.Ширина = 80;
Надпись.Высота = 25;
Надпись.АвтоРазмер = Ложь;
Надпись.СодержитЗначение = Истина;
Надпись.ТипЗначения = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
Надпись.Значение = -125.5;
Надпись.Формат = "ЧДЦ=2; ЧГ=0";
Надпись.ФорматРедактирования = "ЧДЦ=2; ЧГ=0";
Надпись.ВыделятьОтрицательные = Истина;
Надпись.Шрифт = Новый Шрифт("Arial", 14);
ТабДок.ТолькоПросмотр = Истина;
Сообщить(ТипЗнч(Надпись.Значение) = Тип("Число"));
Сообщить(Надпись.Значение + 125.5 = 0);
Сообщить(Надпись.СодержитЗначение);
Сообщить(Надпись.ВыделятьОтрицательные);
Возврат ТабДок;
КонецФункции
Разбор по шагам
Тип значения задаётся до присваивания. Квалификаторы разрешают знак: не ставим Неотрицательный для отрицательного числа.
Значение -125.5 хранится как число. Формат показывает две дробные цифры, ФорматРедактирования определяет вид при редактировании.
ВыделятьОтрицательные использует специальный цвет стиля, когда первый значимый символ текста — минус. Проверяем его в текущей теме.
Как проверить результат
Четыре проверки дают Истина.
В русской локали ожидается -125,50; цвет отрицательного значения зависит от стиля клиента.
Проверка сложения с 125.5 даёт ноль: формат не превратил число в строку.
Ожидаемый результат
Отрицательное типизированное значение с отдельным форматом представления.
На что обратить внимание
ВыделятьОтрицательные анализирует представление с минусом, а не бизнес-смысл долга или возврата.
Формат с другим представлением отрицательных чисел может влиять на визуальное выделение.
Этот рисунок не является ячейкой A1 и не попадает автоматически в формулу итога.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Настроить ввод четырёх цифр в собственном рисунке
Редактор можно установить только для рисунка Текст с СодержитЗначение = Истина. Используем строковый код 1234, не пароль и не номер рабочего товара.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = Новый ТабличныйДокумент;
Надпись = ТабДок.Рисунки.Добавить(ТипРисункаТабличногоДокумента.Текст);
Надпись.Имя = "УчебнаяНадпись";
Надпись.Лево = 5;
Надпись.Верх = 5;
Надпись.Ширина = 80;
Надпись.Высота = 25;
Надпись.АвтоРазмер = Ложь;
Надпись.СодержитЗначение = Истина;
Надпись.ТипЗначения = Новый ОписаниеТипов("Строка", Новый КвалификаторыСтроки(4));
Надпись.Значение = "";
Надпись.УстановитьЭлементУправления(Тип("ПолеВвода"));
Надпись.Маска = "9999";
Надпись.АвтоОтметкаНезаполненного = Ложь;
Надпись.ОтметкаНезаполненного = Истина;
Сообщить(Надпись.ОтметкаНезаполненного);
Надпись.Значение = "1234";
Если СтрДлина(Надпись.Значение) = 4 Тогда
Надпись.ОтметкаНезаполненного = Ложь;
КонецЕсли;
ТабДок.ТолькоПросмотр = Ложь;
Надпись.Защита = Ложь;
Сообщить(Надпись.Значение = "1234");
Сообщить(Не Надпись.ОтметкаНезаполненного);
Сообщить(Не Надпись.АвтоОтметкаНезаполненного);
Сообщить("Фактический тип редактора: " + Строка(ТипЗнч(Надпись.ЭлементУправления)));
Возврат ТабДок;
КонецФункции
Разбор по шагам
Устанавливаем тип строки длиной четыре. Рисунок должен иметь тип Текст и содержать значение до вызова УстановитьЭлементУправления.
Маска 9999 ограничивает ввод цифровыми позициями. Она не заменяет серверную проверку бизнес-данных и не создаёт секретное поле.
Автоматическая отметка отключена: управляем флагом явно, сначала отмечаем пустое, затем снимаем отметку после проверки длины собственного значения.
ТолькоПросмотр и Защита выключены только у нового учебного документа. Редактирование этого кода не пишет в справочники.
Как проверить результат
Четыре булевы проверки дают Истина; последнее сообщение показывает фактический тип редактора.
В режиме редактирования собственного документа попробуйте изменить текстовый рисунок: значение ограничено четырьмя цифрами.
Автоматической повторной проверки после пользовательского ввода здесь нет: показанный контроль выполнен при построении.
Ожидаемый результат
Минимальная настройка редактора и явной отметки незаполненного значения.
На что обратить внимание
ПолеВвода здесь — тип редактора табличного рисунка, не ПолеФормы управляемой формы. Не создавайте этот редактор прямым Новый ПолеФормы.
Клиентские маски и отметки не являются проверкой прав, обязательности реквизита или защиты от подмены.
Поведение редактирования рисунков проверяйте в клиенте Windows; перенос в веб/мобильный клиент не обещается.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.