Admin: 1 revision imported

2021-02-07T06:53:49Z

1 revision imported

Admin at 14:44, 8 August 2020

2020-08-08T14:44:47Z

New page

{{infobox function
|name=CopyByY
|object=[[Электронная таблица SFT|Электронная таблица]]
|caption=Работа с шаблонами
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число, неверные параметры, ошибка исполнения
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Электронная таблица SFT|Электронная таблица]]}}
Функция производит работу в другом направлении, по сравнении с функцией [[Table.CopyByX|CopyByX]], и выполняет копирование указанной области ячеек и объектов, находящихся внутри этой области из таблицы-шаблона в текущую таблицу, начиная с ячейки, заданной атрибутами [[Table.CurPutX|CurPutX]] и [[Table.CurPutY|CurPutY]]. В момент копирования тексты и значения ячеек и объектов, являющиеся шаблонами, будут превращены в результаты их вычисления. Если третий аргумент равен 1, до начала копирования, функция переводит курсор копирования на первую строку и производит сдвиг курсора по горизонтали (размер сдвига по горизонтали определяется шириной области, которая была скопирована в таблицу до текущей). После окончания копирования функция переводит курсор копирования вниз на высоту области копирования. Если четвертый аргумент равен 1, функция не будет изменять размеры строк или столбцов в соответствии с размерами строк и столбцов копируемой области, однако, при копировании текста в ячейки, автоматически рассчитываемые размеры строк или столбцов по-прежнему будут изменены, если это необходимо. После копирования любого визуального объекта, функция вызывает событие [[OnFinishCopyObject]], если оно существует в текущем или глобальном модуле.

На рисунке показан вид простой таблицы-шаблона. Области таблицы имеют свои имена. При использовании функции, для указания на область копирования, формат определения области следующий: <code><Имя области шаблона>[|<Имя области шаблона пересекающегося измерения>]</code> либо <code><Имя области шаблона>[,<Имя области шаблона пересекающегося измерения>]</code>, либо прямое указание на область копирования <code><Левый столбец области>:<Верхняя строка области>,<Правый столбец области>:<Нижняя строка области></code> (нумерация начинается с единицы). Т.е., для именованных областей на рисунке, <code>v1</code> будет подразумеваться область ячеек в диапазоне <code>1:1,<ширина таблицы>:6</code>; для <code>h1</code> подразумевается область <code>1:1,2:9</code> (9 -- высота таблицы); для <code>h1|v2</code> подразумевается область <code>1:7,2:7</code>.

<gallery widths=435px heights=271px>
Table Template Ex.png||Рис. Простая таблица-шаблон с именованными областями для копирования
</gallery>

При копировании в новую таблицу области "h1|v2" с рисунка с помощью функции ''CopyByX'':
# Если второй аргумент равен 1, атрибут [[Table.CurPutY|CurPutY]] примет значение 1, а [[Table.CurPutX|CurPutX]] увеличится на ширину предыдущей области.
# Будут скопированы ячейки диапазона <code>1:7,2:7</code> в результирующую таблицу в область, начинающуюся с верхней левой ячейки <code><CurPutX>:<CurPutY></code>
# Будет произведен поиск переменной <code>пДата</code> и значение копируемой ячейки будет изменено на ее значение (если переменная не существует, будет вызвано исключение). Для копируемых ячеек, содержащих вычисляемые выражения, а не просто переменные, будет произведено вычисление выражений.
# Атрибут [[Table.CurPutY|CurPutY]] увеличится на 1 (высота области).
# Если третий параметр равен нулю, в таблице, в которую производится копирование, будет изменена ширина столбцов ''CurPutX-2'' и ''CurPutX-1'' в соответствии с шириной столбца 1 и 2 таблицы-шаблона, высота строки будет подсчитана автоматически исходя из высот всех ячеек, уже находящихся в строке ''CurPutY'' (так как строка на рисунке имеет установку автоматической высоты).
# Будут скопированы неразрывные регионы, попадающие в область (в данном примере отсутствуют).
# Будут скопированы разбиения страницы, попадающие в область (в данном примере отсутствуют).
# Будут скопированы объекты таблицы, попадающие в область (в данном примере отсутствуют), для значений объектов, с установленным флажком "значение для вычисления", значения будут вычислены, как это происходило для значений ячеек. Для каждого скопированного объекта, будет вызвано событие [[OnFinishCopyObject]].

== Синтаксис ==
<code>
{{Grey|Table.}}'''CopyByY'''(''<Указание на область таблицы-шаблона (STRING)>''{{Optional|,<Перейти на новый столбец до добавления области (INT)>{{Default|{{Eq}}0}},<Не производить изменения размеров столбцов или строк (INT)>{{Default|{{Eq}}0}}}})
</code>

==== Аргументы ====
* <code>''<Указание на область таблицы-шаблона (STRING)>''</code> - Строковой аргумент в формате наименований областей или прямого указания на ячейки таблицы-шаблона (см. выше).
* <code>''<Перейти на новый столбец до добавления области (INT)>''</code> - {{Optional}} Если аргумент равен 1, атрибут [[Table.CurPutY|CurPutY]] принимает значение 1, а [[Table.CurPutX|CurPutX]] увеличивается на ширину предыдущей добавленной области до начала копирования (см. пример выше).
* <code>''<Не производить изменения размеров столбцов или строк (INT)>''</code> - {{Optional}} Задает режим, когда пересчета ширины столбцов или высоты строк таблицы результата, попадающих в диапазон копирования, для которых не установлен признак "автоматическое изменение", не будет происходить. Это немного увеличивает скорость копирования и может использоваться, если размеры уже заданы, и в шаблоне они неверные.

== Примеры ==
<pre>
Т.CopyByY("v1|h1",1);
For i:=1 To СпСтроки.Size() Do

...

Т.CopyByY("v1|h2");
EndDo;
Т.CopyByY("v1|h3");

Т.Options.FixedLine:=Т.Height();
Т.Options.FixedColumn:=4;
</pre>

← Older revision	Revision as of 06:53, 7 February 2021
(No difference)

Table.CopyByY - Revision history

Admin: 1 revision imported

Admin at 14:44, 8 August 2020