Функция ЭЛЕКТРОННАЯ_ТАБЛИЦА

Функция ЭЛЕКТРОННАЯ_ТАБЛИЦА применяется для чтения и записи документов в программах MS Excel и OpenOffice.org Calc.

После создания или открытия документа может быть выбран текущий лист и текущая ячейка на листе. Ячейка может указываться именем столбца ("A", "B", "C", ...) или его порядковым номером и номером строки. Для текущей ячейки поддерживаются возможности получения и записи значения и формата.

Для обработки больших массивов значений поддерживается работа с буфером, который считывается или записывается одним обращением к офисному приложению.

Перед началом работы с электронной таблицей для нее создается идентификатор, который является переменной строкового типа. Идентификатор электронной таблицы передается в числе параметров при вызове функции. Одновременно можно работать с несколькими электронными таблицами, которые будут иметь различные идентфикаторы.

ФУНКЦИЯ ЭЛЕКТРОННАЯ_ТАБЛИЦА(<действие>, <параметры>)

Параметры

действие: Идентификатор действия.
параметры: Список параметров, количество и смысл которых зависит от указанного действия.

Поддерживаются следующие действия:

НОВЫЙ_ИДЕНТ	– создание нового идентификатора электронной таблицы.
СОЗДАТЬ_ДОК	– cоздает новый документ.
ОТКРЫТЬ_ДОК	– открывает существующий документ (файл .xls, .xlsx, *.ods).
ЗАКРЫТЬ_ДОК	– закрывает текущий документ.
СОХРАНИТЬ_ДОК	– сохраняет изменения в текущем документе.
КОЛ_ЛИСТОВ	– возвращает количество листов в текущем документе.
ПОЗ_ЛИСТА	– возвращает позицию листа по его имени.
ИМЯ_ЛИСТА	– возвращает имя листа по его позиции.
ТЕК_ЛИСТ	– возвращает имя текущего листа.
УСТ_ТЕК_ЛИСТ	– переключает текущий лист.
ВСТАВИТЬ_ЛИСТ	– добавляет новый лист.
УДАЛИТЬ_ЛИСТ	– удаляет существующий лист.
ПЕРЕИМЕНОВАТЬ_ТЕК_ЛИСТ	– переименовывает текущий лист.
РАЗМЕР_ТЕК_ЛИСТА	– вычисляет размер области листа, занятой данными.
ФИКС_ТЕК_ЛИСТ	– задает фиксированные строки и/или столбцы.
ПОЗ_СТОЛБЦА	– возвращает позицию столбца по его имени.
ИМЯ_СТОЛБЦА	– возвращает имя столбца по его позиции.
УСТ_ШИРИНУ_СТОЛБЦА	– устанавливает ширину столбца или выполняет подгонку ширины по данным.
УСТ_ВЫСОТУ_СТРОКИ	– устанавливает ширину столбца или выполняет подгонку ширины по данным.
ВСТАВИТЬ_СТОЛБЦЫ	– вставляет новые столбцы со сдвигом существующих ячеек вправо.
ВСТАВИТЬ_СТРОКИ	– вставляет новые строки со сдвигом существующих ячеек вниз.
УДАЛИТЬ_СТОЛБЦЫ	– удаляет столбцы со сдвигом существующих ячеек влево.
УДАЛИТЬ_СТРОКИ	– удаляет строки со сдвигом существующих ячеек вверх.
ТЕК_ПОЗ	– возвращает номер столбца и номер строки текущей ячейки.
УСТ_ТЕК_ПОЗ	– устанавливает текущую ячейку по номеру столбца и номеру строки.
ТЕК_ЯЧЕЙКА	– возвращает имя столбца и номер строки текущей ячейки.
УСТ_ТЕК_ЯЧЕЙКУ	– устанавливает текущую ячейку по имени столбца и номеру строки.
ТИП_ЯЧЕЙКИ	– возвращает тип данных текущей ячейки.
ЗНАЧ_ЯЧЕЙКИ	– считывает данные ячейки указанного типа.
УСТ_ЗНАЧ_ЯЧЕЙКИ	– записывает данные ячейки указанного типа. Опционально может устанавливать стандартный формат ячейки, соответствующий типу данных.
ФОРМАТ_ЯЧЕЙКИ	– считывает тип и строку формата для текущей ячейки.
УСТ_ФОРМАТ_ЯЧЕЙКИ	– устанавливает формат текущей ячейки по типу и/или строке формата.
СЧИТАТЬ_БУФЕР	– считывает данные ячеек от текущей до указанных пределов во временный буфер. Чтение из буфера выполняется гораздо быстрее, чем напрямую из документа.
СОЗДАТЬ_БУФЕР	– создает буфер для записи данные ячеек от текущей ячейки с указанными размерами. Запись в буфер выполняется гораздо быстрее, чем напрямую в ячейки документа.
ЗАПИСАТЬ_БУФЕР	– записывает данные из буфера в документ и закрывает буфер.
ЗАКРЫТЬ_БУФЕР	– закрывает буфер, когда он более не нужен. Для буфера записи закрывает без сохранения данных.
УСТ_ОБЛ_ОБЪЕДИНЕНИЕ	– объединяет указанную область ячеек.
УСТ_ОБЛ_ВЫРАВНИВАНИЕ	– изменяет выравнивание текста для указанной области ячеек.
УСТ_ОБЛ_ЦВЕТ	– изменяет цвет фона и текст для указанной области ячеек.
УСТ_ОБЛ_ШРИФТ	– изменяет шрифт для указанной области ячеек.
УСТ_ОБЛ_ГРАНИЦЫ	– выборочно изменяет границы для указанной области ячеек.
УСТ_СТР_МАСШТАБ	– изменяет масштаб печати.
ПОДОГНАТЬ_СТР_МАСШТАБ	– подгоняет масштаб печати по указанному количеству страниц.
УСТ_СТР_АЛЬБОМ	– изменяет ориентацию страницы.
УСТ_СТР_ПОЛЯ	– изменяет поля страницы.
УСТ_СТР_ЗАГОЛОВКИ	– устанавливает заголовочные стоблцы и/или строки для печати на каждой странице.
ПОСЛ_ОШИБКА	– возвращает сообщение о последней ошибке, возникшей при выполнении других действий.

