Table.AddObject

AddObject (Добавление нового встроенного объекта)
Объект: Электронная таблица Статус разработки: Реализована Тип: Функция Обращение к БД: Нет Исключения: Невозможно превратить в число, строку, неверные параметры Визуальность: Нет

• Начальная страница
• Общее описание
• Объекты
• Электронная таблица

Функция добавляет новый объект в таблицу. Для объекта указывается тип, координаты, наименование. Если объект имеет тип OLE или картинка, также задается дополнительный параметр "источник объекта".

Синтаксис

Table.AddObject(<Тип визуального объекта (INT)>,<Наименование объекта (STRING)>,<Источник объекта>,<Тип координат объекта (INT)>=0,<Координаты объекта (STRING)>)

Аргументы

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

Примеры

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