Обводит область рамкой.
Синтаксис
Обвести(<ГраницаСлева>, <ГраницаСверху>, <ГраницаСправа>, <ГраницаСнизу>)Примеры платформы
Линия = Новый Линия(ТипЛинииЯчейкиТабличногоДокумента.Сплошная,2);
Область = ДокументМакет.Область("Шапка");
Область.Обвести(Линия, Линия, Линия, Линия);Полное описание, параметры и ограничения
ОбластьЯчеекТабличногоДокумента.Обвести (SpreadsheetDocumentRange.Outline)
ОбластьЯчеекТабличногоДокумента (SpreadsheetDocumentRange)
Обвести (Outline)
Доступен, начиная с версии 8.2.
Синтаксис:
Обвести(<ГраницаСлева>, <ГраницаСверху>, <ГраницаСправа>, <ГраницаСнизу>)
Параметры:
<ГраницаСлева> (необязательный)
Тип: Линия.
Задает тип границы слева. Если параметр не указан, граница слева не рисуется.
<ГраницаСверху> (необязательный)
Тип: Линия.
Задает тип верхней границы. Если параметр не указан, верхняя граница не рисуется.
<ГраницаСправа> (необязательный)
Тип: Линия.
Задает тип границы справа. Если параметр не указан, граница справа не рисуется.
<ГраницаСнизу> (необязательный)
Тип: Линия.
Задает тип нижней границы. Если параметр не указан, нижняя граница не рисуется.
Описание:
Обводит область рамкой.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Пример:
Линия = Новый Линия(ТипЛинииЯчейкиТабличногоДокумента.Сплошная,2);
Область = ДокументМакет.Область("Шапка");
Область.Обвести(Линия, Линия, Линия, Линия);
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Настроить веса автоматической ширины колонок
Названию даём больший вес, количеству — меньший. Автоматическое растяжение влияет на отображение, а не на сумму заказа.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = УчебнаяТаблица();
Название = ТабДок.Область(, 1, , 1);
Количество = ТабДок.Область(, 2, , 2);
Название.РастягиватьПоГоризонтали = Истина;
Количество.РастягиватьПоГоризонтали = Истина;
Название.ВесовойКоэффициентШирины = 3;
Количество.ВесовойКоэффициентШирины = 1;
Количество.РежимИзмененияРазмераКолонки = РежимИзмененияРазмера.БыстроеИзменение;
ТабДок.Область(2, 1, 2, 4).ПоВыделеннымКолонкам = Ложь;
Сообщить(Название.ВесовойКоэффициентШирины = 3);
Сообщить(Количество.ВесовойКоэффициентШирины = 1);
Сообщить(Название.РастягиватьПоГоризонтали);
Сообщить(ТабДок.Область(5, 4).Значение = 800);
Возврат ТабДок;
КонецФункции
&НаСервереБезКонтекста
Функция УчебнаяТаблица()
ТабДок = Новый ТабличныйДокумент;
ТабДок.ТолькоПросмотр = Истина;
ТабДок.ОтображатьСетку = Ложь;
ТабДок.Область(, 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, Ложь);
Все.Обвести(Граница, Граница, Граница, Граница);
Возврат ТабДок;
КонецФункции
Разбор по шагам
Берём области целых колонок, не случайные прямоугольники одной строки.
Вес влияет на автоматический расчёт ширины; отношение 3:1 не объявляем точным отношением пикселей.
БыстроеИзменение относится к возможному пользовательскому изменению ширины, не к смене значения количества.
Как проверить результат
Четыре сравнения Истина: веса, включённое растяжение и итог 800.
В клиенте меняйте размер окна и сравнивайте ширины; фактическое оформление проверяется визуально отдельно.
Ожидаемый результат
Разделены автоматическая ширина, ручное изменение и бизнес-значения.
На что обратить внимание
Минимальные размеры и клиент могут влиять на фактическую ширину.
Вес колонки не является множителем суммы товара.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Собрать учебные расшифровки без предположения об их порядке
Книга и ручка получают строковые коды A-01 и B-02. Новый метод платформы 8.5.1 возвращает все элементы расшифровки области, но порядок не задан.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = УчебнаяТаблица();
Книга = ТабДок.Область(3, 1);
Ручка = ТабДок.Область(4, 1);
Книга.Расшифровка = "A-01";
Ручка.Расшифровка = "B-02";
Книга.Гиперссылка = Истина;
Ручка.Гиперссылка = Истина;
Книга.ИспользованиеРасшифровки = ИспользованиеРасшифровкиТабличногоДокумента.Ячейка;
Ручка.ИспользованиеРасшифровки = ИспользованиеРасшифровкиТабличногоДокумента.Ячейка;
Книга.РежимПодсветки = РежимПодсветкиЯчейкиТабличногоДокумента.Ячейка;
Коды = ТабДок.Область(3, 1, 4, 1).ПолучитьВсеРасшифровки();
Сообщить(ТипЗнч(Коды) = Тип("Массив"));
Сообщить(Коды.Найти("A-01") <> Неопределено);
Сообщить(Коды.Найти("B-02") <> Неопределено);
Сообщить(Книга.Текст = "Книга");
Сообщить(Ручка.Текст = "Ручка");
Возврат ТабДок;
КонецФункции
&НаСервереБезКонтекста
Функция УчебнаяТаблица()
ТабДок = Новый ТабличныйДокумент;
ТабДок.ТолькоПросмотр = Истина;
ТабДок.ОтображатьСетку = Ложь;
ТабДок.Область(, 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, Ложь);
Все.Обвести(Граница, Граница, Граница, Граница);
Возврат ТабДок;
КонецФункции
Разбор по шагам
Расшифровка содержит собственный код, не рабочую ссылку и не адрес сайта.
Гиперссылка разрешает обработку щелчком, но обработчик открывания объекта здесь не написан.
ПолучитьВсеРасшифровки доступен с 8.5.1; проверяем наличие обоих кодов через Найти, не по индексу.
Оформление не заменяет текст названия товара.
Как проверить результат
Пять сравнений Истина: массив, два известных кода и прежние названия.
Щелчок не должен трактоваться как готовая интеграция открытия карточки: нужен отдельный обработчик с проверкой кода.
Ожидаемый результат
Узнано, как хранить и извлекать содержательную расшифровку области.
На что обратить внимание
Порядок массива расшифровок не соответствует гарантированно порядку строк.
Не объявляйте учебный код существующей ссылкой справочника 1С.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.