НОВЫЙ_ИДЕНТ

Создает новый идентификатор электронной таблицы. Связь идентификатора с реальным документом происходит при выполнении действий СОЗДАТЬ_ДОК и ОТКРЫТЬ_ДОК. Освобождение идентификатора выполняется действием ЗАКРЫТЬ_ДОК. При завершении программы на внутреннем языке все идентификаторы закрываются автоматически.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(НОВЫЙ_ИДЕНТ, ПЕРЕМ ТИП_СТРОКА: док)

Параметры

док: Выходной параметр. Строковый идентификатор документа (электронной таблицы).

СОЗДАТЬ_ДОК

Создает новый документ в указанном офисном приложении. В новом документе содержится один лист.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(СОЗДАТЬ_ДОК, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док, приложение, файл, опции)

успех

Выходной параметр. Признак успешного выполнения.

док

Строковый идентификатор документа (электронной таблицы).

приложение

Офисное приложение, с помощью которого выполнять создание документа:

"Excel" – MS Excel;
"OpenOffice Calc" – OpenOffice.org Calc (или LibreOffice и т.п.);
"Default" – автоматический выбор, в зависимости от того, что установлено.

файл

Имя файла. Имя файла может быть указано позже, при сохранении изменений. Если указан относительный путь, то он применяется к рабочей папке.

опции

В настоящее время не используется.

ОТКРЫТЬ_ДОК

Открывает существующий документ в указанном офисном приложении.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ОТКРЫТЬ_ДОК, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док, приложение, файл, опции)

успех

Выходной параметр. Признак успешного выполнения.

док

Строковый идентификатор документа (электронной таблицы).

приложение

Офисное приложение, с помощью которого выполнять создание документа:

"Excel" – MS Excel;
"OpenOffice Calc" – OpenOffice.org Calc (или LibreOffice и т.п.);
"Default" – автоматический выбор, в зависимости от того, что установлено.

файл

Имя существующего файла. Если указан относительный путь, то он применяется к рабочей папке.

опции

В настоящее время используется следующие опции:

"ReadOnly" – открыть документ в режиме "только чтение".

ЗАКРЫТЬ_ДОК

Закрывает текущий документ без сохранения изменений. После закрытия документа строковый идентификатор более не действителен.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ЗАКРЫТЬ_ДОК, ТИП_СТРОКА: док)

док: Строковый идентификатор документа (электронной таблицы).

СОХРАНИТЬ_ДОК

Сохраняет изменения текущего документа. Формат файла зависит от расширения имени файла.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(СОХРАНИТЬ_ДОК, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док, файл, опции)

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
файл: Имя файла для сохранения. Если параметр не указан, то используется имя файла, заданное при создании или открытии документа. Если указан относительный путь, то он применяется к рабочей папке.
опции: В настоящее время не используется.

ТЕК_ПРИЛ

Возвращает имя офисного приложения, на основе которого происходит работа с текущим документом.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ТЕК_ПРИЛ, ПЕРЕМ ТИП_СТРОКА: имя; ТИП_СТРОКА: док)

имя

Выходной параметр. Имя офисного приложения возвращается в верхнем регистре:

"WORD"	–	Microsoft Word;
"EXCEL"	–	Microsoft Excel;
"OPENOFFICE WRITER"	–	OpenOffice.org Writer;
"OPENOFFICE CALC"	–	OpenOffice.org Calc.

Если нет открытого документа, то возвращается пустая строка.

док

Строковый идентификатор документа (электронной таблицы).

КОЛ_ЛИСТОВ

Возвращает количество листов в текущем документе.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(КОЛ_ЛИСТОВ, ПЕРЕМ ТИП_ЧИСЛО: кол; ТИП_СТРОКА: док)

кол: Выходной параметр. Количество листов. 0 - в случае ошибки.
док: Строковый идентификатор документа (электронной таблицы).

ПОЗ_ЛИСТА

Возвращает позицию листа текущего документа по имени. Листы нумеруются от 1.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(КОЛ_ЛИСТОВ, ПЕРЕМ ТИП_ЧИСЛО: поз; ТИП_СТРОКА: док, имя)

поз: Выходной параметр. Позиция листа. 0 - в случае ошибки.
док: Строковый идентификатор документа (электронной таблицы).
имя: Имя листа.

ИМЯ_ЛИСТА

Возвращает имя листа текущего документа по его позиции. Листы нумеруются от 1.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ИМЯ_ЛИСТА, ПЕРЕМ ТИП_СТРОКА: имя; ТИП_СТРОКА: док; ТИП_ЧИСЛО: поз)

имя: Выходной параметр. Имя листа. Пустая строка - в случае ошибки.
док: Строковый идентификатор документа (электронной таблицы).
поз: Позиция листа.

ТЕК_ЛИСТ

Возвращает имя текущего листа.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ТЕК_ЛИСТ, ПЕРЕМ ТИП_СТРОКА: имя; ТИП_СТРОКА: док)

имя: Выходной параметр. Имя текущего листа. Пустая строка - в случае ошибки.
док: Строковый идентификатор документа (электронной таблицы).

УСТ_ТЕК_ЛИСТ

Устанавливает текущий лист по имени.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_ТЕК_ЛИСТ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док, имя)

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
имя: Имя листа.

ВСТАВИТЬ_ЛИСТ

Добавляет лист с указанным именем пред указанной позицией. Листы нумеруются от 1.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ВСТАВИТЬ_ЛИСТ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док, имя; ТИП_ЧИСЛО: поз)

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
имя: Имя нового листа.
поз: Позиция вставки.

УДАЛИТЬ_ЛИСТ

Удаляет лист с указанным именем.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УДАЛИТЬ_ЛИСТ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док, имя)

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
имя: Имя листа.

ПЕРЕИМЕНОВАТЬ_ТЕК_ЛИСТ

Изменяет имя текущего листа.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ПЕРЕИМЕНОВАТЬ_ТЕК_ЛИСТ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док, имя)

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
имя: Новое имя листа.

