Обновлено 22.07.2020

Функции для работы с EXCEL

Функции для работы с документом формата *.xls "Книга Excel 97-2003". Эти функции не требуют установленного Excel. Для работы с документом *.xlsx предусмотрена Функция конвертации.

Для всех функций действуют следующие обозначения:

NumXLS - номер документа Excel
NumSheet - номер листа
X, Y - координаты ячейки X - строка, Y - столбец
Value - значение
Width - ширина
Align - выравнивание left/center/right
NameFont - наименование шрифта
Size - размер шрифта
Color - цвет шрифта
Bold, Italic, Underline, StrikeOut - стиль шрифта

Функции работы с документом

NumSheet =CreateXLS([Sheet1, Sheet2,… SheetN])

Создать документ Excel с одним или более листами (Sheet1 - по умолчанию), возвращает номер документа. Возвращаемое значение - числовое

NumSheet =OpenXLS(NameXLS[, Password])

Открыть документ Excel с именем “NameXLS”, возвращает номер документа. Необязательный параметр "Password", если файл был сохранен с паролем. Возвращаемое значение - числовое

SaveXLS(NumXLS, NameXLS[, Password])

Сохранить документ Excel номер “NumXLS” с именем “NameXLS”. “Password” - пароль. Возвращаемое значение - логическое "Да", если документ сохранен и "Нет", если документ сохранить не удалось.

ShowXLS(NameXLS)

Открыть документ Excel с именем “NameXLS” программой, назначенной в ОС для файлов с расширением XLS. Возвращаемое значение - логическое "Да", если документ был открыт и "Нет", если документ открыть не удалось.

Функции работы с листом

NumSheet =AddSheetXLS(NumXLS, NameSheet)

В документ Excel номер “NumXLS” добавить лист с именем “NameSheet”, возвращает номер листа, возвращаемое значение - числовое

CountSheetsXLS(NumXLS)

Для документа Excel номер “NumXLS” вернуть количество листов. Возвращаемое значение - числовое

Функции работы с ячейкой

GetValueCellXLS(NumXLS, NumSheet, X, Y)

Получить содержимое ячейки с координатами X,Y. Возвращаемое значение - символьное.

SetValueCellXLS(NumXLS, NumSheet, X, Y, Value[, Width, Align])

Заполнить ячейку с координатами X,Y значением "Value". Также можно установить "Width" - ширину ячейки и "Align" - выравнивание left/center/right

SetFontCellXLS(NumXLS, NumSheet, X, Y, NameFont[, Size, Color, Bold, Italic, Underline, StrikeOut])

Указать параметры текста для ячейки с координатами X,Y.

SetBackgroundCellXLS(NumXLS, NumSheet, X, Y, Color[, StyleBg])

указать параметры фона для ячейки с координатами X,Y. "Color" - цвет фона, "StyleBg" - стиль заливки фона

SetBorderColorCellXLS(NumXLS, NumSheet, X, Y, Color[, StyleLine])

Задать цвет линий таблицы для ячейки с координатами X,Y. "Color" - цвет линий, "StyleLine" - стиль линий.

SetRotationCellXLS(NumXLS, NumSheet, X, Y, Style)

Задать вращение текста для ячейки с координатами X,Y. Style - стиль вращения = None/Vertical/Up45/Down45/VerticalUp/VerticalDown.

SetFormulaCellXLS(NumXLS, NumSheet, X, Y, Formula)

Задать формулу для ячейки с координатами X,Y. Формула указывается в соответствии с синтаксисом Excel.

SetFormatCellXLS(NumXLS, NumSheet, X, Y, Format)

Задать формат для ячейки с координатами X,Y. Формат указывается в соответствии с синтаксисом Excel.

SetHAlignCellXLS(NumXLS, NumSheet, X, Y, Align)

Задать горизонтальное выравнивание для ячейки с координатами X,Y. "Align" - выравнивание left/center/right

SetVAlignCellXLS(NumXLS, NumSheet, X, Y, Align)

Задать вертикальное выравнивание для ячейки с координатами X,Y. "Align" - выравнивание top/center/bottom/justify

SetWrapCellXLS(NumXLS, NumSheet, X, Y, Wrap)

