Difference between revisions of "Электронная таблица SFT"
1>Admin (→Атрибуты и функции визуальных объектов таблицы (Table.Object)) |
m (1 revision imported) |
(No difference)
|
Revision as of 08:05, 7 August 2023
![]() | |||||||
---|---|---|---|---|---|---|---|
|
Объект электронная таблица SFT дает возможность создания, заполнения, вывода на экран и принтер, а также чтения данных и проведения других операций с электронными таблицами SFT. Обычно объект используется для создания и вывода на экран отчетов и печатных форм документов. В таких случаях, алгоритм работы с объектом следующий:
- Создается новый объект и задается таблица-шаблон (по умолчанию файл шаблона Table должен находиться в той же папке (объекте), где находится модуль, создающий объект, однако, путь и имя таблицы-шаблона можно задать с помощью функции SetSourceName). Создавать таблицу с нуля, программно изменяя шрифт каждой ячейки, тип границ и объединения, является очень сложной и трудоемкой задачей, поэтому, такой подход на практике не применяется, а используется таблица-шаблон (или несколько таких таблиц). Шаблон представляет собой обычную таблицу, при создании отчета или печатной формы документа, заданные части шаблона будут копироваться в новую создаваемую таблицу. При копировании частей шаблона, система автоматически заполняет ячейки с формулами результатом их выполнения (такие ячейки в таблице-шаблоне имеют галочку "Текст представляет собой выражения для вычисления", см. Редактор электронных таблиц), это дает возможность предусмотреть в шаблоне ячейки с сальдо, наименованиями и реквизитами юридических лиц и прочим, в зависимости от типа выводимой формы. Для удобства написания программ, нужные куски таблицы-шаблона отмечаются на этапе редактирования, им присваиваются свои наименования, по которым программа может обращаться к ним, чтобы из этих кусков сконструировать таблицу-результат.
- Выполняется запрос или требуемые данные подготавливаются другим путем.
- Происходит обход по результату запроса или другим данным и последовательное добавление нужных частей таблицы-шаблона в таблицу результат с заполнением ячеек данными, полученными в цикле обхода (Для копирования частей таблицы-шаблона можно использовать функции CopyByX, CopyByY, CopyTitles, CopyTo).
- Созданная новая электронная таблица выводится на экран или принтер.
При программной работе с объектом нужно различать четыре типа объектов: сама электронная таблица SFT, объект область таблицы (Area) (получаемая с помощью вызова функций типа Area и необходимая для проведения прямого изменения в ячейках области), объект свойств таблицы (Options) (включающий множество подобъектов, к примеру, выделение или свойства печати) и объект визуальных элементов (объектов) таблицы (Objects). Все объекты связаны с электронной таблицей SFT, которая не будет удалена из памяти до тех пор, пока останется по крайней мере один объект, ссылающийся на нее. Ячейки таблицы могут содержать объекты языка любого вида, поэтому кроме внешних ссылок на таблицу, иногда может возникнуть ситуация, когда внутри какой-либо ячейки (или визуального элемента) хранится ссылка на самую же таблицу, это бывает, к примеру, когда в визуальной кнопке таблицы для обновления результата отчета, хранится список с данными, связанными с этим отчетом, в том числе сама таблица. Для таблиц, которые хранят ссылки на самих себя требуется указывать количество таких ссылок с помощью атрибута SelfReferenceCount, иначе после удаления последнего объекта, ссылающегося на таблицу, таблица останется в памяти (см. Ссылки на самого себя).
Основные свойства ячейки таблицы перечислены ниже:
- Таблица может иметь практически неограниченное количество столбцов и строк (до 2 млрд.), сдвигая видимое поле, пользователь может увидеть любую ячейку таблицы. Память для хранения ячеек выделяется только для определенного количества столбцов и строк таблицы, этот диапазон задает высоту и ширину таблицы. При изменении текста или других свойств ячейки вне диапазона этих строк и столбцов, выделенный диапазон автоматически расширяется.
- Ячейка содержит текст в ANSI или UTF-16 кодировках, либо текст шаблона, представляющего собой программу на встроенном языке, программа будет исполнена и результат будет записан, как текст ячейки в момент копирования частей таблицы-шаблона в таблицу результат.
- Ячейка содержит произвольный объект встроенного языка, использующийся как значение ячейки при клике по ячейке или редактировании оной. Вместо объекта языка в ячейке может находиться текст шаблона, представляющего собой программу на встроенном языке, программа будет исполнена и результат будет записан, как значение ячейки в момент копирования частей таблицы-шаблона в таблицу результат.
- Текст ячейки может иметь стандартные свойства форматирования: шрифт, выделение, цвет фона, цвет текста и рамки и пр., либо для ячейки может быть задан шаблон цвета (color template). В последнем случае, пользователи смогут выбирать другую палитру цветов, по своему желанию, поэтому, использование шаблонов цвета предпочтительнее при формировании результатов отчетов.
- Ячейки могут быть объединены между собой в группы ячеек. Текст в такой группе будет использовать все пространство группы и будет получен из верхней левой ячейки группы.
- Ячейки имеют разнообразные свойства переноса текста, выравнивания по горизонтали и вертикали, отступов по горизонтали и вертикали, угол направления текста и пр.
- Каждая ячейка имеет четыре границы вокруг себя, каждая из границ может иметь свой рисунок и цвет. Из-за использования шаблонов для создания таблиц-результата, двух границ для каждой ячейки недостаточно.
- Столбцы и строки таблицы имеют дополнительное свойство "автоматическое расширение", обычно номера таких строк или столбцов выделены визуально для удобства создания таблиц-шаблонов. Строки или столбцы со свойством "автоматическое расширение" будут автоматически изменять размеры, в зависимости от текста, помещенного внутрь их ячеек.
- При печати больших таблиц, происходит их распределение на несколько листов, иногда важно, чтобы определенные блоки текста (строки или столбцы) не разделялись и шли всегда вместе (к примеру, блок с подписями и печатями), для этого предусмотрены блоки строк или столбцов без разделения.
Основные свойства визуальных элементов (объектов) таблицы перечислены ниже:
- Объекты могут быть добавлены в любое место таблицы и могут представлять собой не только текстовые поля, но и рисунки, OLE-объекты и пр.
- Объект содержит текст в ANSI или UTF-16 кодировках, либо текст шаблона, представляющего собой программу на встроенном языке. Для шаблонов, программа будет исполнена и результат будет записан, как текст ячейки в момент копирования частей таблицы-шаблона в таблицу результат.
- Объект содержит произвольный объект встроенного языка, использующийся как значение ячейки при клике по ячейке или редактировании оной. Вместо объекта языка в ячейке может находиться текст шаблона, представляющего собой программу на встроенном языке, программа будет исполнена и результат будет записан, как значение ячейки в момент копирования частей таблицы-шаблона в таблицу результат.
- Текст объекта может иметь стандартные свойства форматирования: шрифт, выделение, цвет фона, цвет текста и рамки и пр., либо для ячейки может быть задан шаблон цвета (color template). В последнем случае, пользователи смогут выбирать другую палитру цветов, по своему желанию, поэтому, использование шаблонов цвета предпочтительнее при формировании результатов отчетов.
- Объекты имеют разнообразные свойства переноса текста, выравнивания по горизонтали и вертикали, отступов по горизонтали и вертикали, угол направления текста и пр.
- Каждый объект имеет четыре границы вокруг себя, каждая из границ может иметь свой рисунок и цвет.
- Объект может не выводиться на печать, если это необходимо
- Объект может иметь наименование, по которому можно обратиться к нему из текста программы
- Положение и размеры объекта могут быть привязаны к абсолютной координате внутри таблицы или к определенной ячейке таблицы. Таким образом можно создать объекты, которые не будут перемещаться или/и изменять размеры при изменении размеров ячеек таблицы, либо будут привязаны к определенным ячейкам.
Не стоит путать электронные таблицы SFT (наименование интерфейса объекта Table) и таблицы значений (наименование интерфейса объекта Tab), это совершенно разные объекты.
Пример создания электронной таблицы с помощью таблицы-шаблона и вывода ее на экран/печать
Простой пример выполнения запроса и вывода информации в виде отчета с произвольным количеством горизонтальных столбиков.
//Переменные, которые были подготовлены заранее: //спНоменклатура -- список номенклатурных позиций, выводящихся в отчет (горизонтальные строки отчета с папками) //спТипыЦен -- список типов цен, которые будут следовать по горизонтали столбиками //ДатаФормирования -- дата нахождения цены //Выполняем запрос для получения горизонтального разреза ТЗ:="зН:=Ref.Номенклатура; |зСтатус:=Ref.Номенклатура.@STATUS;Condition(зСтатус=0); |зПапка:=Ref.Номенклатура.@ISFOLDER; |Condition(зПапка=0); |Condition(зН IN спНоменклатура); |Group зН with folders;"; З:=Query.Create(); З.Execute(ТЗ); Т:=Table.Create(); Т.SetSourceName("Отчет"); //Здесь и далее переменные с префиксом "п" используются в таблице-шаблоне "Отчет" в соответствующих ячейках, // при копировании куска таблицы с помощью CopyByX, ячейки автоматически заполняются значениями нужных переменных. пЗагол:="Отчет по ценам номенклатуры"; //Копирование из таблицы-шаблона будет осуществляться слева направо и затем сверху вниз //Столбец "h1" в таблице-шаблоне содержит столбец с наименованием номенклатурной позиции, левый отступ, порядковый номер и пр. //Столбец "h2" -- цена текущей позиции по типу цен из спТипыЦен //Столбец "h3" -- завершает таблицу (правая граница) //Строка "v1" таблицы-шаблона содержит заголовок отчета с заголовками столбцов //Строка "v2" таблицы-шаблона содержит одну строку отчета //Строка "v3" таблицы-шаблона содержит одну строку папки отчета, цены для папок не выводятся //Строка "v4" таблицы-шаблона завершает отчет снизу (нижняя граница) //Первый блок добавляется "с начала строки" Т.CopyByX("v1|h1",1); For i:=1 to спТипыЦен.Size() Do пТипЦен:=спТипыЦен.Get(i); //Последующие блоки добавляются слева направо без перевода на другую строку, пТипЦен выводится в заголовки столбцов Т.CopyByX("v1|h2"); EndDo; //Окончание вывода блока заголовка таблицы Т.CopyByX("v1|h3"); //Фиксирование заголовка, чтобы он всегда был на экране при перемещении курсора по таблице Т.Options.FixedLine:=Т.Height(); пКолВо:=0; While З.Next(1) Do //Переменные используются в столбце "h1" пН:=З.зН; пКод:=пН.Code; If пН.IsFolder() Then //Вывод строки с папкой Т.CopyByX("v3|h1",1); For i:=1 to спТипыЦен.Size() Do Т.CopyByX("v3|h2"); EndDo; Т.CopyByX("v3|h3"); пКолВо:=пКолВо+1; Else //Вывод обычной строки Т.CopyByX("v2|h1",1); For i:=1 to спТипыЦен.Size() Do пЦ:=глНайтиЦену(З.зН,спТипыЦен.Get(i),ДатаФормирования); Т.CopyByX("v2|h2"); EndDo; Т.CopyByX("v2|h3"); EndIf; //Вывод информации о состоянии формирования отчета пКолВо:=пКолВо+1; //Этот текст выводится в строку состояния Form.StatusText(""+пКолВо+" из "+З.ResultTable.Size()); //Этот текст выводится в виде индикатора выполнения, как подсказка при наведении курсора мыши на кнопку задачи отчета Form.UpdateProgress(пКолВо,З.ResultTable.Size()); EndDo; //Выведем нижнюю границу отчета Т.CopyByX("v4|h1",1); For i:=1 to спТипыЦен.Size() Do Т.CopyByX("v4|h2"); EndDo; Т.CopyByX("v4|h3"); //Изменим параметры печати Т.Printing.Orientation:=1; Т.Printing.ScaleMode:=1; //Режим просмотра для удобства пользователя Т.EditorMode:=1; //Выводим на экран или принтер? If флВывестиСразуНаПринтер Then Т.Printing.Printer:=тПринтер; Т.Print(); Else Т.Show(пЗагол); EndIf;
Основные атрибуты и функции
Данный раздел содержит основные функции, которые используются совместно с объектом электронной таблицы.
Идентификатор | Статус | Тип | Визуальная | Параметры | Описание |
---|---|---|---|---|---|
Create | Реализована | Функция | Table.Create():<Новый объект электронной таблицы (TABLE)> | Функция создает новый объект электронной таблицы. | |
CurLine | Реализована | Атрибут | Да
|
Table.CurLine:<Строка визуального курсора таблицы (INT)> | Получить или изменить текущую строку курсора таблицы. Курсор таблицы только косвенно связан с выделенными ячейками таблицы и не зависит от текущего выделения, для получения информации по выделению в таблице, используйте атрибут Selection. Нумерация строк начинается с единицы. |
CurColumn, CurCol | Реализована | Атрибут | Да
|
Table.CurColumn:<Столбец визуального курсора таблицы (INT)> | Получить или изменить текущий столбец курсора таблицы. Курсор таблицы только косвенно связан с выделенными ячейками таблицы и не зависит от текущего выделения, для получения информации по выделению в таблице, используйте атрибут Selection. Нумерация столбцов начинается с единицы. |
CurPutX | Реализована | Атрибут | Table.CurPutX:<Столбец курсора добавления областей к таблице (INT)> | Получить или изменить текущий столбец курсора добавления областей к таблице. Курсор добавления областей используется в момент вызова функций CopyByX и CopyByY и определяет место добавления следующей области из таблицы-шаблона. Нумерация столбцов начинается с единицы. | |
CurPutY | Реализована | Атрибут | Table.CurPutY:<Строка курсора добавления областей к таблице (INT)> | Получить или изменить текущую строку курсора добавления областей к таблице. Курсор добавления областей используется в момент вызова функций CopyByX и CopyByY и определяет место добавления следующей области из таблицы-шаблона. Нумерация строк начинается с единицы. | |
EditorMode | Реализована | Атрибут | Да
|
Table.EditorMode:<Режим редактирования таблицы (INT)> | Получить или изменить режим редактирования таблицы. |
Restrict | Реализована | Атрибут | Да
|
Table.Restrict:<Режимы запрета работы с таблицей (INT)> | Получить или изменить режимы запрета работы с таблицей. |
Scale | Реализована | Атрибут | Да
|
Table.Scale:<Масштаб отображения таблицы (INT)> | Получить или изменить масштаб отображения таблицы на экране. Масштаб по умолчанию равен 100. |
SelectionMode | Реализована | Атрибут | Да
|
Table.SelectionMode:<Тип текущего выделения ячеек (INT)> | Получить тип текущего выделения ячеек или визуальных элементов таблицы. |
SelfReferenceCount | Реализована | Атрибут | Table.SelfReferenceCount:<Количество ссылок на себя в объектах таблицы (INT)> | Атрибут позволяет получить или изменить количество ссылок на себя, хранящихся в объектах таблицы. Если не установить это число корректно, таблица не может быть удалена из памяти, так как количество ссылок на нее останется больше нуля, когда она будет удалена из ссылающейся последней переменной, и это приведет к утечке памяти. | |
AttachedModule | Реализована | Атрибут | Table.AttachedModule:<Связать текущий модуль с событиями таблицы (INT)> | Атрибут позволяет получить или изменить свойство связи текущего модуля со свободной таблицей. Если модуль будет закрыт позже, а таблица останется открытой, события таблиц типа OnDoubleClick будут вызываться сначала в этом связанном модуле, а уже потом в модуле, под которым работает таблица, или в глобальном модуле. Это удобно для отчетов, которые производят определенные действия при работе со свободными таблицами, получаемыми в результате их выполнения. Таким образом можно избежать утери этой функциональности, если обработка отчета будет закрыта, но нужно понимать, что вызванное таким образом событие, возможно будет работать со стеком и переменными другого модуля. Также стоит заметить, что функция ModuleTag понимает эту связь и будет отдавать переменную, привязанную именно к модулю таблицы. | |
PrintSettingsChanged | Реализована | Атрибут | Table.PrintSettingsChanged():<Были изменены установки печати таблицы (INT)> | Атрибут возвращает 1, если были изменены любые установки, связанные с печатью таблицы (кроме названия принтера). После выполнения печати этот атрибут автоматически сбрасывается. Атрибут может использоваться в универсальных обработчиках печати, а также для сохранения индивидуальных изменений печатных форм. | |
ResetCursor | Реализована | Функция | Да
|
Table.ResetCursor() | Функция сдвигает видимое пространство таблицы таким образом, чтобы ячейка, в которой находится визуальный курсор, была видна на экране, если визуальный курсор уже виден на экране, функция не производит никаких изменений. Положение курсора не изменяется. |
SetCursor | Реализована | Функция | Да
|
Table.SetCursor(<Столбец курсора (INT)>,<Строка курсора (INT)>) | Функция перемещает визуальный курсор в требуемую ячейку таблицы. При этом сдвига видимого пространства таблицы не происходит и курсор может оказаться за пределами видимости. |
AddObject | Реализована | Функция | Table.AddObject(<Тип визуального объекта (INT)>,<Наименование объекта (STRING)>,<Источник объекта>,<Тип координат объекта (INT)>=0,<Координаты объекта (STRING)>) | Функция добавляет новый объект в таблицу. Для объекта указывается тип, координаты, наименование. Если объект имеет тип OLE или картинка, также задается дополнительный параметр "источник объекта". | |
Lock | Реализована | Функция | Да
|
Table.Lock() | Функция блокирует отображения изменений в таблице до вызова функции Unlock. Функция может использоваться перед большим количеством обновлений или заполнении таблицы для получения значительного ускорения операции. Функцию не имеет смысла вызывать для таблиц, которые (еще) не были выведены на экран, так как такие таблицы не обновляются визуально. |
Unlock | Реализована | Функция | Да
|
Table.Unlock() | Функция снимает блокировку отображения изменений в таблице, установленную функцией Lock, и вызывает полное визуальное обновление таблицы. |
Update | Реализована | Функция | Да
|
Table.Update() | Функция вызывает полное визуальное обновление таблицы. |
Size, Lines, Height | Реализована | Функция | Table.Size(<Новое количество выделенных строк в таблице (INT)>):<Количество выделенных строк в таблице (INT)> | Функция получает или изменяет высоту таблицы (количество строк в таблице, где производились какие-либо изменения, либо строки были скопированы из таблицы-шаблона и т.п.). При уменьшении количества строк, удаление будет происходить с конца таблицы. | |
SizeC, Columns, Width | Реализована | Функция | Table.SizeC(<Новое количество выделенных столбцов в таблице (INT)>):<Количество выделенных столбцов в таблице (INT)> | Функция получает или изменяет ширину таблицы (количество столбцов в таблице, где производились какие-либо изменения, либо столбцы были скопированы из таблицы-шаблона и т.п.). При уменьшении количества столбцов, удаление будет происходить с конца таблицы. | |
InsertColumns | Планируется | Функция | Table.InsertColumns(<Начиная со столбца (INT)>,<Количество столбцов (INT)>=1,<Ширина вставляемых столбцов (INT)>,<Автоматическая ширина столбцов (INT)>=0) | Функция вставляет требуемое количество столбцов начиная с требуемой позиции. Вставка столбцов может вызвать разъединение областей ячеек, если области включают позицию добавления. | |
InsertLines | Планируется | Функция | Table.InsertLines(<Начиная со строки (INT)>,<Количество строк (INT)>=1,<Высота вставляемых строк (INT)>,<Автоматическая высота строк (INT)>=1) | Функция вставляет требуемое количество строк начиная с требуемой позиции. Вставка строк может вызвать разъединение областей ячеек, если области включают позицию добавления. | |
RemoveColumns | Планируется | Функция | Table.RemoveColumns(<Начиная со столбца (INT)>,<Количество столбцов (INT)>=1) | Функция удаляет требуемое количество столбцов начиная с требуемой позиции. Удаление столбцов может вызвать разъединение областей ячеек, если области включают удаляемые столбцы. | |
RemoveLines | Планируется | Функция | Table.RemoveLines(<Начиная со строки (INT)>,<Количество строк (INT)>=1) | Функция удаляет требуемое количество строк начиная с требуемой позиции. Удаление строк может вызвать разъединение областей ячеек, если области включают удаляемые строки. | |
Copy | Реализована | Функция | Table.Copy():<Копия таблицы (TABLE)> | Функция создает полную копию таблицы в памяти. | |
Clear | Реализована | Функция | Table.Clear() | Функция удаляет все столбцы и ячейки и объекты из таблицы и устанавливает все свойства таблицы по умолчанию. | |
Find | Планируется | Функция | Table.Find(<Текст для поиска (STRING)>,<Установки поиска (INT)>=0,<Область поиска (STRING)>,<Переместить курсор на найденную ячейку (INT)>=0):<Найденная ячейка (STRING)> | Функция производит поиск строки или части строки в тексте ячеек указанной области таблицы (или во всей таблице), руководствуясь заданными правилами. Если ячейка найдена, функция возвращает ее координату в виде строки "<Столбец>:<Строка>" (пример "12:100") и перемещает курсор в найденную ячейку, если это необходимо, если ячейка не найдена, функция возвращает пустую строку.
| |
FindByValue | Реализована | Функция | Table.FindByValue(<Значение для поиска>,<Установки поиска (INT)>=0,<Область поиска (STRING)>,<Переместить курсор на найденную ячейку (INT)>=0):<Найденная ячейка (STRING)> | Функция производит поиск строки или части строки в значениях ячеек указанной области таблицы (или во всей таблице), руководствуясь заданными правилами. Если ячейка найдена, функция возвращает ее координату в виде строки "<Столбец>:<Строка>" (пример "12:100") и перемещает курсор в найденную ячейку, если это необходимо, если ячейка не найдена, функция возвращает пустую строку.
| |
Show | Реализована | Функция | Да
|
Table.Show(<Заголовок формы с таблицей (STRING)>,<Наименования файла по умолчанию при сохранении таблицы (STRING)>,<Выводить окно на передний план (INT)>=1) | Функция выводит таблицу на экран в виде самостоятельной формы, подчиненной текущей форме. Окно имеет требуемый заголовок, при сохранении таблицы в виде файла, по умолчанию используется имя файла, которое можно задать в аргументе этой функции. |
ShowOnParent | Реализована | Функция | Да
|
Table.ShowOnParent(<Заголовок формы с таблицей (STRING)>,<Наименования файла по умолчанию при сохранении таблицы (STRING)>,<Выводить окно на передний план (INT)>=1) | Функция выводит таблицу на экран в виде самостоятельной формы, подчиненной верхней родительской форме. Окно имеет требуемый заголовок, при сохранении таблицы в виде файла, по умолчанию используется имя файла, которое можно задать в аргументе этой функции. Если таблица формируется из потока, модуля или функции, не отображаемых на экране в виде формы, либо текущая форма вызывает другую, с тем, чтобы последняя вывела таблицу на экран и закрылась после вывода, эта функция может закрепить выведенную таблицу за верхней родительской формой, вместо текущей, это позволит избежать ситуации запрета исполнения родительской формы до тех пор, пока не будут закрыты все печатные формы, созданные подчиненной. См. также Форма. |
Hide | Планируется | Функция | Да
|
Table.Hide() | Функция позволяет закрыть открытую ранее форму таблицы и сделать таблицу невизуальной. |
HasWindow | Планируется | Функция | Да
|
Table.HasWindow():<Режим вывода таблицы на экран (INT)> | Функция возвращает 0, если таблица не выведена на экран, 1 -- если она выведена, как самостоятельная форма, 2 -- если она является частью элемента формы. |
NavigationState | Реализована | Функция | Да
|
Table.NavigationState(<Новое состояние навигации (STRING)>):<Текущее состояние навигации (STRING)> | Функция возвращает или/и изменяет состояние навигации в таблице. В это понятие включается: первая видимая верхняя левая ячейка, количество закрепленных строк и столбцов, положение курсора в таблице. Сохранение и восстановление состояния, к примеру, удобно использовать при обновлении отчета, чтобы после обновления вернуть курсор в ячейку, в которой он находился до обновления. |
ShowPreview | Реализована | Функция | Да
|
Table.ShowPreview() | Функция выводит стандартный диалог предварительного просмотра перед печатью. |
ShowPrintProperties | Реализована | Функция | Да
|
Table.ShowPrintProperties() | Функция выводит стандартный диалог установок печати таблицы. |
Реализована | Функция | Table.Print(<Показать стандартный диалог печати до ее осуществления (INT)>=0,<Наименование задания на принтере (STRING)>,<Режим диалога отмены печати (INT)>=0) | Функция производит печать на принтер, с выводом стандартного диалога печати, если это необходимо. После деления данных на страницы при печати, функция изменяет текст колонтитулов созданных страниц, подставляя вместо выражения #P номер соответствующей страницы, а вместо #Q общее количество страниц при печати.
| ||
CreatePageIndex | Реализована | Функция | Table.CreatePageIndex(<Максимальное время ожидания освобождения принтера (INT)>=5000):<Список размеров страниц (LIST)> | Функция создает или обновляет список страниц, которые будут выведены на печать, если текущие установки таблицы не изменятся. Внимание: функция может выполняться достаточно длительное время, из-за того, что установки печати записываются в свойства принтера перед подсчетом, кроме того, функция пересчитывает все параметры ячеек с изменяемыми размерами, поэтому, чем больше таблица по размеру, тем медленнее работает эта функция. Если принтер занят в данный момент печатью, функция также ожидает ее окончания, максимальное время этого ожидания задается в первом аргументе в миллисекундах. | |
Load | Реализована | Функция | Table.Load(<Наименование файла (STRING)>,<Формат (INT,STRING)>,<Индекс или наименование листа (INT,STRING)>):<Наименование загруженного листа (STRING)> | Функция производит загрузку текущей таблицы из файла в указанном формате, предыдущие данные, находившиеся в таблице, будут утеряны. | |
Save | Реализована | Функция | Table.Save(<Наименование файла (STRING)>,<Формат (INT,STRING)>) | Функция производит сохранение текущей таблицы в файл в указанном формате. | |
LoadFromBuffer | Реализована | Функция | Table.LoadFromBuffer(<Объект буфера (BUFFER)>,<Начальная позиция буфера (INT)>=0,<Размер таблицы в буфере (INT)>,<Формат (INT,STRING)>,<Индекс или наименование листа (INT,STRING)>):<Наименование загруженного листа (STRING)> | Функция производит загрузку текущей таблицы из буфера в указанном формате, предыдущие данные, находившиеся в таблице, будут утеряны. | |
SaveToBuffer | Реализована | Функция | Table.SaveToBuffer(<Объект буфера (BUFFER)>,<Начальная позиция буфера (INT)>=0,<Формат (INT,STRING)>=0,<Установки (INT)>=0):<Размер в байтах, добавленный в буфер (INT)> | Функция производит сохранение текущей таблицы в буфер в указанном формате с указанными установками. | |
SetSourceName | Реализована | Функция | Table.SetSourceName(<Наименование таблицы-шаблона (STRING)>) | Функция задает новое наименование (и путь, если необходимо) таблицы-шаблона из которого функции, типа CopyByX будут копировать информацию в текущую таблицу. Имя таблицы задается без расширения. Функция не проверяет существование таблицы с заданным именем, таблица будет загружена в момент, когда будет производиться копирование из нее. | |
GetSourceName | Реализована | Функция | Table.GetSourceName():<Наименование таблицы-шаблона (STRING)> | Функция получает текущее наименование таблицы-шаблона из которого функции, типа CopyByX будут копировать информацию в текущую таблицу. | |
SetSource | Реализована | Функция | Table.SetSource(<Таблица-шаблон (TABLE)>) | Функция задает таблицу-шаблон из которой функции, типа CopyByX будут копировать информацию в текущую таблицу. | |
Source | Реализована | Функция | Table.Source():<Таблица-шаблон (TABLE)> | Функция получает текущую таблицу-шаблон. Функция возвращает значение типа таблица SFT только в случае, когда таблица уже загружена (т.е., работа с ней уже велась). Если таблица не была загружена, функция возвращает пустое значение. | |
CopyTitles | Реализована | Функция | Table.CopyTitles() | Функция выполняет копирование колонтитулов из таблицы-шаблона в текущую таблицу. В момент копирования тексты колонтитулов, являющиеся шаблонами, будут превращены в результаты их вычисления. | |
CopyByX | Реализована | Функция | Table.CopyByX(<Указание на область таблицы-шаблона (STRING)>,<Перейти на новую строку до добавления области (INT)>=0,<Не производить изменения размеров столбцов или строк (INT)>=0) | Функция выполняет копирование указанной области ячеек и объектов, находящихся внутри этой области из таблицы-шаблона в текущую таблицу, начиная с ячейки, заданной атрибутами CurPutX и CurPutY. В момент копирования тексты и значения ячеек и объектов, являющиеся шаблонами, будут превращены в результаты их вычисления. Если третий аргумент равен 1, до начала копирования, функция переводит курсор копирования в левый столбик и производит сдвиг курсора по вертикали (размер сдвига по вертикали определяется высотой копируемой области). После окончания копирования функция переводит курсор копирования вправо на ширину области копирования. Если четвертый аргумент равен 1, функция не будет изменять размеры строк или столбцов в соответствии с размерами строк и столбцов копируемой области, однако, при копировании текста в ячейки, автоматически рассчитываемые размеры строк или столбцов по-прежнему будут изменены, если это необходимо. После копирования любого визуального объекта, функция вызывает событие OnFinishCopyObject, если оно существует в текущем или глобальном модуле. | |
CopyByY | Реализована | Функция | Table.CopyByY(<Указание на область таблицы-шаблона (STRING)>,<Перейти на новый столбец до добавления области (INT)>=0,<Не производить изменения размеров столбцов или строк (INT)>=0) | Функция выполняет копирование указанной области ячеек и объектов, находящихся внутри этой области из таблицы-шаблона в текущую таблицу, начиная с ячейки, заданной атрибутами CurPutX и CurPutY. В момент копирования тексты и значения ячеек и объектов, являющиеся шаблонами, будут превращены в результаты их вычисления. Если третий аргумент равен 1, до начала копирования, функция переводит курсор копирования на первую строку и производит сдвиг курсора по горизонтали (размер сдвига по горизонтали определяется шириной копируемой области). После окончания копирования функция переводит курсор копирования вниз на высоту области копирования. Если четвертый аргумент равен 1, функция не будет изменять размеры строк или столбцов в соответствии с размерами строк и столбцов копируемой области, однако, при копировании текста в ячейки, автоматически рассчитываемые размеры строк или столбцов по-прежнему будут изменены, если это необходимо. После копирования любого визуального объекта, функция вызывает событие OnFinishCopyObject, если оно существует в текущем или глобальном модуле. | |
RecalcColumnWidth | Планируется | Функция | Table.RecalcColumnWidth(<Столбец начала пересчета (INT)>,<Количество пересчитываемых столбцов (INT)>=1) | Функция пересчитывает ширину указанных столбцов, если их ширина рассчитывается автоматически. | |
RecalcLineHeight | Планируется | Функция | Table.RecalcLineHeight(<Строка начала пересчета (INT)>,<Количество пересчитываемых строк (INT)>=1) | Функция пересчитывает высоту указанных строк, если их высота рассчитывается автоматически. |
Атрибуты и функции вспомогательных объектов (Table.Options, Table.Printing и т.п.)
Данный раздел содержит функции, применяемые к подчиненным объектам, связанным с основным объектом таблицы. Данные группа объектов имеет тип Table.Options и включает следующие объекты:
- Объект визуального выделения ячеек таблицы
- Объект списка выделенных визуальных элементов (объектов) таблицы
- Объект работы с визуальными уровнями таблицы
- Объект общих настроек таблицы
- Объект работы с разбиениями таблицы на отдельные страницы при печати
- Объект настройки параметров печати, полей окружения страницы и колонтитулов
- Объект работы с со строками или столбцами таблицы, выводящимися на каждой странице
Идентификатор | Статус | Тип | Визуальная | Параметры | Описание |
---|---|---|---|---|---|
Selection | Реализована | Функция | Да
|
Table.Selection():<Объект выделения таблицы (TABLE.OPTIONS)> | Функция возвращает объект текущего выделения ячеек. С объектом можно вызывать функции, типа Add и пр. |
Count | Реализована | Функция | Да
|
Table.Selection.Count():<Количество областей визуального выделения (INT)> | Функция возвращает количество областей визуального выделения в таблице. Выделение не удаляется даже если пользователь выберет визуальный объект. При выделении объекта, выделение ячеек остается, но будет скрыто. Чтобы узнать, что выделено в данный момент, можно использовать атрибут SelectionMode. |
Add | Реализована | Функция | Да
|
Table.Selection.Add(<Левый столбец выделения (INT)>,<Верхняя строка выделения (INT)>,<Правый столбец выделения (INT)>,<Нижняя строка выделения (INT)>) | Функция добавляет к визуально выделенным областям еще одну заданную область. |
Delete | Реализована | Функция | Да
|
Table.Selection.Delete(<Индекс области выделения (INT)>) | Функция удаляет область визуального выделения с указанным индексом. Первая область выделения имеет индекс 1. |
Get | Реализована | Функция | Да
|
Table.Selection.Get(<Индекс области выделения (INT)>,<Тип границы выделения (INT)>):<Столбец или строка выделения (INT)> | Функция получает строку или столбец визуального выделения с указанным индексом. |
GetArea | Реализована | Функция | Да
|
Table.Selection.GetArea(<Индекс области выделения (INT)>,<Левый столбец выделения (INT)>,<Верхняя строка выделения (INT)>,<Правый столбец выделения (INT)>,<Нижняя строка выделения (INT)>) | Функция получает координаты визуального выделения с указанным индексом. |
Clear | Реализована | Функция | Да
|
Table.Selection.Clear() | Функция удаляет все области выделения; остается одна область, совпадающая с положением визуального курсора. |
SelectedObjects | Реализована | Функция | Да
|
Table.SelectedObjects():<Выделенные визуальные объекты таблицы (TABLE.OPTIONS)> | Функция возвращает объект выделенных визуальных объектов таблицы. С объектом можно вызывать функции, типа Get и пр. |
Count | Реализована | Функция | Да
|
Table.SelectedObjects.Count():<Количество выделенных визуальных объектов (INT)> | Функция возвращает количество выделенных визуальных объектов в таблице. Чтобы узнать, что выделено в данный момент, можно использовать атрибут SelectionMode. |
Add | Планируется | Функция | Да
|
Table.SelectedObjects.Add(<Индекс добавляемого к выделенным объекта (INT)>) | Функция добавляет к выделенным в данный момент объектам указанный по индексу объект. Если до момента вызова функции был активен режим выделения ячеек, после вызова функции активируется режим выделения визуальных объектов с единственным выбранным объектом. |
Delete | Планируется | Функция | Да
|
Table.SelectedObjects.Delete(<Индекс исключаемого из выделения объекта (INT)>) | Функция исключает из выделенных в данный момент объектов указанный по индексу объект. |
Get | Реализована | Функция | Да
|
Table.SelectedObjects.Get(<Индекс выделенного объекта (INT)>):<Визуальный объект (TABLE.OBJECT> | Функция получает визуальный объект таблицы по индексу в массиве выделенных в данный момент объектов |
Clear | Планируется | Функция | Да
|
Table.SelectedObjects.Clear() | Функция исключает все выделенные объекты из массива выделенных объектов и активирует режим выделения ячеек. |
Levels | Реализована | Функция | Да
|
Table.Levels(<Тип уровня (INT)>=0,<Индекс уровня (INT)>,<Индекс дочернего уровня (INT)>...):<Визуальные уровни таблицы (TABLE.OPTIONS)> | Функция возвращает объект визуальных уровней таблицы. Уровни используются для выделения групп столбцов или строк таблицы. Уровни можно закрывать или открыть. Если уровень закрыт, строки или столбцы, входящие в него (кроме основной строки/столбца) будут скрыты. Уровни могут быть вложенными друг в друга. С объектом можно вызывать функции, типа Open и пр. Функция содержит указание на конкретный уровень (если заданы индексы), после чего к нему можно добавить дочерние уровни, либо указание на корневой уровень (если индексы не заданы). |
Child | Реализована | Функция | Да
|
Table.Levels.Child(<Индекс уровня (INT)>):<Объект вложенного уровня по его индексу (TABLE.OPTIONS)> | Функция получает объект уровня, вложенного в текущий, по его индексу. Индексация начинается с единицы. |
Parent | Реализована | Функция | Да
|
Table.Levels.Parent():<Объект уровня, в который вложен данный (TABLE.OPTIONS)> | Функция получает уровень, в который вложен данный. Если функция вызывается с объектом верхнего уровня, она возвращает пустое значение. |
Index | Реализована | Функция | Да
|
Table.Levels.Index():<Индекс текущего уровня внутри родительского (INT)> | Функция получает индекс текущего уровня относительно родительского уровня. Индексация начинается с единицы. |
Add | Реализована | Функция | Да
|
Table.Levels.Add(<Направление уровня (INT)>,<Начальная позиция уровня (INT)>,<Конечная позиция уровня (INT)>) | Функция добавляет визуальный уровень к текущему, либо к одному из детей текущего уровня, если начальная и конечная позиции располагаются полностью внутри дочернего уровня. |
Delete | Реализована | Функция | Да
|
Table.Levels.Delete(<Начальная позиция (INT)>,<Конечная позиция (INT)>,<Рекурсивно удалить дочерние уровни (INT)>=1) | Функция удаляет указанные с помощью границ визуальные уровни, если необходимо, со всеми подчиненными уровнями. Если текущий объект указывает на существующий, а не корневой уровень, аргументы можно опустить и функция удалит текущей уровень со всеми его подчиненными подуровнями. |
Count | Реализована | Функция | Да
|
Table.Levels.Count():<Количество дочерних уровней (INT)> | Функция получает общее количество уровней, дочерних по отношению к данному. |
Beg | Реализована | Атрибут | Да
|
Table.Levels.Beg:<Начальная позиция текущего уровня (INT)> | Атрибут получает начальную позицию текущего уровня, функция не может применяться для корневого уровня (не имеющего видимый переключатель в таблице) |
End | Реализована | Атрибут | Да
|
Table.Levels.End:<Конечная позиция текущего уровня (INT)> | Атрибут получает конечную позицию текущего уровня, функция не может применяться для корневого уровня (не имеющего видимый переключатель в таблице) |
IsClosed | Реализована | Атрибут | Да
|
Table.Levels.IsClosed:<Текущий уровень закрыт (INT)> | Атрибут получает статус, открыт ли текущий уровень, функция не может применяться для корневого уровня (не имеющего видимый переключатель в таблице) |
Open | Реализована | Функция | Да
|
Table.Levels.Open() | Функция открывает текущий уровень. При применении функции к верхнему уровню, она открывает все уровни таблицы. |
Close | Реализована | Функция | Да
|
Table.Levels.Close() | Функция закрывает текущий уровень. При применении функции к верхнему уровню, она закрывает все уровни таблицы. |
Options | Реализована | Функция | Table.Options:<Объект установок таблицы (TABLE.OPTIONS)> | Функция возвращает объект установок таблицы. С объектом можно вызывать функции, типа FixedLine и пр. | |
ShowGrid | Реализована | Атрибут | Да
|
Table.Options.ShowGrid:<Показывать сетку редактирования (INT)> | Атрибут возвращает или изменяет режим отображения сетки редактирования в таблице. |
ShowCaptions | Реализована | Атрибут | Да
|
Table.Options.ShowCaptions:<Показывать заголовки строк и столбцов (INT)> | Атрибут возвращает или изменяет режим отображения заголовков строк и столбцов в таблице. |
FixedLine | Реализована | Атрибут | Да
|
Table.Options.FixedLine:<Закрепить на экране указанное количество строк (INT)> | Атрибут возвращает или изменяет количество строк, закрепленных на экране. При сдвиге отображаемого поля таблицы закрепленные строки останутся видимыми. По умолчанию этот атрибут равен 0 (нет закрепленных строк). |
FixedColumn | Реализована | Атрибут | Да
|
Table.Options.FixedColumn:<Закрепить на экране указанное количество столбцов (INT)> | Атрибут возвращает или изменяет количество столбцов, закрепленных на экране. При сдвиге отображаемого поля таблицы закрепленные столбцы останутся видимыми. По умолчанию этот атрибут равен 0 (нет закрепленных столбцов). |
GroupsVisible | Реализована | Атрибут | Да
|
Table.Options.GroupsVisible:<Видимость группировок таблиц-шаблонов (INT)> | Атрибут возвращает или изменяет режим отображения наименований группировок, используемых в таблицах-шаблонах для получения областей таблиц по наименованиям. |
LevelsVisible | Реализована | Атрибут | Да
|
Table.Options.LevelsVisible:<Видимость уровней группировок (INT)> | Атрибут возвращает или изменяет режим отображения уровней группировок таблицы. Уровни используются для группировки строк или столбцов, каждый уровень может быть закрыт (тогда его столбцы или строки не будут отображаться на экране), либо открыт. Уровни могут быть вложенными. |
Scrollable | Реализована | Атрибут | Да
|
Table.Options.Scrollable:<Разрешить сдвиг отображаемой части таблицы (INT)> | Атрибут возвращает или изменяет режим разрешения сдвига отображаемой части таблицы. При запрете сдвига на экране будет отображаться только верхняя левая часть таблицы, сдвинуть ее вверх или влево будет невозможно. |
IsChanged | Реализована | Атрибут | Да
|
Table.Options.IsChanged:<Производились ли изменения в таблице (INT)> | Атрибут возвращает или изменяет признак того, были ли произведены визуальные изменения в таблице с момента ее предыдущего сохранения. Для таблицы, выведенных на экран, признак виден в заголовке таблицы. |
PageBreaks | Реализована | Функция | Table.PageBreaks:<Объект разбиения на страницы (TABLE.OPTIONS)> | Функция возвращает объект разбиения таблицы на страницы. Таблицу можно разбить на страницы в нужных строках и нужных столбцах, разбитые области будут выводиться отдельными страницами при печати, даже если активна установка печати "помещать на одной странице". С объектом можно вызывать функции, типа Add и пр. | |
Add | Реализована | Функция | Table.PageBreaks.Add(<Строка разбиения (INT)>) | Функция позволяет добавить новое разбиение страницы по горизонтали. | |
AddVertical | Реализована | Функция | Table.PageBreaks.AddVertical(<Столбец разбиения (INT)>) | Функция позволяет добавить новое разбиение страницы по вертикали. | |
Count | Реализована | Атрибут | Table.PageBreaks.Count(<Вертикальные разбиения (INT)>=1):<Количество разбиений на страницы (INT)> | Атрибут отдает количество (горизонтальных или вертикальных) разбиений на страницы в данной таблице. | |
Delete | Планируется | Функция | Table.PageBreaks.Delete(<Индекс разбиения (INT)>) | Функция удаляет разбиение с указанным индексом. | |
GetPosition | Реализована | Функция | Table.PageBreaks.GetPosition(<Индекс разбиения (INT)>,<Вертикальные разбиения (INT)>=1):<Позиция разбиения (INT)> | Функция получает столбец (если разбиение горизонтальное) или строку разбиения (если разбиение вертикальное) по индексу разбиения. | |
Printing | Реализована | Функция | Table.Printing:<Объект установок печати (TABLE.OPTIONS)> | Функция возвращает объект установок печати таблицы. С объектом можно вызывать функции, типа Printer и пр. | |
Orientation | Реализована | Атрибут | Table.Printing.Orientation:<Ориентация листа при печати (INT)> | Атрибут получает или устанавливает ориентацию листа при печати (0 -- в виде портрета, 1 -- в виде ландшафта). | |
ScaleMode | Реализована | Атрибут | Table.Printing.ScaleMode:<Режим масштабирования при печати (INT)> | Атрибут получает или устанавливает режим масштабирования страниц при печати. Возможные значения: 0 -- сжимать таблицу до ширины листа, 1 -- сжимать или увеличивать таблицу до ширины листа, 2 -- использовать заданный масштаб при печати страницы (см. Scale), 3 -- сжимать или увеличивать таблицу, чтобы она умещалась на одном листе. Важно понимать, что в таблицах, где использовано разбиение на страницы (см. PageBreaks), сжатие и расширение (в т.ч. размещение на одном листе) происходит для каждой страницы, полученной в результате разбиения. | |
Scale | Реализована | Атрибут | Table.Printing.Scale:<Масштаб в режиме печати с заданным масштабом (REAL)> | Атрибут получает или устанавливает масштаб печати в режиме печати с заданным масштабом. Масштаб устанавливается в процентах и может быть вещественным числом. По умолчанию этот атрибут равен 100. | |
Printer | Реализована | Атрибут | Table.Printing.Printer:<Наименование текущего принтера (STRING)> | Атрибут получает или устанавливает наименование текущего принтера для печати таблицы. Если этому атрибуту присваивается пустая строка, будет использован принтер по умолчанию.. | |
Copies | Реализована | Атрибут | Table.Printing.Copies:<Количество копий при печати (INT)> | Атрибут получает или устанавливает количество копий при печати таблицы. По умолчанию, этот атрибут равен единице. | |
PageOptions | Реализована | Атрибут | Table.Printing.PageOptions:<Дополнительные установки печати (INT)> | Атрибут получает или устанавливает дополнительные установки страницы. Атрибут имеет тип битовой маски, возможные значения перечислены в статье Константы. | |
Fields | Реализована | Функция | Table.Printing.Fields:<Объект установок полей таблицы при печати (TABLE.OPTIONS)> | Функция возвращает объект установок полей таблицы при печати. С объектом можно вызывать функции, типа Left и пр. | |
Left | Реализована | Атрибут | Table.Printing.Fields.Left:<Ширина левого поля в мм. (INT)> | Атрибут получает или устанавливает ширину пустого левого поля при печати страницы. По умолчанию ширина поля равна 10 мм. | |
Right | Реализована | Атрибут | Table.Printing.Fields.Right:<Ширина правого поля в мм. (INT)> | Атрибут получает или устанавливает ширину пустого правого поля при печати страницы. По умолчанию ширина поля равна 10 мм. | |
Up | Реализована | Атрибут | Table.Printing.Fields.Up:<Ширина верхнего поля в мм. (INT)> | Атрибут получает или устанавливает ширину пустого верхнего поля при печати страницы. По умолчанию ширина поля равна 10 мм. Поле следует до начала верхнего колонтитула и не включается в ширину колонтитула. | |
Down | Реализована | Атрибут | Table.Printing.Fields.Down:<Ширина нижнего поля в мм. (INT)> | Атрибут получает или устанавливает ширину пустого нижнего поля при печати страницы. По умолчанию ширина поля равна 10 мм. Поле следует после нижнего колонтитула и не включается в ширину колонтитула. | |
Titles | Реализована | Функция | Table.Printing.Titles:<Объект установок колонтитулов таблицы при печати (TABLE.OPTIONS)> | Функция возвращает объект установок колонтитулов таблицы при печати. С объектом можно вызывать функции, типа Up и пр. | |
Up | Реализована | Функция | Table.Printing.Titles.Up:<Объект установок верхнего колонтитула таблицы при печати (TABLE.OPTIONS)> | Функция возвращает объект установок верхнего колонтитула таблицы при печати. С объектом можно вызывать функции, типа Text и пр. | |
Down | Реализована | Функция | Table.Printing.Titles.Down:<Объект установок нижнего колонтитула таблицы при печати (TABLE.OPTIONS)> | Функция возвращает объект установок нижнего колонтитула таблицы при печати. С объектом можно вызывать функции, типа Text и пр. | |
Size | Реализована | Атрибут | Table.Printing.Titles.<Тип колонтитула>.Size:<Ширина выбранного колонтитула в мм. (INT)> | Атрибут получает или устанавливает ширину выбранного колонтитула при печати таблицы. По умолчанию ширина колонтитула равна 7 мм. | |
Text | Реализована | Атрибут | Table.Printing.Titles.<Тип колонтитула>.Text:<Текст или шаблон колонтитула (STRING)> | Атрибут получает или устанавливает текст или шаблон выбранного колонтитула при печати таблицы. | |
TextOptions | Реализована | Атрибут | Table.Printing.Titles.<Тип колонтитула>.TextOptions:<Установки форматирования колонтитула (INT)> | Атрибут получает или устанавливает установки форматирования выбранного колонтитула при печати таблицы. Значение является битовой маской и использует сл. биты: биты 0..1: режим выравнивания по горизонтали, биты 2..3: режим выравнивания по вертикали. | |
Orientation | Реализована | Атрибут | Table.Printing.Titles.<Тип колонтитула>.Orientation:<Угол направления текста (REAL)> | Атрибут возвращает или изменяет угол направления прорисовки текста выбранного колонтитула при печати таблицы. По умолчанию это значение равно 0 (горизонтальный текст). | |
TitleOptions | Реализована | Атрибут | Table.Printing.Titles.<Тип колонтитула>.TitleOptions:<Дополнительные установки колонтитула (INT)> | Атрибут получает или устанавливает дополнительные установки выбранного колонтитула при печати таблицы. Значение является битовой маской и использует сл. биты: бит 0: режим шаблона для текста активен, бит 2: при переносе текста принимать во внимание границы слов. | |
PrintFromPage | Реализована | Атрибут | Table.Printing.Titles.<Тип колонтитула>.PrintFromPage:<Начинать печатать колонтитул с указанной страницы (INT)> | Атрибут получает или устанавливает номер страницы, с которой будет начитать печататься колонтитул. По умолчанию, этот атрибут равен единице. | |
ColorProfile | Реализована | Атрибут | Table.Printing.Titles.<Тип колонтитула>.ColorProfile:<Шаблон цвета колонтитула (INT)> | Атрибут возвращает или изменяет номер шаблона цвета выбранного колонтитула таблицы. По умолчанию это значение равно 0 (цвета и стиль форматирования определяется соответствующими атрибутами колонтитула, а не номером шаблона). Номера шаблонов можно найти в этой статье. | |
BackgroundColor | Реализована | Атрибут | Table.Printing.Titles.<Тип колонтитула>.BackgroundColor:<Номер цвета фона колонтитула (INT)> | Атрибут возвращает или изменяет номер цвета фона выбранного колонтитула таблицы. Система получает цвет по номеру из палитры, для прямого указания цвета используйте атрибут BackgroundColorRGB. | |
BackgroundColorRGB | Реализована | Атрибут | Table.Printing.Titles.<Тип колонтитула>.BackgroundColorRGB:<Цвет фона колонтитула (INT)> | Атрибут возвращает или изменяет цвет фона выбранного колонтитула таблицы по его 24-битному значению. | |
FontColor | Реализована | Атрибут | Table.Printing.Titles.<Тип колонтитула>.FontColor:<Номер цвета текста колонтитула (INT)> | Атрибут возвращает или изменяет номер цвета текста выбранного колонтитула таблицы. Система получает цвет по номеру из палитры, для прямого указания цвета используйте атрибут FontColorRGB. | |
FontColorRGB | Реализована | Атрибут | Table.Printing.Titles.<Тип колонтитула>.FontColorRGB:<Цвет текста колонтитула (INT)> | Атрибут возвращает или изменяет цвет текста выбранного колонтитула таблицы по его 24-битному значению. | |
FontStyle | Реализована | Атрибут | Table.Printing.Titles.<Тип колонтитула>.FontStyle:<Стиль текста колонтитула (INT)> | Атрибут возвращает или изменяет стиль текста выбранного колонтитула таблицы. | |
FontSize | Реализована | Атрибут | Table.Printing.Titles.<Тип колонтитула>.FontSize:<Размер шрифта колонтитула (INT)> | Атрибут возвращает или изменяет размер шрифта текста выбранного колонтитула таблицы. | |
Font | Реализована | Атрибут | Table.Printing.Titles.<Тип колонтитула>.Font:<Наименование шрифта текста колонтитула (STRING)> | Атрибут возвращает или изменяет наименование шрифта текста выбранного колонтитула таблицы. | |
ContinualLines | Реализована | Функция | Table.Printing.ContinualLines:<Объект установок строк таблицы, печатающихся на каждой странице (TABLE.OPTIONS)> | Функция возвращает объект установок строк таблицы, выводящихся на печать на каждой странице. К примеру, для таблиц данных, которые занимают несколько страниц при печати, удобно печатать заголовок на каждой новой страницы до момента, когда таблица закончится. С объектом можно вызывать функции, типа From и пр. | |
ContinualColumns | Реализована | Функция | Table.Printing.ContinualColumns:<Объект установок столбцов таблицы, печатающихся на каждой странице (TABLE.OPTIONS)> | Функция возвращает объект установок столбцов таблицы, выводящихся на печать на каждой странице. С объектом можно вызывать функции, типа From и пр. | |
From | Реализована | Атрибут | Table.Printing.<Тип объекта>.From:<Строка или столбец начала области (INT)> | Атрибут возвращает или устанавливает строку или столбец, с которой начинается область, печатающаяся на каждой странице. | |
To | Реализована | Атрибут | Table.Printing.<Тип объекта>.To:<Строка или столбец окончания области (INT)> | Атрибут возвращает или устанавливает строку или столбец, на которой заканчивается область, печатающаяся на каждой странице. Копия области будет выведена на следующей по горизонтали или вертикали странице (в зависимости от типа объекта). | |
EndCell | Реализована | Атрибут | Table.Printing.<Тип объекта>.EndCell:<Строка или столбец, после которого, заданная область, печатавшаяся на каждой странице, больше не выводится (INT)> | Атрибут возвращает или устанавливает строку или столбец, после вывода на печать которых, заданная область, печатавшаяся на каждой странице, больше не выводится. |
Атрибуты и функции объекта области таблицы (Table.Area)
Данный раздел содержит функции, применяемые к объекту области таблицы. Объект области позволяет получить или изменять параметры ячеек, входящих в нее. При создании объекта, не производится копирования области в памяти, а создается только ссылка на нее.
Идентификатор | Статус | Тип | Визуальная | Параметры | Описание |
---|---|---|---|---|---|
Area | Реализована | Функция | Table.Area(<Левый столбец области (INT)>,<Верхняя строка области (INT)>,<Правый столбец области (INT)>,<Нижняя строка области (INT)>):<Объект области таблицы (TABLE.AREA)> | Функция возвращает объект области таблицы. С объектом можно вызывать функции, типа Text и пр. | |
Text | Реализована | Атрибут | Table.Area.Text:<Текст ячеек области (STRING)> | Атрибут возвращает или изменяет текст ячеек области таблицы. Текст получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
Value, Formula | Реализована | Атрибут | Table.Area.Value:<Значение ячеек таблицы> | Атрибут возвращает или изменяет значение, ассоциированное с ячейками области таблицы. Значение получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
ValueTemplate | Планируется | Атрибут | Table.Area.ValueTemplate:<Формула шаблона ячейки (STRING)> | Атрибут возвращает или изменяет текст формулы шаблона, ассоциированной с ячейками области таблицы. Значение получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. Формула шаблона использует тоже самое место хранения, что и значение ячейки. Для ячейки может быть задана либо формула, либо значение. | |
WrappingMode | Реализована | Атрибут | Table.Area.WrappingMode:<Режим переноса текста (INT)> | Атрибут возвращает или изменяет значение режима переноса текста ячеек области таблицы. Значение получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. Значение 0 задает режим переноса с соблюдением границы слов, 1 -- без соблюдения. | |
IsTemplate | Реализована | Атрибут | Table.Area.IsTemplate:<Является ли текст формулой шаблона (INT)> | Атрибут возвращает или изменяет признак того, является ли текст ячеек области таблицы шаблоном (шаблон выполняется при копировании области в другую таблицу). Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
IsValueTemplate | Реализована | Атрибут | Table.Area.IsValueTemplate:<Является ли значение формулой шаблона (INT)> | Атрибут возвращает или изменяет признак того, является ли значения ячеек области таблицы шаблоном (шаблон выполняется при копировании области в другую таблицу). Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
HAlign | Реализована | Атрибут | Table.Area.HAlign:<Выравнивание по горизонтали (INT)> | Атрибут возвращает или изменяет режим выравнивания текста ячеек области таблицы по горизонтали. Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
VAlign | Реализована | Атрибут | Table.Area.VAlign:<Выравнивание по вертикали (INT)> | Атрибут возвращает или изменяет режим выравнивания текста ячеек области таблицы по вертикали. Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
ClipMode | Реализована | Атрибут | Table.Area.ClipMode:<Контроль границы ячейки (INT)> | Атрибут возвращает или изменяет режим контроля выхода за границу ячейки текста ячеек области таблицы. Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
RedNegative | Реализована | Атрибут | Table.Area.RedNegative:<Отрицательные красным (INT)> | Атрибут возвращает или изменяет режим выделения красным текста ячеек области таблицы, когда они содержат отрицательные числа. Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
Protected | Реализована | Атрибут | Table.Area.Protected:<Защита от изменения в режиме просмотра (INT)> | Атрибут возвращает или изменяет режим защиты ячеек области таблицы от изменения в режиме просмотра (игнорируется в режиме редактирования и запрета изменений). По умолчанию признак защиты установлен. Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
Orientation | Реализована | Атрибут | Table.Area.Orientation:<Угол направления текста (REAL)> | Атрибут возвращает или изменяет угол направления прорисовки текста ячеек области таблицы. По умолчанию это значение равно 0 (горизонтальный текст). Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
ParentCell | Реализована | Атрибут | Table.Area.ParentCell:<Тип объединения ячейки (INT)> | Атрибут возвращает тип объединения, связанный с крайней левой верхней ячейкой области таблицы. Получаемый атрибут может принимать следующие значения: 0 -- ячейка не участвует в объединении ячеек, 1 -- это крайняя левая ячейка области объединения (основная ячейка, из свойств которой используются цвета, шрифт, текст и пр. для всей области), 2 -- эта ячейка участвует в объединении, как подчиненная ячейка. | |
ExtentX | Реализована | Атрибут | Table.Area.ExtentX:<Ссылка по горизонтали на основную ячейку объединения (INT)> | Для крайней левой верхней ячейкой области атрибут возвращает расстояние в ячейках по горизонтали от текущей ячейки до основной ячейки объединения (отрицательное число); количество ячеек в области объединения по горизонтали, если это основная ячейка (см. ParentCell); либо 0, если ячейка не участвует в объединении ячеек. | |
ExtentY | Реализована | Атрибут | Table.Area.ExtentY:<Ссылка по вертикали на основную ячейку объединения (INT)> | Для крайней левой верхней ячейкой области атрибут возвращает расстояние в ячейках по вертикали от текущей ячейки до основной ячейки объединения (отрицательное число); количество ячеек в области объединения по вертикали, если это основная ячейка (см. ParentCell); либо 0, если ячейка не участвует в объединении ячеек. | |
IndentX, Indent | Реализована | Атрибут | Table.Area.IndentX:<Отступ текста по горизонтали (INT)> | Атрибут возвращает или изменяет отступ текста по горизонтали от границы ячеек области таблицы. По умолчанию это значение равно 0 (отступ отсутствует). Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
IndentY | Реализована | Атрибут | Table.Area.IndentY:<Отступ текста по вертикали (INT)> | Атрибут возвращает или изменяет отступ текста по вертикали от границы ячеек области таблицы. По умолчанию это значение равно 0 (отступ отсутствует). Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
ColorProfile | Реализована | Атрибут | Table.Area.ColorProfile:<Шаблон цвета ячейки (INT)> | Атрибут возвращает или изменяет номер шаблона цвета ячеек области таблицы. По умолчанию это значение равно 0 (цвета и стиль форматирования определяется соответствующими атрибутами ячейки, а не номером шаблона). Номера шаблонов можно найти в этой статье. Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
BackgroundColor | Реализована | Атрибут | Table.Area.BackgroundColor:<Номер цвета фона ячейки (INT)> | Атрибут возвращает или изменяет номер цвета фона ячеек области таблицы. Система получает цвет по номеру из палитры, для прямого указания цвета используйте атрибут BackgroundColorRGB. Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
BackgroundColorRGB | Реализована | Атрибут | Table.Area.BackgroundColorRGB:<Цвет фона ячейки (INT)> | Атрибут возвращает или изменяет цвет фона ячеек области таблицы по его RGB значению. Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
FontColor | Реализована | Атрибут | Table.Area.FontColor:<Номер цвета текста ячейки (INT)> | Атрибут возвращает или изменяет номер цвета текста ячеек области таблицы. Система получает цвет по номеру из палитры, для прямого указания цвета используйте атрибут FontColorRGB. Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
FontColorRGB | Реализована | Атрибут | Table.Area.FontColorRGB:<Цвет текста ячейки (INT)> | Атрибут возвращает или изменяет цвет текста ячеек области таблицы по его RGB значению. Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
FrameColor | Реализована | Атрибут | Table.Area.FrameColor:<Номер цвета границы ячейки (INT)> | Атрибут возвращает или изменяет номер цвета границы ячеек области таблицы. Система получает цвет по номеру из палитры, для прямого указания цвета используйте атрибут FrameColorRGB. Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
FrameColorRGB | Реализована | Атрибут | Table.Area.FrameColorRGB:<Цвет границы ячейки (INT)> | Атрибут возвращает или изменяет цвет границы ячеек области таблицы по его RGB значению. Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
FontStyle | Реализована | Атрибут | Table.Area.FontStyle:<Стиль текста ячейки (INT)> | Атрибут возвращает или изменяет стиль текста ячеек области таблицы. Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
FontSize | Реализована | Атрибут | Table.Area.FontSize:<Размер шрифта текста ячейки (INT)> | Атрибут возвращает или изменяет размер шрифта текста ячеек области таблицы. Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
Font | Реализована | Атрибут | Table.Area.Font:<Наименование шрифта текста ячейки (STRING)> | Атрибут возвращает или изменяет наименование шрифта текста ячеек области таблицы. Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
Frame | Реализована | Атрибут | Table.Area.Frame:<Рисунок и наличие 4-х границ вокруг ячейки (INT)> | Атрибут возвращает или изменяет рисунок и наличие четырех границ вокруг каждой ячейки из области таблицы. Значение представляет собой битовую маску, где на каждую из границ используется по 4 бита. По умолчанию, это значение равно 0 (ячейка не окружена границами). Значение признака получается для крайней левой верхней ячейки области, и устанавливается для всех ячеек таблицы. | |
RowAutoSize | Реализована | Атрибут | Table.Area.RowAutoSize:<Признак автоматического изменения высоты строки (INT)> | Атрибут возвращает или изменяет признак автоматического изменения высоты строк ячеек области таблицы. Значение признака получается для строки верхних ячеек области, и устанавливается для всех строк области таблицы. | |
ColAutoSize | Реализована | Атрибут | Table.Area.ColAutoSize:<Признак автоматического изменения ширины столбца (INT)> | Атрибут возвращает или изменяет признак автоматического изменения ширины столбцов ячеек области таблицы. Значение признака получается для столбца левых ячеек области, и устанавливается для всех столбцов области таблицы. | |
RowHeight | Реализована | Атрибут | Table.Area.RowHeight:<Высота строки в пикселях (INT)> | Атрибут возвращает или изменяет высоту строк ячеек области таблицы. Значение признака получается для строки верхних ячеек области, и устанавливается для всех строк области таблицы. При установке этого атрибута, атрибут RowAutoSize автоматически принимает нулевое значение. | |
ColWidth | Реализована | Атрибут | Table.Area.ColWidth:<Ширина столбца в пикселях (INT)> | Атрибут возвращает или изменяет ширину столбцов ячеек области таблицы. Значение признака получается для столбца левых ячеек области, и устанавливается для всех столбцов области таблицы. При установке этого атрибута, атрибут ColAutoSize автоматически принимает нулевое значение. | |
ContinuousRegionX | Реализована | Атрибут | Table.Area.ContinuousRegionX:<Признак неразрывности горизонтального региона (INT)> | Атрибут возвращает или изменяет признак неразрывности при печати горизонтального региона ячеек области таблицы. При установке признака можно использовать значения 0 (регион теряет все свойства неразрывности) или 1 (регион становится неразрывным). При чтении, возможны следующие значения: 0 -- в регионе отсутствуют неразрывные диапазоны, 1 -- весь регион представляет собой неразрывный диапазон, 2 -- регион содержит определенное количество неразрывных диапазонов или их частей. | |
ContinuousRegionY | Реализована | Атрибут | Table.Area.ContinuousRegionY:<Признак неразрывности вертикального региона (INT)> | Атрибут возвращает или изменяет признак неразрывности при печати вертикального региона ячеек области таблицы. При установке признака можно использовать значения 0 (регион теряет все свойства неразрывности) или 1 (регион становится неразрывным). При чтении, возможны следующие значения: 0 -- в регионе отсутствуют неразрывные диапазоны, 1 -- весь регион представляет собой неразрывный диапазон, 2 -- регион содержит определенное количество неразрывных диапазонов или их частей. | |
Merge | Реализована | Функция | Table.Area.Merge() | Функция объединяет ячейки области таблицы в один регион объединения. Если с областью граничили или находились внутри области другие регионы объединения, они будут разъединены до выполнения объединения текущей области. | |
Demerge | Реализована | Функция | Table.Area.Demerge() | Функция разъединяет ячейки области таблицы, это относится ко всем регионам объединения входящим в или граничащим с текущей областью таблицы. | |
CopyTo | Планируется | Функция | Table.Area.CopyTo(<Таблица в которую происходит копирование (TABLE)>,<Столбец таблицы для вставки (INT)>,<Строка таблицы для вставки (INT)>,<Копировать также объекты (INT)>=1,<Превращать шаблоны в их значения (INT)>=0) | Функция копирует текущую область в указанную таблицу по начиная с указанной ячейки, таблица результат может также быть текущей таблицей. | |
Copy | Реализована | Функция | Table.Area.Copy(<Копировать также объекты (INT)>=1):<Копия области в виде новой таблицы (TABLE)> | Функция создает новую таблицу и заполняет ее ячейками текущей области. Область копируется в таблицу начиная с первой верхней левой ячейки. | |
Execute | Планируется | Функция | Table.Area.Execute(<Также находить значения шаблонов для объектов (INT)>=1) | Функция превращает все тексты шаблонов ячеек (и объектов) области в их значения. | |
Modify | Реализована | Функция | Table.Area.Modify(<Левый столбец (INT)>,<Верхняя строка (INT)>,<Правый столбец (INT)>,<Нижняя строка (INT)>) | Функция изменяет размеры и положение текущей области в соответствующей ей таблице. Т.е., действие функции соответствует вызову Area, только на существующем объекте, который после исполнения функции будет указывать на другую область. | |
Clear | Планируется | Функция | Table.Area.Clear() | Функция разъединяет все объединенные ячейки области, очищает весь текст и значения ячеек, стили, границы, цвета и пр. устанавливает в состояние по умолчанию. |
Атрибуты и функции визуальных объектов таблицы (Table.Object)
Данный раздел содержит функции, применяемые к совокупности или к одному визуальному элементу (объекту) таблицы. Объект позволяет получить или изменять параметры элементов, которые он адресует. Визуальным элементом (объектом), к примеру, может быть рисунок, или текст, добавленные в произвольное место таблицы и имеющие произвольный размер. Такие элементы выводятся на печать и их содержимое закрывает текст ячеек, находящихся непосредственно под ними.
Идентификатор | Статус | Тип | Визуальная | Параметры | Описание |
---|---|---|---|---|---|
Objects | Реализована | Функция | Table.Objects(<Индекс или наименование определенного объекта (INT,STRING)>):<Визуальный объект таблицы или все визуальные объекты (TABLE.OBJECT)> | Функция возвращает объект доступа к визуальным объектам таблицы. При указании на определенный визуальный объект, текущим объектом можно пользоваться для изменения его свойств, иначе текущий объект будет указывать на всю совокупность объектов таблицы. | |
Count | Реализована | Атрибут | Table.Object.Count:<Общее количество объектов таблицы (INT)> | Атрибут возвращает общее количество объектов в таблице. | |
Type | Реализована | Атрибут | Table.Object.Type:<Тип текущего объекта (INT)> | Атрибут возвращает цифровой тип текущего объекта таблицы. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
Name | Реализована | Атрибут | Table.Object.Name:<Наименование текущего объекта (STRING)> | Атрибут возвращает или изменяет наименование текущего объекта таблицы. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
Text | Реализована | Атрибут | Table.Object.Text:<Текст текущего объекта (INT)> | Атрибут возвращает или изменяет текст, ассоциированный с текущим объектом таблицы. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
ValueTemplate | Планируется | Атрибут | Table.Object.ValueTemplate:<Формула шаблона объекта (STRING)> | Атрибут возвращает или изменяет текст формулы шаблона, ассоциированной с текущим объектом таблицы. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. Формула шаблона использует тоже самое место хранения, что и значение объекта. Для объекта может быть задана либо формула, либо значение. | |
Value, Formula | Реализована | Атрибут | Table.Object.Value:<Значение объекта> | Атрибут возвращает или изменяет произвольное значение, ассоциированной с текущим объектом таблицы. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
WrappingMode | Реализована | Атрибут | Table.Object.WrappingMode:<Режим переноса текста (INT)> | Атрибут возвращает или изменяет значение режима переноса текста текущего объекта таблицы. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
IsTemplate | Реализована | Атрибут | Table.Object.IsTemplate:<Является ли текст формулой шаблона (INT)> | Атрибут возвращает или изменяет признак того, является ли текст визуального объекта таблицы шаблоном (шаблон выполняется при копировании области в другую таблицу). Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
IsValueTemplate | Реализована | Атрибут | Table.Object.IsValueTemplate:<Является ли значение формулой шаблона (INT)> | Атрибут возвращает или изменяет признак того, является ли значение визуального объекта таблицы шаблоном (шаблон выполняется при копировании области в другую таблицу). Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
HAlign | Реализована | Атрибут | Table.Object.HAlign:<Выравнивание по горизонтали (INT)> | Атрибут возвращает или изменяет режим выравнивания текста визуального объекта таблицы по горизонтали. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
VAlign | Реализована | Атрибут | Table.Object.VAlign:<Выравнивание по вертикали (INT)> | Атрибут возвращает или изменяет режим выравнивания текста визуального объекта таблицы по вертикали. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
ClipMode | Реализована | Атрибут | Table.Object.ClipMode:<Контроль границы для текста объекта (INT)> | Атрибут возвращает или изменяет режим контроля выхода за границу текста визуального объекта таблицы. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
RedNegative | Реализована | Атрибут | Table.Object.RedNegative:<Отрицательные красным (INT)> | Атрибут возвращает или изменяет режим выделения красным текста визуального объекта таблицы, когда он содержит отрицательное число. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
Protected | Реализована | Атрибут | Table.Object.Protected:<Защита от изменения в режиме просмотра (INT)> | Атрибут возвращает или изменяет режим защиты визуального объекта от изменения в режиме просмотра (игнорируется в режиме редактирования и запрета изменений). По умолчанию признак защиты установлен. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
Orientation | Реализована | Атрибут | Table.Object.Orientation:<Угол направления текста объекта (REAL)> | Атрибут возвращает или изменяет угол направления прорисовки текста визуального объекта таблицы. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
IsAnchoredPosition | Реализована | Атрибут | Table.Object.IsAnchoredPosition:<Изменяется ли положение объекта при изменении размеров ячеек (INT)> | Атрибут возвращает или изменяет признак того, изменяется ли положение объекта при изменении размеров ячеек. | |
IsAnchoredSize | Реализована | Атрибут | Table.Object.IsAnchoredSize:<Изменяются ли ширина и высота объекта при изменении размеров ячеек (INT)> | Атрибут возвращает или изменяет признак того, изменяются ли ширина и высота объекта при изменении размеров ячеек. | |
AbsoluteCoordinates | Реализована | Атрибут | Table.Object.AbsoluteCoordinates:<Абсолютные координаты объекта (STRING)> | Атрибут возвращает или изменяет координаты объекта, заданные в абсолютной величине (в точках) от начала таблицы. Возвращаемое значение представляет собой следующий строку: <Координата левой границы>,<Координата верхней границы>,<Координата правой границы>,<Координата нижней границы> . При установке атрибута, третью и четвертую координаты можно пропустить, в этом случае, ширина и высота объекта изменяться не будет.
| |
RelativeCoordinates | Реализована | Атрибут | Table.Object.RelativeCoordinates:<Относительные координаты объекта (STRING)> | Атрибут возвращает или изменяет координаты объекта, заданные в относительных величинах (смещениях ячеек). Возвращаемое значение представляет собой следующий строку: <Столбец левой верхней точки объекта>:<Смещение в столбце>,<Строка левой верхней точки объекта>:<Смещение в строке>,<Столбец правой нижней точки объекта>:<Смещение в столбце>,<Строка правой нижней точки объекта>:<Смещение в строке> . Смещения задаются как цифровой индекс от 0 до 65535. 0 означает левый край столбца или верхний край строки, 65535 означает самая правая крайняя точка столбца или самая крайняя нижняя точка строки. Все, что между этими числами пропорционально лежит внутри крайних точек. При установке атрибута, правые и нижние координаты можно пропустить, в этом случае, ширина и высота объекта изменяться не будет.
| |
Width | Реализована | Атрибут | Table.Object.Width:<Ширина объекта в пикселях (INT)> | Атрибут возвращает или изменяет ширину объекта в пикселях. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
Height | Реализована | Атрибут | Table.Object.Height:<Высота объекта в пикселях (INT)> | Атрибут возвращает или изменяет высоту объекта в пикселях. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
ScaleOption | Реализована | Атрибут | Table.Object.ScaleOption:<Способ масштабирования объекта (INT)> | Атрибут возвращает или изменяет способ масштабирования объекта. Доступны следующие значения: 0 -- оригинальный размер, 1 -- уменьшать размер, если это необходимо, 2 -- уменьшать или увеличивать размер если необходимо. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
Proportional | Реализована | Атрибут | Table.Object.Proportional:<Пропорциональность при масштабировании объекта (INT)> | Атрибут возвращает или изменяет режим соблюдения пропорции при масштабировании содержимого объекта (картинки или OLE-объекта). Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
NotForPrinting | Реализована | Атрибут | Table.Object.NotForPrinting:<Запрет вывода объекта на печать (INT)> | Атрибут возвращает или изменяет режим запрета вывода объекта на печать. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
Picture | Реализована | Атрибут | Table.Object.Picture:<Картинка объекта (PICTURE)> | Атрибут возвращает объект картинки в случае, если текущий объект является картинкой. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
OLE | Реализована | Атрибут | Table.Object.OLE:<OLE-объект (OLE)> | Атрибут возвращает ассоциированный OLE-объект в случае, если текущий объект является OLE-объектом. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
ColorProfile | Реализована | Атрибут | Table.Object.ColorProfile:<Шаблон стиля объекта (INT)> | Атрибут возвращает или изменяет номер шаблона стиля визуального объекта таблицы. По умолчанию это значение равно 0 (цвета и стиль форматирования определяется соответствующими атрибутами объекта, а не номером шаблона). Номера шаблонов можно найти в этой статье. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
BackgroundColor | Реализована | Атрибут | Table.Object.BackgroundColor:<Номер цвета фона объекта (INT)> | Атрибут возвращает или изменяет номер цвета фона визуального объекта таблицы. Система получает цвет по номеру из палитры, для прямого указания цвета используйте атрибут BackgroundColorRGB. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
BackgroundColorRGB | Реализована | Атрибут | Table.Object.BackgroundColorRGB:<Цвет фона объекта (INT)> | Атрибут возвращает или изменяет цвет фона визуального объекта таблицы по его RGB значению. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
FontColor | Реализована | Атрибут | Table.Object.FontColor:<Номер цвета текста объекта (INT)> | Атрибут возвращает или изменяет номер цвета текста визуального объекта таблицы. Система получает цвет по номеру из палитры, для прямого указания цвета используйте атрибут FontColorRGB. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
FontColorRGB | Реализована | Атрибут | Table.Object.FontColorRGB:<Цвет текста объекта (INT)> | Атрибут возвращает или изменяет цвет текста визуального объекта таблицы по его RGB значению. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
FrameColor | Реализована | Атрибут | Table.Object.FrameColor:<Номер цвета обрамления объекта (INT)> | Атрибут возвращает или изменяет номер цвета обрамления визуального объекта таблицы. Система получает цвет по номеру из палитры, для прямого указания цвета используйте атрибут FrameColorRGB. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
FrameColorRGB | Реализована | Атрибут | Table.Object.FrameColorRGB:<Цвет обрамления объекта (INT)> | Атрибут возвращает или изменяет цвет обрамления визуального объекта таблицы по его RGB значению. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
FontStyle | Реализована | Атрибут | Table.Object.FontStyle:<Стиль текста объекта (INT)> | Атрибут возвращает или изменяет стиль текста визуального объекта таблицы. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
FontSize | Реализована | Атрибут | Table.Object.FontSize:<Размер шрифта текста объекта (INT)> | Атрибут возвращает или изменяет размер шрифта текста визуального объекта таблицы. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
Font | Реализована | Атрибут | Table.Object.Font:<Наименование шрифта текста объекта (STRING)> | Атрибут возвращает или изменяет наименование шрифта текста визуального объекта таблицы. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
Frame | Реализована | Атрибут | Table.Object.Frame:<Рисунок и наличие 4-х границ обрамления объекта (INT)> | Атрибут возвращает или изменяет рисунок и наличие четырех границ обрамления визуального объекта таблицы. Значение представляет собой битовую маску, где на каждую из границ используется по 4 бита. По умолчанию, это значение равно 0 (объект не имеет обрамления). Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
LastLoadedImagePath | Реализована | Атрибут | Table.Object.LastLoadedImagePath:<Наименование файла последней загруженной картинки (STRING)> | Атрибут возвращает наименование файла последней загруженной картинки для визуальных объектов таблицы с типом картинка. Признак сохраняется в объекте, к примеру, для универсальных обработчиков печати, и будет заполнен только если картинка была загружена в виде файла. Атрибут работает только, когда визуальный объект был выбран для работы в текущем объекте. | |
Delete | Реализована | Функция | Table.Object.Delete() | Функция удаляет текущий объект из таблицы. |