РАЗМЕР_ТЕК_ЛИСТА

Вычисляет размер занятой данными области текущего листа. Учитываются ячейки, содержащие значения и формулы. Ячейки, которые содержат только форматирование и/или оформление, не учитываются.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(РАЗМЕР_ТЕК_ЛИСТА, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                      ПЕРЕМ ТИП_ЧИСЛО: ширина, высота)

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
ширина: Выходной параметр. Размер используемой области по горизонтали.
высота: Выходной параметр. Размер используемой области по вертикали.

ФИКС_ТЕК_ЛИСТ

Позволяет зафиксировать указанное количество строк и/или столбцов, которые не будут участвовать в прокрутке.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ФИКС_ТЕК_ЛИСТ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                   ТИП_ЧИСЛО: ширина, высота)

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
ширина: Количество фиксированных столбцов. Если столбцы не требуется фиксировать, то можно указать 0.
высота: Количество фиксированных строк. Если строки не требуется фиксировать, то можно указать 0.

Замечание. При фиксации на экране столбцов или строк в OpenOffice.org Calc (или его аналогах) на короткое время отображается окно документа. Это связано с особенностями реализации этого действия.

ПОЗ_СТОЛБЦА

Вычисляет позицию столбца на листе по его имени. Столбцы нумеруются от 1. Соответствие позиций столбцов и их имен не зависит от листа и документа. Так всегда столбец "A" соответствует позиции 1, "B" – 2 и т.д. Имена столбцов содержат английские буквы. Регистр символов роли не играет.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ПОЗ_СТОЛБЦА, ПЕРЕМ ТИП_ЧИСЛО: поз; ТИП_СТРОКА: док, имя)

поз: Выходной параметр. Позиция столбца в случае успеха, 0 – в случае ошибки.
док: Строковый идентификатор документа (электронной таблицы).
имя: Имя столбца.

ИМЯ_СТОЛБЦА

Вычисляет имя столбца по его позиции на листе. Столбцы нумеруются от 1. Соответствие позиций столбцов и их имен не зависит от листа и документа. Так всегда столбец "A" соответствует позиции 1, "B" – 2 и т.д. Имена столбцов содержат английские буквы. Функция всегда возвращает имена столбцов в верхнем регистре.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ИМЯ_СТОЛБЦА, ПЕРЕМ ТИП_СТРОКА: имя; ТИП_СТРОКА: док; ТИП_ЧИСЛО: поз)

имя: Выходной параметр. Имя столбца в случае успеха, пустая строка – в случае ошибки.
док: Строковый идентификатор документа (электронной таблицы).
поз: Позиция столбца.

Правило, по которому формируются имена столбцов, не является представлением позиции числа в 26-ричной системе счисления, как может показаться с первого взгляда. Так если считать "A" соответствующим 0, то после "X" (аналог 9 в 10-ричной системе) должен идти столбец "BA" (аналог 10). По правилам же электронных таблиц после столбца "X" следует столбец "AA".

УСТ_ШИРИНУ_СТОЛБЦА

Изменяет ширину указанного столбца.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_ШИРИНУ_СТОЛБЦА, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                        ТИП_ЧИСЛО: поз, ширина)

Параметры

успех

Выходной параметр. Признак успешного выполнения.

док

Строковый идентификатор документа (электронной таблицы).

поз

Позиция столбца. Столбцы нумеруются от 1.

ширина

Ширина столбца в сантиметрах.
Также возможны специальные случаи:

При указании нулевого значения столбец становится невидимым.
При указании значения < 0 выполняется автоматическая подгонка ширины столбца к имеющимся данным.

УСТ_ВЫСОТУ_СТРОКИ

Изменяет высоту указанной строки.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_ВЫСОТУ_СТРОКИ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                       ТИП_ЧИСЛО: поз, высота)

Параметры

успех

Выходной параметр. Признак успешного выполнения.

док

Строковый идентификатор документа (электронной таблицы).

поз

Позиция строки. Строки нумеруются от 1.

высота

Высота строки в сантиметрах.
Также возможны специальные случаи:

При указании нулевого значения строка становится невидимой.
При указании значения < 0 выполняется автоматическая подгонка высоты строки к имеющимся данным.

ВСТАВИТЬ_СТОЛБЦЫ

Вставляет указанное количество столбцов в заданную позицию. Ячейки, расположенные правее позиции вставки, смещаются вправо.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ВСТАВИТЬ_СТОЛБЦЫ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                      ТИП_ЧИСЛО: поз, кол)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
поз: Позиция вставки. Столбцы нумеруются от 1.
кол: Количество вставляемых столбцов.

ВСТАВИТЬ_СТРОКИ

Вставляет указанное количество строк в заданную позицию. Ячейки, расположенные ниже позиции вставки, смещаются вниз.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ВСТАВИТЬ_СТРОКИ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                     ТИП_ЧИСЛО: поз, кол)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
поз: Позиция вставки. Строки нумеруются от 1.
кол: Количество вставляемых строк.

УДАЛИТЬ_СТОЛБЦЫ

Удаляет указанное количество столбцов в заданной позиции. Ячейки, расположенные правее позиции удаления, смещаются влево.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УДАЛИТЬ_СТОЛБЦЫ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                     ТИП_ЧИСЛО: поз, кол)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
поз: Позиция удаления. Столбцы нумеруются от 1.
кол: Количество удаляемых столбцов.

УДАЛИТЬ_СТРОКИ

Удаляет указанное количество строк в заданной позиции. Ячейки, расположенные ниже позиции удаления, смещаются вверх.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УДАЛИТЬ_СТРОКИ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                    ТИП_ЧИСЛО: поз, кол)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
поз: Позиция удаления. Строки нумеруются от 1.
кол: Количество удаляемых строк.

ТЕК_ПОЗ

Позволяет получить позицию столбца и строки текущей ячейки.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ТЕК_ПОЗ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                             ПЕРЕМ ТИП_ЧИСЛО: столбец, строка)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
столбец: Выходной параметр. Позиция столбца. Столбцы нумеруются от 1.
строка: Выходной параметр. Позиция строки. Строки нумеруются от 1.

