Admin: 1 revision imported

2023-09-25T09:08:00Z

1 revision imported

1>Admin at 05:58, 8 August 2023

2023-08-08T05:58:22Z

Admin: 1 revision imported

2021-02-07T06:53:39Z

1 revision imported

Admin at 15:41, 26 July 2020

2020-07-26T15:41:02Z

New page

{{infobox function
|name=AddObject
|object=[[Электронная таблица SFT|Электронная таблица]]
|caption=Добавление нового встроенного объекта
|type=1
|status=2
|db=0
|exception=Невозможно превратить в число, строку, неверные параметры
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Электронная таблица SFT|Электронная таблица]]}}
Функция добавляет новый объект в таблицу. Для объекта указывается тип, координаты, наименование. Если объект имеет тип OLE или картинка, также задается дополнительный параметр "источник объекта".

== Синтаксис ==
<code>
{{Grey|Table.}}'''AddObject'''(''<Тип визуального объекта (INT)>''{{Optional|,<Наименование объекта (STRING)>,<Источник объекта>,<Тип координат объекта (INT)>{{Default|{{Eq}}0}},<Координаты объекта (STRING)>}})
</code>

==== Аргументы ====
* <code>''<Тип визуального объекта (INT)>''</code> - Параметр задает цифровой тип объекта. Доступны следующие типы объектов:
** '''0''' -- Линия
** '''1''' -- Прямоугольник с текстом (или без)
** '''2''' -- Картинка
** '''3''' -- OLE-объект
* <code>''<Наименование объекта (STRING)>''</code> - {{Optional}} Задает наименование добавляемого объекта. К объекту можно обратиться по наименованию с помощью функции [[Table.Objects|Objects]].
* <code>''<Источник объекта>''</code> - {{Optional}} В зависимости от первого аргумента, данный момент принимать следующие значения:
** Тип равен ''0'' или ''1'' -- Аргумент игнорируется
** Тип равен ''2'' -- Аргумент задает объект, типа картинка для загрузки в добавляемый объект. Аргумент можно опустить, тогда объект будет добавлен, как пустая картинка.
** Тип равен ''3'' -- Аргумент наименование OLE-объекта для инициализации и загрузки в добавляемый объект.
* <code>''<Тип координат объекта (INT)>''</code> - {{Optional}} Задает тип следующего аргумента. Доступны следующие типы:
** '''0''' (по умолчанию) -- Следующий аргумент будет использовать нотацию привязки к номерам столбцов и строк (относительные координаты). Аргумент должен иметь следующий вид: <code><Столбец левой верхней точки объекта>:<Смещение в столбце>,<Строка левой верхней точки объекта>:<Смещение в строке>,<Столбец правой нижней точки объекта>:<Смещение в столбце>,<Строка правой нижней точки объекта>:<Смещение в строке></code>. Смещения задаются как цифровой индекс от 0 до 65535. 0 означает левый край столбца или верхний край строки, 65535 означает самая правая крайняя точка столбца или самая крайняя нижняя точка строки. Все, что между этими числами пропорционально лежит внутри крайних точек (к примеру, для столбцов 32767 -- середина столбца).
** '''1''' -- Следующий аргумент будет использовать нотацию абсолютных координат. Аргумент должен иметь следующий вид: <code><Координата X крайней левой верхней точки>,<Координата Y крайней левой верхней точки>,<Координата X крайней правой нижней точки>,<Координата Y крайней правой нижней точки></code>.
* <code>''<Координаты объекта (STRING)>''</code> - Задает прямоугольник добавляемого объекта. Тип координат, задающих прямоугольник, определяется из предыдущего аргумента.

== Примеры ==
<pre>
Таб:=Form.Таблица.Value;
Таб.AddObject(1,"aText",,0,"2:0,10:0,12:65535,20:65535");
Таб.Objects("aText").Text:="Новый объект";
</pre>

← Older revision	Revision as of 09:08, 25 September 2023
(No difference)

@@ Line 27: / Line 27: @@
 ** '''3''' -- OLE-объект
 * <code>''<Наименование объекта (STRING)>''</code> - {{Optional}} Задает наименование добавляемого объекта. К объекту можно обратиться по наименованию с помощью функции [[Table.Objects|Objects]].
-* <code>''<Источник объекта>''</code> - {{Optional}} В зависимости от первого аргумента, данный момент принимать следующие значения:
+* <code>''<Источник объекта>''</code> - {{Optional}} В зависимости от первого аргумента, в данный момент принимать следующие значения:
 ** Тип равен ''0'' или ''1'' -- Аргумент игнорируется
 ** Тип равен ''2'' -- Аргумент задает объект, типа картинка для загрузки в добавляемый объект. Аргумент можно опустить, тогда объект будет добавлен, как пустая картинка.

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

Table.AddObject - Revision history

Admin: 1 revision imported

1>Admin at 05:58, 8 August 2023

Admin: 1 revision imported

Admin at 15:41, 26 July 2020