Тип: Строка. Содержит имя рисунка.
Полное описание, параметры и ограничения
РисунокТабличногоДокумента.Имя (SpreadsheetDocumentDrawing.Name)
РисунокТабличногоДокумента (SpreadsheetDocumentDrawing)
Имя (Name)
Доступен, начиная с версии 8.0.
Использование:
Чтение и запись.
Описание:
Тип: Строка.
Содержит имя рисунка.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Для рисунка типа Примечание недоступно.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Выделить мартовское значение на диаграмме табличного документа
Методы рисунка работают с элементами диаграммы: точкой, серией или значением. Это не выделение самого рисунка в документе.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = Новый ТабличныйДокумент;
Рисунок = ТабДок.Рисунки.Добавить(ТипРисункаТабличногоДокумента.Диаграмма);
Рисунок.Имя = "УчебнаяДиаграмма";
Рисунок.Расположить(ТабДок.Область(1, 1, 20, 10));
Диаграмма = Рисунок.Объект;
Диаграмма.ТипДиаграммы = ТипДиаграммы.Гистограмма;
План = Диаграмма.УстановитьСерию("plan");
План.Текст = "План, шт.";
Факт = Диаграмма.УстановитьСерию("actual");
Факт.Текст = "Факт, шт.";
Месяцы = Новый Массив;
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-01", "Январь", 10, 8));
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-02", "Февраль", 12, 11));
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-03", "Март", 15, 16));
Для Каждого Месяц Из Месяцы Цикл
Точка = Диаграмма.УстановитьТочку(Месяц.Ключ);
Точка.Текст = Месяц.Название;
Диаграмма.УстановитьЗначение(Точка, План, Месяц.План);
Диаграмма.УстановитьЗначение(Точка, Факт, Месяц.Факт);
КонецЦикла;
Диаграмма.РежимВыделения = РежимВыделенияДиаграммы.ВыделениеЗначений;
Март = Диаграмма.УстановитьТочку("2026-03");
МартФакт = Диаграмма.ПолучитьЗначение(Март, Факт);
Выделение = Новый Массив;
Выделение.Добавить(МартФакт);
Рисунок.УстановитьВыделенныеЭлементы(Выделение);
Выбранные = Рисунок.ПолучитьВыделенныеЭлементы();
Сообщить(Выбранные.Количество() = 1);
Сообщить(ТипЗнч(Выбранные.Получить(0)) = Тип("ЗначениеДиаграммы"));
Сообщить(МартФакт.Значение = 16);
Рисунок.УстановитьВыделенныеЭлементы(Новый Массив);
Сообщить(Рисунок.ПолучитьВыделенныеЭлементы().Количество() = 0);
ТабДок.ТолькоПросмотр = Истина;
Возврат ТабДок;
КонецФункции
Разбор по шагам
Рисунок типа Диаграмма создаёт объект диаграммы. Расположить принимает область ячеек; это другой способ задания геометрии, не четыре числовых аргумента.
В собственной матрице мартовский факт равен 16. ПолучитьЗначение возвращает объект ЗначениеДиаграммы для пары точка/серия.
УстановитьВыделенныеЭлементы получает массив именно объектов диаграммы. Проверяем количество/тип, затем снимаем выделение пустым массивом.
В финальном показе выделение снято намеренно. Для демонстрации выделенного марта временно не выполняйте последние две строки снятия/проверки.
Как проверить результат
Четыре проверки дают Истина.
В показе план/факт за три месяца: 10/8, 12/11, 15/16. Выделение элементов и изменение чисел — разные операции.
Ожидаемый результат
Управление выделением одного значения без редактирования данных диаграммы.
На что обратить внимание
Эти методы предназначены для рисунка типа Диаграмма, не для картинки или надписи.
Массив неподходящих типов игнорируется платформой; не передавайте строку 2026-03 вместо объекта точки/значения.
ВыделенныеОбласти табличного документа выделяют другой уровень объектов и здесь не используются.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Показать отрицательное число в текстовом рисунке
СодержитЗначение включает типизированное значение. Формат регулирует представление, но число остаётся числом и пригодно для вычислений.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте 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 и не попадает автоматически в формулу итога.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.