УСТ_ТЕК_ПОЗ

Позволяет выбрать текущую ячейку на текущем листе. С текущей ячейкой работают методы доступа к данным и форматам..

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_ТЕК_ПОЗ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                 ТИП_ЧИСЛО: столбец, строка)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
столбец: Позиция столбца. Столбцы нумеруются от 1.
строка: Позиция строки. Строки нумеруются от 1.

ТЕК_ЯЧЕЙКА

Позволяет получить имя столбца и строки текущей ячейки.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ТЕК_ЯЧЕЙКА, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                ПЕРЕМ ТИП_СТРОКА: столбец; ПЕРЕМ ТИП_ЧИСЛО: строка)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
столбец: Выходной параметр. Имя столбца.
строка: Выходной параметр. Позиция строки. Строки нумеруются от 1.

УСТ_ТЕК_ЯЧЕЙКУ

Позволяет выбрать текущую ячейку на текущем листе. С текущей ячейкой работают методы доступа к данным и форматам.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_ТЕК_ЯЧЕЙКУ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док, столбец;
                                    ТИП_ЧИСЛО: строка)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
столбец: Имя столбца.
строка: Позиция строки. Строки нумеруются от 1.

При переключении текущего листа сбрасывается текущая ячейка. Электронная таблица находится в состоянии "нет текущей ячейки".

Действие УСТ_ТЕК_ПОЗ работает также, но вместо имени столбца указывается его позиция.

ТИП_ЯЧЕЙКИ

Возвращает тип данных, связанных с текущей ячейкой. Ячейка должна быть предварительно выбрана действием УСТ_ТЕК_ПОЗ или УСТ_ТЕК_ЯЧЕЙКУ.

В электронных таблицах данные ячейки и формат ячейки слабо связаны. Данные ячейки могут быть 4-х основных типов:

пустая ячейка;
постоянное текстовое значение;
постоянное числовое значение (включая числовые представления даты и времени);
формула, результатом вычисления которой может быть как текстовое, так и числовое значение.

Действие ТИП_ЯЧЕЙКИ преимущественно ориентируется на данные ячейки, обращаясь к формату ячейки только для разрешения неоднозначности (например, для определения по формату даты, времени или даты/времени).

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ТИП_ЯЧЕЙКИ, ПЕРЕМ ТИП_СТРОКА: тип; ТИП_СТРОКА: док)

Параметры

тип

Выходной параметр. Тип данных ячейки, описываемый набором значений:

"E"	Пустая ячейка. Также используется как индикатор ошибки.
"S"	Текстовое значение.
"I"	Целочисленное значение. Электронные таблицы непосредственно не работают с целочисленными значениями. Может использоваться как подсказка для установки числового формата с 0 знаков после запятой.
"F"	Вещественное значение.
"D"	Дата.
"T"	Время (в пределах суток).
"M"	Дата и время.
"B"	Логическое значение.
"A"	Ячейка содержит формулу.

В случае ошибки метод возвращает значение "E".

док

Строковый идентификатор документа (электронной таблицы).

ЗНАЧ_ЯЧЕЙКИ

Действие ЗНАЧ_ЯЧЕЙКИ – основное средство считывания данных электронной таблицы. Ячейка, для которой выполняется чтение, должна быть предварительно выбрана вызовом метода УСТ_ТЕК_ПОЗ или УСТ_ТЕК_ЯЧЕЙКУ. Если текущая ячейка попадает в область, указанную при вызове действия СЧИТАТЬ_БУФЕР, то чтение значения выполняется из буфера, что радикально увеличивает скорость.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ЗНАЧ_ЯЧЕЙКИ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док, тип; ПЕРЕМ *: знач)

Параметры

успех

Выходной параметр. Признак успешного выполнения.

док

Строковый идентификатор документа (электронной таблицы).

тип

Тип считываемых данных, описываемый набором значений:

"E"	Пустая ячейка.
"S"	Текстовое значение.
"I"	Целочисленное значение. Электронные таблицы непосредственно не работают с целочисленными значениями. Может использоваться как подсказка для установки числового формата с 0 знаков после запятой.
"F"	Вещественное значение.
"D"	Дата.
"T"	Время (в пределах суток).
"M"	Дата и время.
"B"	Логическое значение.
"A"	Считывание формулы ячейки.

знач

Выходной параметр. Переменная для получения значения. Тип переменной должен соответствовать константе, указанной в параметре тип. Для считывания формулы ("A") необходимо предоставить строковую переменную. Чтение формул всегда выполняется в обход буфера.

Данные ячейки могут интерпретироваться по разному в зависимости от запрошенного типа значения. Например, все варианты даты и времени могут быть запрошены как вещественное число. Также у ячейки, содержащей значение дата+время, можно запросить по отдельности значение даты и времени.

УСТ_ЗНАЧ_ЯЧЕЙКИ

Действие УСТ_ЗНАЧ_ЯЧЕЙКИ – основное средство записи данных электронной таблицы. Ячейка, для которой выполняется запись, должна быть предварительно выбрана действием УСТ_ТЕК_ПОЗ или УСТ_ТЕК_ЯЧЕЙКУ. Если текущая ячейка попадает в область, указанную при вызове действия СОЗДАТЬ_БУФЕР, то запись значения выполняется в буфер, что радикально увеличивает скорость. При использовании буфера записи значение записывается в ячейку электронной таблицы во время вызова действия ЗАПИСАТЬ_БУФЕР.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_ЗНАЧ_ЯЧЕЙКИ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док, тип; *: знач;
                                     ТИП_ЛОГИКА: уст_формат)

Параметры

успех

Выходной параметр. Признак успешного выполнения.

док

Строковый идентификатор документа (электронной таблицы).

тип

Тип записываемых данных, описываемый набором значений:

"E"	Пустая ячейка.
"S"	Текстовое значение.
"I"	Целочисленное значение. Электронные таблицы непосредственно не работают с целочисленными значениями. Может использоваться как подсказка для установки числового формата с 0 знаков после запятой.
"F"	Вещественное значение.
"D"	Дата.
"T"	Время (в пределах суток).
"M"	Дата и время.
"B"	Логическое значение.
"A"	Запись формулы ячейки.

