Тип: Строка, ФорматированнаяСтрока. Содержит текст рисунка.
Полное описание, параметры и ограничения
РисунокТабличногоДокумента.Текст (SpreadsheetDocumentDrawing.Text)
РисунокТабличногоДокумента (SpreadsheetDocumentDrawing)
Текст (Text)
Доступен, начиная с версии 8.0.
Использование:
Чтение и запись.
Описание:
Тип: Строка, ФорматированнаяСтрока.
Содержит текст рисунка.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Применимо для рисунков типа Текст, Примечание. Для удаления примечания у области табличного документа необходимо установить данному свойству пустую строку.
Использование в версии:
Доступен, начиная с версии 8.0.
Описание изменено в версии 8.3.24.
Методическая информация
Практические примеры
Добавить примечание и защитить собственные ячейки от редактирования
Примечание содержит пояснение расчёта 3 × 250 = 750. Защита области не шифрует текст и не задаёт права пользователя базы.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = УчебнаяТаблица();
Ячейка = ТабДок.Область(3, 4);
Ячейка.Примечание.Текст = "Книга: 3 единицы × 250 = 750. Учебные данные.";
Ячейка.Защита = Истина;
Ячейка.Видимость = Истина;
Ячейка.Отступ = 1;
Ячейка.АвтоОтступ = 0;
Ячейка.ОриентацияТекста = 0;
Ячейка.Узор = ТипУзораТабличногоДокумента.Сплошной;
Ячейка.ЦветУзора = Новый Цвет(245, 248, 252);
Ячейка.ЦветФона = Новый Цвет(245, 248, 252);
Сообщить(СтрНайти(Ячейка.Примечание.Текст, "3 единицы") > 0);
Сообщить(Ячейка.Защита);
Сообщить(Ячейка.Видимость);
Сообщить(Ячейка.Значение = 750);
ТабДок.ТолькоПросмотр = Ложь;
Возврат ТабДок;
КонецФункции
&НаСервереБезКонтекста
Функция УчебнаяТаблица()
ТабДок = Новый ТабличныйДокумент;
ТабДок.ТолькоПросмотр = Истина;
ТабДок.ОтображатьСетку = Ложь;
ТабДок.Область(, 1, , 1).ШиринаКолонки = 35;
ТабДок.Область(, 2, , 2).ШиринаКолонки = 10;
ТабДок.Область(, 3, , 3).ШиринаКолонки = 14;
ТабДок.Область(, 4, , 4).ШиринаКолонки = 15;
Заголовок = ТабДок.Область(1, 1, 1, 4);
Заголовок.Объединить();
Заголовок.Текст = "Учебная таблица — данные только в памяти";
Заголовок.Шрифт = Новый Шрифт("Arial", 12, Истина);
Заголовок.ЦветФона = Новый Цвет(230, 242, 255);
Заголовок.ВысотаСтроки = 24;
ТабДок.Область(2, 1).Текст = "Товар";
ТабДок.Область(2, 2).Текст = "Количество";
ТабДок.Область(2, 3).Текст = "Цена";
ТабДок.Область(2, 4).Текст = "Сумма";
Товары = Новый Массив;
Товары.Добавить(Новый Структура("Название,Количество,Цена", "Книга", 3, 250));
Товары.Добавить(Новый Структура("Название,Количество,Цена", "Ручка", 1, 50));
НомерСтроки = 3;
Итого = 0;
Для Каждого Товар Из Товары Цикл
ТабДок.Область(НомерСтроки, 1).Текст = Товар.Название;
Значения = Новый Массив;
Значения.Добавить(Товар.Количество);
Значения.Добавить(Товар.Цена);
Значения.Добавить(Товар.Количество * Товар.Цена);
Для НомерКолонки = 2 По 4 Цикл
Ячейка = ТабДок.Область(НомерСтроки, НомерКолонки);
Ячейка.СодержитЗначение = Истина;
Ячейка.ТипЗначения = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
Ячейка.Значение = Значения.Получить(НомерКолонки - 2);
Ячейка.Формат = "ЧДЦ=2; ЧН=0";
КонецЦикла;
Итого = Итого + Товар.Количество * Товар.Цена;
НомерСтроки = НомерСтроки + 1;
КонецЦикла;
ПодписьИтога = ТабДок.Область(5, 1, 5, 3);
ПодписьИтога.Объединить();
ПодписьИтога.Текст = "Итого";
Итог = ТабДок.Область(5, 4);
Итог.СодержитЗначение = Истина;
Итог.ТипЗначения = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
Итог.Значение = Итого;
Итог.Формат = "ЧДЦ=2; ЧН=0";
Все = ТабДок.Область(2, 1, 5, 4);
Все.Шрифт = Новый Шрифт("Arial", 10);
Граница = Новый Линия(ТипЛинииЯчейкиТабличногоДокумента.Сплошная, 1, Ложь);
Все.Обвести(Граница, Граница, Граница, Граница);
Возврат ТабДок;
КонецФункции
Разбор по шагам
Примечание — объект РисунокТабличногоДокумента; его текст задаём через Примечание.Текст.
Защита включена только для собственной ячейки; весь документ разрешаем просматривать и пробовать редактировать в учебном клиенте.
Отступ измеряется символами, угол — градусами; фон и узор не меняют числовую сумму.
Как проверить результат
Четыре проверки Истина: пояснение, защита, видимость и сумма 750.
В клиенте проверьте примечание и невозможность изменения защищённой ячейки; статическая проверка это не подтверждает.
Ожидаемый результат
Добавлено понятное объяснение суммы и локальная защита редактирования.
На что обратить внимание
Примечание может быть доступно получателю файла: не размещайте секреты.
Защита UI не заменяет роли, RLS или проверку прав на сервере.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Удалить собственные черновые рисунки и оставить полезную подпись
Коллекция рисунков поддерживает получение, индекс и удаление по объекту. Очистить применяем только к отдельному черновому документу, не к рабочему макету.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = Новый ТабличныйДокумент;
Черновик = Новый ТабличныйДокумент;
Прямоугольник = Черновик.Рисунки.Добавить(ТипРисункаТабличногоДокумента.Прямоугольник);
Прямоугольник.Имя = "ЧерноваяРамка";
Эллипс = Черновик.Рисунки.Добавить(ТипРисункаТабличногоДокумента.Эллипс);
Эллипс.Имя = "ЧерновойКруг";
Сообщить(Черновик.Рисунки.Количество() = 2);
ИндексКруга = Черновик.Рисунки.Индекс(Эллипс);
Сообщить(Черновик.Рисунки.Получить(ИндексКруга).Имя = "ЧерновойКруг");
Черновик.Рисунки.Удалить(Прямоугольник);
Сообщить(Черновик.Рисунки.Количество() = 1);
Черновик.Рисунки.Очистить();
Сообщить(Черновик.Рисунки.Количество() = 0);
Надпись = ТабДок.Рисунки.Добавить(ТипРисункаТабличногоДокумента.Текст);
Надпись.Имя = "ПолезнаяПодпись";
Надпись.Лево = 5;
Надпись.Верх = 5;
Надпись.Ширина = 80;
Надпись.Высота = 15;
Надпись.Текст = "Подпись только для экрана";
Надпись.ВыводитьНаПечать = Ложь;
ТабДок.ТолькоПросмотр = Истина;
Сообщить(ТабДок.Рисунки.Количество() = 1);
Сообщить(Не Надпись.ВыводитьНаПечать);
Возврат ТабДок;
КонецФункции
Разбор по шагам
Две черновые фигуры создаются в отдельном новом документе Черновик. Их можно удалять без ущерба для возвращаемого ТабДок.
Индекс ищет позицию объекта; Получить читает по индексу с 0. Удалить принимает сам объект рисунка, не обязательно число.
Очистить удаляет все рисунки черновика. Возвращаемый документ содержит другую полезную надпись.
ВыводитьНаПечать = Ложь оставляет надпись для экрана и исключает из возможной печати. В упражнении принтер не вызывается.
Как проверить результат
Шесть проверок дают Истина.
В показе остаётся только Подпись только для экрана. Черновые фигуры не передаются клиенту.
Ожидаемый результат
Полный цикл собственной коллекции без удаления элементов чужого макета.
На что обратить внимание
Очистить у рисунков не очищает содержимое ячеек, но удалит все рисунки данного документа.
Имена рисунков не заменяют устойчивую проверку наличия объекта; здесь все экземпляры созданы перед использованием.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.