Задать перенос текста по словам Wrap = Да / Нет для ячейки с координатами X,Y.

SetMergeCellsXLS(NumXLS, NumSheet, RowFrom, RowTo, ColumnFrom, ColumnTo)

Объединить ячейки RowFrom - строка начала, RowTo - строка конца, ColumnFrom - колонка начала, ColumnTo - колонка конца.

SetUnMergeCellsXLS(NumXLS, NumSheet, RowFrom, RowTo, ColumnFrom, ColumnTo)

Убрать объединение ячеек RowFrom - строка начала, RowTo - строка конца, ColumnFrom - колонка начала, ColumnTo - колонка конца.

SetImageCellXLS(NumXLS, NumSheet, X, Y, Mode, Image[, Stretch])

Поместить картинку "Image" в ячейку с координатами X,Y. Mode = "file"/"picture". Если Mode = "file", то Image - файл формата bmp, jpg, png, задается имя файла и путь. Если Mode = "picture", то Image - это идентификатор картинки из "Коллекция картинок". Если Stretch=True, то растянуть или сжать картинку по размеру ячейки. По умолчанию Stretch=False.

SetHyperlinkCellXLS(NumXLS, NumSheet, X, Y, HyperLink, HyperlinkType)

Задать гиперссылку для ячейки с координатами X,Y. "HyperLink" - гиперссылка, "HyperlinkType" - тип гиперссылки Auto / URL / File / UNC / CurrentWorkBook

SetCommentCellXLS(NumXLS, NumSheet, X, Y, Comment [, Author, RichFormat, Width, Height] )

Задать комментарий для ячейки с координатами X,Y. "Comment" - текст комментария. Необязательные параметры: "Author" - автор, "RichFormat" - стилевое оформление комментария, "Width" - ширина, "Height" - высота.

Функции работы со строками

SetHeightRowXLS(NumXLS, NumSheet, X, Height)

Задать высоту строки X в пикселах.

SetFontRowXLS(NumXLS, NumSheet, X, NameFont[, Size, Color, Bold, Italic, Underline, StrikeOut])

Задать параметры текста для строки X.

SetBackgroundRowXLS(NumXLS, NumSheet, X, Color[, StyleBg])

Задать параметры фона для строки X. "Color" - цвет фона, "StyleBg" - стиль заливки фона.

SetBorderColorRowXLS(NumXLS, NumSheet, X, Color[, StyleLine])

Задать цвет линий таблицы для строки X. "Color" - цвет линий, "StyleLine" - стиль линий.

SetRotationRowXLS(NumXLS, NumSheet, X, Style)

Задать вращение текста для строки X. "Style" - стиль вращения = None/Vertical/Up45/Down45/VerticalUp/VerticalDown.

SetFormatRowXLS(NumXLS, NumSheet, X, Format)

Задать формат для строки X. Формат указывается в соответствии с синтаксисом Excel.

SetHAlignRowXLS(NumXLS, NumSheet, X, Align)

Задать горизонтальное выравнивание для строки X. "Align" - выравнивание left/center/right

SetVAlignRowXLS(NumXLS, NumSheet, X, Align)

Задать вертикальное выравнивание для строки X. "Align" - выравнивание top/center/bottom/justify

SetWrapRowXLS(NumXLS, NumSheet, X, Wrap)

Задать перенос текста по словам Wrap = Да / Нет для строки X.

GetMaxRowXLS(NumXLS, NumSheet)

Получить максимальный номер строки.

GetHeightRowXLS(NumXLS, NumSheet, X)

Получить высоту строки X в пикселах.

InsertRowsXLS(NumXLS, NumSheet, X[,CountRows=1])

Вставить "CountRows" пустых строк после строки X.

DeleteRowsXLS(NumXLS, NumSheet, TopRow , BottomRow)

Удалить строки в интервале между "TopRow" и "BottomRow". }

Функции работы со столбцами

SetWidthColumnXLS(NumXLS, NumSheet, Y, Width)

Установить ширину колонки Y в пикселах.

SetFontColumnXLS(NumXLS, NumSheet, Y, NameFont[, Size, Color, Bold, Italic, Underline, StrikeOut])

Установить параметры текста для колонки Y.