знач

Значение для записи в ячейку. Тип значения должен соответствовать константе, указанной в параметре тип. Для записи формулы ("A") необходимо предоставить строковое значение. Запись формул всегда выполняется в обход буфера.

уст_формат

Признак установки стандартного формата ячейки, соответствующего константе, указанной в параметре тип. Если необходимо установить для ячейки специальный формат, то надо указать значение параметра НЕТ, а затем вызвать действие УСТ_ФОРМАТ_ЯЧЕЙКИ с требуемой строкой формата.

ЗНАЧ_ЯЧЕЙКИ_ДВ

Действие ЗНАЧ_ЯЧЕЙКИ_ДВ – это версия действия ЗНАЧ_ЯЧЕЙКИ для одновременного считывания даты и времени. Ячейка, для которой выполняется чтение, должна быть предварительно выбрана вызовом метода УСТ_ТЕК_ПОЗ или УСТ_ТЕК_ЯЧЕЙКУ. Если текущая ячейка попадает в область, указанную при вызове действия СЧИТАТЬ_БУФЕР, то чтение значения выполняется из буфера, что радикально увеличивает скорость.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ЗНАЧ_ЯЧЕЙКИ_ДВ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                    ПЕРЕМ ТИП_ДАТА: дата; ПЕРЕМ ТИП_ВРЕМЯ: время)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
дата: Выходной параметр. Значение даты.
время: Выходной параметр. Значение времени.

УСТ_ЗНАЧ_ЯЧЕЙКИ_ДВ

Действие УСТ_ЗНАЧ_ЯЧЕЙКИ_ДВ – это версия действия УСТ_ЗНАЧ_ЯЧЕЙКИ для записи даты и времени. Ячейка, для которой выполняется запись, должна быть предварительно выбрана вызовом метода УСТ_ТЕК_ПОЗ или УСТ_ТЕК_ЯЧЕЙКУ. Если текущая ячейка попадает в область, указанную при вызове действия СОЗДАТЬ_БУФЕР, то запись значения выполняется в буфер, что радикально увеличивает скорость. При использовании буфера записи значение записывается в ячейку электронной таблицы во время вызова действия ЗАПИСАТЬ_БУФЕР.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_ЗНАЧ_ЯЧЕЙКИ_ДВ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                        ТИП_ДАТА: дата; ТИП_ВРЕМЯ: время; ТИП_ЛОГИКА: уст_формат)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
дата: Значение даты.
время: Значение времени.
уст_формат: Признак установки стандартного формата даты/времени. Если необходимо установить для ячейки специальный формат, то надо указать значение параметра НЕТ, а затем вызвать действие УСТ_ФОРМАТ_ЯЧЕЙКИ с требуемой строкой формата.

ФОРМАТ_ЯЧЕЙКИ

Позволяет получить информацию о формате текущей ячейки. Ячейка, для которой выполняется считывание, должна быть предварительно выбрана вызовом действия УСТ_ТЕК_ПОЗ или УСТ_ТЕК_ЯЧЕЙКУ.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ФОРМАТ_ЯЧЕЙКИ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                   ПЕРЕМ ТИП_СТРОКА: тип, формат;
                                  [ТИП_ЛОГИКА: локал])

Параметры

успех

Выходной параметр. Признак успешного выполнения.

док

Строковый идентификатор документа (электронной таблицы).

тип

Выходной параметр. Описывает семейство форматов. Для общего/стандартного формата, а также для форматов не поддающихся классификации, возвращается "E". Значения возращаемых констант:

"E"	Пустая ячейка.
"S"	Текстовое значение.
"I"	Целочисленное значение. Электронные таблицы непосредственно не работают с целочисленными значениями. Может использоваться как подсказка для установки числового формата с 0 знаков после запятой.
"F"	Вещественное значение.
"D"	Дата.
"T"	Время (в пределах суток).
"M"	Дата и время.
"B"	Логическое значение.
"A"	Ячейка содержит формулу.

формат

Выходной параметр. Переменная для получения строки формата. Синтаксис строки формата в общем случае зависит от вида электронной таблицы (Excel или OOo Calc). Некоторые форматы, тем не менее, обозначаются одинаково. Например, "@" – обозначает текстовый формат, "0.00" – числовой с 2-мя знаками после запятой.

локал

Необязательный параметр. НЕТ (по умолчанию) – строка формата преобразуется в английский вариант, например "#,##0.00". ДА – строка формата остается в локализованном варианте, например "# ##0,00" для русского языка.

При считывании данных листа в буфер не считывается информация о форматах. Поэтому при использовании буфера чтения не следует вызывать действие ФОРМАТ_ЯЧЕЙКИ, т.к. оно работает в обход буфера. Вызов действия ФОРМАТ_ЯЧЕЙКИ для множества ячеек сведет выигрыш от использования буфера на нет.

УСТ_ФОРМАТ_ЯЧЕЙКИ

Позволяет установить стандартный или произвольный формат ячейки. Ячейка, для которой выполняется установка формата, должна быть предварительно выбрана вызовом действия УСТ_ТЕК_ПОЗ или УСТ_ТЕК_ЯЧЕЙКУ. Если текущая ячейка попадает в область, указанную при вызове действия СОЗДАТЬ_БУФЕР, то запись формата выполняется в буфер, что радикально увеличивает скорость. При использовании буфера записи формат применяется к ячейкам электронной таблицы во время вызова действия ЗАПИСАТЬ_БУФЕР.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_ФОРМАТ_ЯЧЕЙКИ, ПЕРЕМ ТИП_ЛОГИКА: успех; 
                                       ТИП_СТРОКА: док, тип, формат;
                                      [ТИП_ЛОГИКА: локал])

Параметры

успех

Выходной параметр. Признак успешного выполнения.

док

Строковый идентификатор документа (электронной таблицы).

тип

Константа из набора:

"E"	Пустая ячейка.
"S"	Текстовое значение.
"I"	Целочисленное значение. Электронные таблицы непосредственно не работают с целочисленными значениями. Может использоваться как подсказка для установки числового формата с 0 знаков после запятой.
"F"	Вещественное значение.
"D"	Дата.
"T"	Время (в пределах суток).
"M"	Дата и время.
"B"	Логическое значение.
"A"	Ячейка содержит формулу.

Задает стандартный формат для типа, если параметр формат равен пустой строке. Иначе описывает семейство формата. Для установки общего/стандартного формата указывается значение "E".

формат

Строка специального формата. Синтаксис строки формата в общем случае зависит от вида электронной таблицы (Excel или OOo Calc). Некоторые форматы, тем не менее, обозначаются одинаково. Например, "@" – обозначает текстовый формат, "0.00" – числовой с 2-мя знаками после запятой.

локал

Необязательный параметр. НЕТ (по умолчанию) – строка формата задается в английском варианте, например "#,##0.00". ДА – строка формата задается в локализованном варианте, например "# ##0,00" для русского языка.

Для установки стандартных форматов можно пользоваться действием УСТ_ЗНАЧ_ЯЧЕЙКИ с параметром уст_формат = ДА.

СЧИТАТЬ_БУФЕР

Позволяет эффективно считать значения множества ячеек электронной таблицы во временный буфер. Последующее чтение значений из буфера не требует взаимодействия с офисным приложением и выполняется в десятки раз быстрее, чем чтение без использования буфера.

Четырехугольная область ячеек электронной таблицы, которую следует считать в буфер, определяется текущей ячейкой и размерами, задаваемыми в параметрах действия. Текущая ячейка должна быть предварительно выбрана вызовом действия УСТ_ТЕК_ПОЗ или УСТ_ТЕК_ЯЧЕЙКУ. Количество столбцов и строк, заполненных данными можно получить вызовом действия РАЗМЕР_ТЕК_ЛИСТА.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(СЧИТАТЬ_БУФЕР, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                   ТИП_ЧИСЛО: ширина, высота)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
ширина: Горизонтальный размер буфера (количество ячеек).
высота: Вертикальный размер буфера (количество ячеек).

Чтение значений ячеек из буфера выполняется только действиями ЗНАЧ_ЯЧЕЙКИ и ЗНАЧ_ЯЧЕЙКИ_ДВ. Выбор текущей ячейки выполняется как обычно: вызовом действий УСТ_ТЕК_ПОЗ или УСТ_ТЕК_ЯЧЕЙКУ. Если выбрана ячейка вне области буфера, то ее чтение выполняется в обход буфера (т.е. медленно).

Считывание типа ячейки (ТИП_ЯЧЕЙКИ) и формата (ФОРМАТ_ЯЧЕЙКИ) выполняется без использования буфера, т.к. буфер не содержит информации о форматах ячеек. Поэтому следует избегать вызова этих действий для всех ячеек, т.к. это сведет на нет преимущества использования буфера. Если ожидаемые типы значений для столбцов неизвестны, то можно, например, считать типы только для первой строки, а далее полагать, что для остальных строк типы те же.

После того, как все интересующие значения из буфера прочитаны, можно освободить ресурсы, занятые буфером, вызовом действия ЗАКРЫТЬ_БУФЕР. При закрытии документа ресурсы буфера освобождаются автоматически.

Для данного документа одновременно поддерживается только один буфер (не важно – чтения или записи). Например, для чтения двух несмежных столбцов можно сначала создать буфер для первого столбца, прочитать значения, закрыть буфер, а затем сделать то же для второго столбца.

Во время использования буфера запрещено переключение текущего листа действием УСТ_ТЕК_ЛИСТ.

СОЗДАТЬ_БУФЕР

Позволяет создать временный буфер для подготовки значений ячеек и их форматов, которые позднее могут быть эффективно записаны в электронную таблицу офисного приложения. Установка значений и форматов ячеек в буфере не требует взаимодействия с офисным приложением и выполняется в десятки раз быстрее, чем запись без использования буфера. Передача значений и форматов из буфера офисному приложению выполняется действием ЗАПИСАТЬ_БУФЕР.

Четырехугольная область ячеек электронной таблицы, для которой следует создать буфер, определяется текущей ячейкой и размерами, задаваемыми в параметрах действия. Текущая ячейка должна быть предварительно выбрана вызовом действий УСТ_ТЕК_ПОЗ или УСТ_ТЕК_ЯЧЕЙКУ.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(СОЗДАТЬ_БУФЕР, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                   ТИП_ЧИСЛО: ширина, высота)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
ширина: Горизонтальный размер буфера (количество ячеек).
высота: Вертикальный размер буфера (количество ячеек).

Запись данных в буфер выполняется только действиями УСТ_ЗНАЧ_ЯЧЕЙКИ, УСТ_ЗНАЧ_ЯЧЕЙКИ_ДВ и УСТ_ФОРМАТ_ЯЧЕЙКИ. Буфер записи содержит не только значения ячеек, но и форматы, чем отличается от буфера чтения. Выбор текущей ячейки выполняется как обычно: вызовом действия УСТ_ТЕК_ПОЗ или УСТ_ТЕК_ЯЧЕЙКУ. Если выбрана ячейка вне области буфера, то ее запись выполняется в обход буфера (т.е. медленно).

После того, как все необходимые данные записаны в буфер, их нужно передать в документ вызовом действия ЗАПИСАТЬ_БУФЕР. Действие ЗАПИСАТЬ_БУФЕР также закрывает буфер, т.е. освобождает все связанные с ним ресурсы. Закрыть буфер записи без сохранения данных можно вызовом действия ЗАКРЫТЬ_БУФЕР. При закрытии документа ресурсы буфера освобождаются автоматически без сохранения данных в документ.

Для данного документа одновременно поддерживается только один буфер (не важно – чтения или записи). Например, для записи двух несмежных столбцов можно сначала создать буфер для первого столбца, записать данные, записать буфер, а затем сделать то же для второго столбца.

Во время использования буфера запрещено переключение текущего листа действием УСТ_ТЕК_ЛИСТ.

ЗАПИСАТЬ_БУФЕР

Выполняет передачу значений и форматов из буфера записи офисному приложению. Также закрывает буфер, т.е. освобождает связанные с ним ресурсы. Буфер записи должен быть предварительно создан вызовом действия СОЗДАТЬ_БУФЕР.