SetBackgroundColumnXLS(NumXLS, NumSheet, Y, Color[, StyleBg])

Установить параметры фона для колонки Y. "Color" - цвет фона, "StyleBg" - стиль заливки фона.

SetBorderColorColumnXLS(NumXLS, NumSheet, Y, Color[, StyleLine])

Установить цвет таблицы для колонки Y. "Color" - цвет линий, "StyleLine" - стиль линий.

SetRotationColumnXLS(NumXLS, NumSheet, Y, Style)

Установить вращение текста для колонки Y. "Style" - стиль вращения = None/Vertical/Up45/Down45/VerticalUp/VerticalDown.

SetFormatColumnXLS(NumXLS, NumSheet, Y, Format)

Установить формат для колонки Y. Формат указывается в соответствии с синтаксисом Excel.

SetHAlignColumnLS(NumXLS, NumSheet, Y, Align)

Задать горизонтальное выравнивание для колонки Y. "Align" - выравнивание left/center/right

SetVAlignColumnXLS(NumXLS, NumSheet, Y, Align)

Задать вертикальное выравнивание для колонки Y. "Align" - выравнивание top/center/bottom/justify

SetWrapColumnXLS(NumXLS, NumSheet, Y, Wrap)

Задать перенос текста по словам Wrap = Да / Нет для колонки Y.

GetWidthColumnXLS(NumXLS, NumSheet, Y)

Получить ширину колонки Y в пикселах.

InsertColumnsXLS(NumXLS, NumSheet, Y[,CountColumns=1])

Вставить "CountColumns" пустых колонок после колонки Y.

DeleteColumnsXLS(NumXLS, NumSheet, LeftColumn , RightColumn)

Удалить колонки в интервале между LeftColumn , RightColumn.

Функции свойств листа

PageSetupOrientationXLS(NumXLS, NumSheet, Orientation)

Установить ориентацию страницы "Orientation" = Landscape/ Portrait

PageSetupMarginXLS(NumXLS, NumSheet, Left[, Right, Top, Bottom])

Установить отступы страницы в дюймах.

PageSetupHeaderMarginXLS(NumXLS, NumSheet, Margin)

Установить отступ заголовка в дюймах.

PageSetupFooterMarginXLS(NumXLS, NumSheet, Margin)

Установить отступ подвала в дюймах.

PageSetupHeaderXLS(NumXLS, NumSheet, LeftText[,CenterText, RightText])

Задать текст заголовка слева, по центру, справа.

PageSetupFooterXLS(NumXLS, NumSheet, LeftText[,CenterText, RightText])

Задать текст подвала слева, по центру, справа.

PageSetupScaleXLS(NumXLS, NumSheet, Procent)

Задать % масштабирования для печати, 100 означает без масштабирования.

PageSetupPrintTitleRowsXLS(NumXLS, NumSheet, RowFrom, RowTo)

Задать вывод строк RowFrom, RowTo на печать для каждого листа

PageSetupFreezeXLS(NumXLS, NumSheet, Rows, Columns)

Зафиксировать на экране Rows строк и Columns колонок.

PageSetupPrintAreaRowsXLS(NumXLS, NumSheet, RowFrom, RowTo, ColumnFrom, ColumnTo)

Определить область печати: строки от "RowFrom" до "RowTo", колонки от "ColumnFrom" до "ColumnTo".

PageSetupPrintGridXLS(NumXLS, NumSheet, PrintGrid)

Если PrintGrid = Да, то на печать будут выведены линии таблицы.

PageSetupPrintDraftXLS(NumXLS, NumSheet, PrintDraft)

Если PrintDraft = Да, то установлен режим "Черновик" для вывода на печать.

PageSetupPageBreaksPreviewXLS(NumXLS, NumSheet, PageBreaksPreview)

Если PageBreaksPreview = Да, то установлен режим видимости разрывов страниц.

PageSetupDisplayZeroXLS(NumXLS, NumSheet, DisplayZero)

Если DisplayZero = Да, то установлен режим видимости нулевых значений на листе.

PageSetupStartPageNumXLS(NumXLS, NumSheet, StartPage)

Установить "StartPage" как начальный номер страницы (по умолчанию 1).