Данные из буфера записываются в область ячеек электронной таблицы, заданную во время создания буфера. Какая ячейка является текущей на момент записи буфера роли не играет.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ЗАПИСАТЬ_БУФЕР, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).

Закрыть буфер записи без сохранения данных можно вызовом действия ЗАКРЫТЬ_БУФЕР. При закрытии документа ресурсы буфера освобождаются автоматически без сохранения данных в документ.

ЗАКРЫТЬ_БУФЕР

Позволяет освободить ресурсы, используемые буфером чтения или записи.

Когда используется буфер записи, то действие ЗАКРЫТЬ_БУФЕР закрывает буфер без сохранения значений в электронную таблицу (в отличие от действия ЗАПИСАТЬ_БУФЕР).

При закрытии документа любой буфер закрывается автоматически.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ЗАКРЫТЬ_БУФЕР, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).

УСТ_ОБЛ_ОБЪЕДИНЕНИЕ

Позволяет объединить указанную прямоугольную область ячеек.

Четырехугольная область ячеек электронной таблицы, для которой следует создать объединение, определяется текущей ячейкой и размерами, задаваемыми в параметрах действия. Текущая ячейка должна быть предварительно выбрана вызовом действий УСТ_ТЕК_ПОЗ или УСТ_ТЕК_ЯЧЕЙКУ.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_ОБЛ_ОБЪЕДИНЕНИЕ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                         ТИП_ЧИСЛО: ширина, высота)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
ширина: Горизонтальный размер области (количество ячеек).
высота: Вертикальный размер области (количество ячеек).

УСТ_ОБЛ_ВЫРАВНИВАНИЕ

Позволяет изменить выравнивание для указанной прямоугольной области ячеек.

Четырехугольная область ячеек электронной таблицы, определяется текущей ячейкой и размерами, задаваемыми в параметрах действия. Текущая ячейка должна быть предварительно выбрана вызовом действий УСТ_ТЕК_ПОЗ или УСТ_ТЕК_ЯЧЕЙКУ.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_ОБЛ_ВЫРАВНИВАНИЕ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                          ТИП_ЧИСЛО: ширина, высота,
                                          ТИП_СТРОКА: выравн_гор, выравн_верт;
                                          ТИП_ЛОГИКА: перенос_по_словам)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
ширина: Горизонтальный размер области (количество ячеек).
высота: Вертикальный размер области (количество ячеек).
выравн_гор: Горизонтальное выравнивание: "П" - вправо, "Ц" - по центру, "Л" - влево, "" - не изменять.
выравн_верт: Вертикальное выравнивание: "В - вверх, "Ц" - по центру, "Н" - вниз, "" - не изменять.
перенос_по_словам: ДА – включает опцию переноса текста по словам.

Внимание! Действия с областями ячеек не буферизируются. Не рекомендуется выполнять большое количество таких вызовов, т.к. это негативно скажется на скорости работы программы. Применяйте выравнивание к большим областям (например, столбцам), а не к индивидуальным ячейкам.

УСТ_ОБЛ_ЦВЕТ

Позволяет изменить цвет фона и текста для указанной прямоугольной области ячеек.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_ОБЛ_ЦВЕТ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                  ТИП_ЧИСЛО: ширина, высота,
                                  ТИП_СТРОКА: фон, текст)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
ширина: Горизонтальный размер области (количество ячеек).
высота: Вертикальный размер области (количество ячеек).
фон: Цвет фона ячеек в формате "R,G,B". Например, "255,0,0" для ярко-красного цвета. Пустая строка "" служит признаком того, что цвет фона изменять не надо.
текст: Цвет текста ячеек в формате "R,G,B". Пустая строка "" служит признаком того, что цвет текста изменять не надо.

Внимание! Действия с областями ячеек не буферизируются. Не рекомендуется выполнять большое количество таких вызовов, т.к. это негативно скажется на скорости работы программы. Применяйте цвет к большим областям (например, столбцам), а не к индивидуальным ячейкам.

УСТ_ОБЛ_ШРИФТ

Позволяет изменить шрифт для указанной прямоугольной области ячеек.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_ОБЛ_ШРИФТ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                   ТИП_ЧИСЛО: ширина, высота,
                                   ТИП_ШРИФТ: шрифт)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
ширина: Горизонтальный размер области (количество ячеек).
высота: Вертикальный размер области (количество ячеек).
шрифт: Требуемый шрифт текста ячеек.

Внимание! Действия с областями ячеек не буферизируются. Не рекомендуется выполнять большое количество таких вызовов, т.к. это негативно скажется на скорости работы программы. Применяйте шрифт к большим областям (например, столбцам), а не к индивидуальным ячейкам.

УСТ_ОБЛ_ГРАНИЦЫ

Позволяет выборочно изменить внешние и внутренние границы для указанной прямоугольной области ячеек.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_ОБЛ_ГРАНИЦЫ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                     ТИП_ЧИСЛО: ширина, высота,
                                     ТИП_СТРОКА: левая, верхняя, правая, нижняя,
                                                 внутр_гор, внутр_верт)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
ширина: Горизонтальный размер области (количество ячеек).
высота: Вертикальный размер области (количество ячеек).
левая: Тип линии для левой внешней границы области ячеек. "" - не изменять существующие границы.
верхняя: Тип линии для верхней внешней границы области ячеек. "" - не изменять существующие границы.
правая: Тип линии для правой внешней границы области ячеек. "" - не изменять существующие границы.
нижняя: Тип линии для нижней внешней границы области ячеек. "" - не изменять существующие границы.
внутр_гор: Тип линии для внутренних горизонтальных границ области ячеек. "" - не изменять существующие границы.
внутр_верт: Тип линии для внутренних вертикальных границ области ячеек. "" - не изменять существующие границы.

Синтаксис типа линии поддерживает указание ширины (жирности), стиля и цвета линии. Для упрощения записи можно указывать только ширину, ширину и стиль или все параметры, включая цвет. По умолчанию использутся черные сплошниые линии.

Синтаксис