PageSetupAddPageBreaksXLS(NumXLS, NumSheet, Row, Column)

Добавить разрыв страницы после Row, Column.

PageSetupPrintBlackAndWhiteXLS (NumXLS, NumSheet, PrintBlackAndWhite)

Если PrintBlackAndWhite = Да, режим черно-белая печать.

PageSetupPrintRowColLabelsXLS (NumXLS, NumSheet, PrintRowColLabels)

Если PrintRowColLabels = Да,печатать заголовки строк и столбцов.

PageSetupCenterHorizontallyXLS(NumXLS, NumSheet, CenterHorizontally)

Если CenterHorizontally = Да, центровать печать на странице горизонтально.

PageSetupCenterVerticallyXLS (NumXLS, NumSheet, CenterVertically)

Если CenterVertically = Да, центровать печать на странице вертикально.

PageSetupFitPagesHeightXLS(NumXLS, NumSheet, FitPagesHeight)

Установить "FitPagesHeight" - количество страниц, на которых размещается документ в высоту.

PageSetupFitPagesWidthXLS(NumXLS, NumSheet, FitPagesWidth)

Установить "FitPagesWidth" - количество страниц, на которых размещается документ в ширину.

PageSetupPaperSizeXLS(NumXLS, NumSheet, PaperSize)

Установить "PaperSize" - размер бумаги."PaperSize" может принимать следующие значения:

'default' - значение по умолчанию.
'letter' - 8-1/2 in. x 11 in.
'lettersmall' - 8-1/2 in. x 11 in.
'tabloid' - 11 in. x 17 in.
'ledger' - 7 in. x 11 in.
'legal' - 8-1/2 in. x 14 in.
'statement' - 5-1/2 in. x 8-1/2 in.
'executive' - 7-1/2 in. x 10-1/2 in.
'a3' - 297 mm x 420 mm
'a4' - 210 mm x 297 mm
'a4small' - 210 mm x 297 mm
'a5' - 148 mm x 210 mm
'b4' - 250 mm x 354 mm
'b5' - 182 mm x 257 mm
'folio' - 8-1/2 in. x 13 in.
'quarto' - 215 mm x 275 mm
'10x14' - 10 in. x 14 in.
'11x17' - 11 in. x 17 in.
'note' - 8-1/2 in. x 11 in.
'envelope9' - 3-7/8 in. x 8-7/8 in.
'envelope10' - 4-1/8 in. x 9-1/2 in.
'envelope11' - 4-1/2 in. x 10-3/8 in.
'envelope12' - 4-1/2 in. x 11 in.
'envelope14' - 5 in. x 11-1/2 in.
'csheet' - C размер листа
'dsheet' - D размер листа
'esheet' - E размер листа
'envelopedl' - 110 mm x 220 mm
'envelopec3' - 324 mm x 458 mm
'envelopec4' - 229 mm x 324 mm
'envelopec5' - 162 mm x 229 mm
'envelopec6' - 114 mm x 162 mm
'envelopec65' - 114 mm x 229 mm
'envelopeb4' - 250 mm x 353 mm
'envelopeb5' - 176 mm x 250 mm
'envelopeb6' - 176 mm x 125 mm
'envelopeitaly' - 110 mm x 230 mm
'envelopemonarch' - 3-7/8 in. x 7-1/2 in.
'envelopepersonal' - 3-5/8 in. x 6-1/2 in.
'fanfoldus' - 14-7/8 in. x 11 in.
'fanfoldstdgerman' - 8-1/2 in. x 12 in.
'fanfoldlegalgerman' - 8-1/2 in. x 13 in.

Функция конвертации

ConvertExcel(FileSource, Format[, DeleteSource])

Преобразовать (сохранить как) файл <FileSource> XLSX -> XLS или XLS -> XLSX. Возвращаемое значение - логическое: "Да" если конвертация прошла успешно, "Нет" - в противном случае.

<FileSource> - исходный файл формата XLSX или XLS
<Format> - формат, в который надо преобразовать исходный файл: '.xlsx' или '.xls'
<DeleteSource> - необязательный логический параметр: если "Да", то исходный файл после преобразования будет удален. Значение "по усолчанию" - "Нет"