<ширина>[/<стиль>[/<цвет>]]

Ширина задается как 1, 2 или 3. Например, "1" - тонкая сплошная черная линия, "3" - жирная сплошная черная линия.

Стиль линии указывается следующими тегами:

SOLID – сплошная линия (по умолчанию);
DASH – пунктирная линия;
DOT – точечная линия.

Например, "1/DASH" - тонкая пунктирная линия, "3/SOLID" - жирная сплошная черная линия.

Цвет задается в формате "R,G,B". Например, "0,255,0" для ярко-зеленого цвета. "1/SOLID/255,0,0" - тонкая красная линия.

Внимание! Действия с областями ячеек не буферизируются. Не рекомендуется выполнять большое количество таких вызовов, т.к. это негативно скажется на скорости работы программы. Применяйте границы к большим областям, а не к индивидуальным ячейкам.

УСТ_СТР_МАСШТАБ

Позволяет изменить масштаб печати.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_CТР_МАСШТАБ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                     ТИП_ЧИСЛО: масштаб)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
масштаб: Масштаб печати в процентах.

ПОДОГНАТЬ_СТР_МАСШТАБ

Позволяет подогнать масштаб печати по указанному количеству страниц.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ПОДОГНАТЬ_CТР_МАСШТАБ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                           ТИП_ЧИСЛО: кол_гор, кол_верт)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
кол_гор: Требуемое количество страниц по горизонтали. Если указан 0, то подгонка по горизонтали не выполняется.
кол_верт: Требуемое количество страниц по вертикали. Если указан 0, то подгонка по вертикали не выполняется.

УСТ_СТР_АЛЬБОМ

Позволяет изменить ориентацию страницы.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_СТР_АЛЬБОМ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                    ТИП_ЛОГИКА: альбом)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
альбом: ДА – альбомная ориентация, НЕТ – портретная.

УСТ_СТР_ПОЛЯ

Позволяет изменить поля страницы.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_СТР_ПОЛЯ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                  ТИП_ЧИСЛО: левое, верхнее, правое, нижнее)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
левое: Левое поле в сантиметрах.
верхнее: Верхнее поле в сантиметрах.
правое: Правое поле в сантиметрах.
нижнее: Нижнее поле в сантиметрах.

УСТ_СТР_ЗАГОЛОВКИ

Позволяет указать заголовочные столбцы и/или строки для печати на каждой странице.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_СТР_ЗАГОЛОВКИ, ПЕРЕМ ТИП_ЛОГИКА: успех; ТИП_СТРОКА: док;
                                       ТИП_ЧИСЛО: нач_столб, нач_строка, кол_столб, кол_строк)

Параметры

успех: Выходной параметр. Признак успешного выполнения.
док: Строковый идентификатор документа (электронной таблицы).
нач_столб: Номер первого заголовочного столбца. Столбцы нумеруются от 1.
нач_строка: Номер первой заголовочной строки. Строки нумеруются от 1.
кол_столб: Количество заголовочных столбцов. Если заголовочные столбцы не требуются, то можно указать 0.
кол_строк: Количество заголовочных строк. Если заголовочные строки не требуются, то можно указать 0.

ПОСЛ_ОШИБКА

Позволяет получить текстовое сообщение об ошибке, произошедшей при вызове других действий.

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ПОСЛ_ОШИБКА, ПЕРЕМ ТИП_СТРОКА: сообщ; ТИП_СТРОКА: док)

Параметры

сообщ: Выходной параметр. Строка сообщения об ошибке или пустая строка, если ошибки не было или сообщение недоступно.
док: Строковый идентификатор документа (электронной таблицы).

Пример

// новый идентификатор
т = ""
ЭЛЕКТРОННАЯ_ТАБЛИЦА(НОВЫЙ_ИДЕНТ, т)

// открываем файл 
успех = НЕТ
ЭЛЕКТРОННАЯ_ТАБЛИЦА(ОТКРЫТЬ_ДОК, успех, т, "Default", "Data.xls", "ReadOnly")
ЕСЛИ НЕ успех ТО 
  сообщ = ""
  ЭЛЕКТРОННАЯ_ТАБЛИЦА(ПОСЛ_ОШИБКА, сообщ, т)
  СООБЩЕНИЕ(сообщ)
  СТОП_ВСЕ 
КОНЕЦ_ЕСЛИ

// выбираем лист
ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_ТЕК_ЛИСТ, успех, т, "Лист1")

// начало буфера в ячейке A1
ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_ТЕК_ЯЧЕЙКУ, успех, т, "A", 1)

// считываем буфер 2 x 100 
ЭЛЕКТРОННАЯ_ТАБЛИЦА(СЧИТАТЬ_БУФЕР, успех, т, 2, 100) 

ЦИКЛ ДЛЯ (стр = 1, 100)
  // выбираем ячейку в столбце "A"
  ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_ТЕК_ЯЧЕЙКУ, успех, т, "A", стр)
  
  // читаем как строку
  назв = ""
  ЭЛЕКТРОННАЯ_ТАБЛИЦА(ЗНАЧ_ЯЧЕЙКИ, успех, т, "S", назв)
  ЕСЛИ НЕ успех ТО СТОП КОНЕЦ_ЕСЛИ  

  // выбираем другую ячейку в столбце "B"
  ЭЛЕКТРОННАЯ_ТАБЛИЦА(УСТ_ТЕК_ЯЧЕЙКУ, успех, т, "B", стр)

  // читаем как вещественное число
  сумма = 0
  ЭЛЕКТРОННАЯ_ТАБЛИЦА(ЗНАЧ_ЯЧЕЙКИ, успех, т, "F", сумма)
  ЕСЛИ НЕ успех ТО СТОП КОНЕЦ_ЕСЛИ  
  
  ОТЛАДКА("Прочитали: " + назв + " " + СТР(сумма))
КОНЕЦ_ЦИКЛА

ЭЛЕКТРОННАЯ_ТАБЛИЦА(ЗАКРЫТЬ_БУФЕР, успех, т) 
ЭЛЕКТРОННАЯ_ТАБЛИЦА(ЗАКРЫТЬ_ДОК, т)