Методы коллекции Workbooks

Методы коллекции Workbooks позволяют открывать, закрывать и сохранять рабочие книги.

Метод Add

Метод Add создает новую рабочую книгу (объект Workbook). При этом созданная книга становится активной. Синтаксис метода Add:

Expression.Add(Template) 

Элементы синтаксиса свойства Add приведены в табл.4.

ЭлементОписание
ExpressionВыражение, которое возвращает коллекцию Workbooks
TemplateНеобязательный параметр типа Variant. Этот параметр определяет, как будет создана рабочая книга:
Если этот параметр будет иметь значение строки, определяющей имя файла (включая путь) существующей рабочей книги, то создается рабочая книга с использованием данного файла как шаблона.
В случае когда данный параметр является одной из констант: xlWBATExcel4lntlMacroSheet, xlWBATExcel4MacroSheet, xlWBATWorksheet или xlWBATChart, создаваемая книга будет содержать один лист соответствующего типа.
В том случае, если этот параметр отсутствует, то создается рабочая книга с количеством листов, определяемым значением свойства SheetslnNewWorkbook

Таблица 4. Элементы синтаксиса свойства Add

Метод Close

Метод Close закрывает рабочую книгу.

Метод Open

Метод Open открывает существующую рабочую книгу. Синтаксис метода Open:

 Expresslon.Open(FileName, UpdateLinks, ReadOnly, Format, Password, WriteResPassword, IgnoreReadOnlyRecommended, Origin, Delimiter, Editable, Notify, Converter, AddToMRU) 

Назначение элементов синтаксиса метода Open приведено в табл. 5.

ЭлементОписание
ExpressionОбязательный элемент – выражение, возвращающее коллекцию Workbooks
FileNameОбязательный элемент синтаксиса типа String. Определяет имя открываемой рабочей книги
UpdateLinksНеобязательный параметр типа Variant. Определяет способ обновления связи в открываемом файле. Если данный аргумент отсутствует, то пользователю будет выдан запрос на определение способа обновления связей. Данный параметр имеет следующие допустимые значения:
0 – никакие связи не обновляются;
1 – обновляются внешние ссылки, но не обновляются удаленные ссылки;
2 – обновляются удаленные ссылки, но не обновляются внешние ссылки;
3 – обновляются оба типа ссылок
EditableНеобязательный параметр типа Variant. Если файл является файлом MS Excel 4.0, то этот параметр при задании ему значения True позволяет открыть надстройку как видимое окно. По умолчанию ему присвоено значение False
ReadOnlyНеобязательный параметр типа Variant. Если данный параметр имеет значение True, то открываемый файл имеет атрибут Только для чтения (Read Only)
FormatНеобязательный параметр типа Variant. При открытии текстового файла этот параметр определяет вид символов-разделителей. Ниже представлены допустимые значения данного аргумента:
1 – символы табуляции;
2 – запятые;
3 – пробелы;
4 – точка с запятой;
5 – разделители отсутствуют;
6 – вид разделителя определяется пользователем (с помощью параметра Delimiter)
PasswordНеобязательный параметр типа Variant, задающий строку пароля, необходимого для открытия защищенной рабочей книги. Если при открытии защищенной книги данный аргумент отсутствует, то пользователю будет выдан запрос на ввод пароля
WriteResPasswordНеобязательный параметр типа Variant. Предназначен для задания пароля, необходимого для записи в рабочую книгу. Если при открытии защищенной книги данный аргумент отсутствует, то пользователю будет выдан запрос на ввод пароля
IgnoreReadOnly
Recommended
Необязательный параметр типа Variant. В случае задания ему значения True этот аргумент позволяет устранить вывод сообщения с рекомендацией открытия книги только для чтения (в том случае, если данная рабочая книга была сохранена с параметром Read-Only Recommended)
OriginНеобязательный параметр типа Variant. При открытии текстового файла этот параметр указывает, где был создан этот файл, что необходимо для правильного распознавания страницы кодировки. Значениями данного аргумента может быть одна из констант: xlMacintosh, xlWindows или xlMSDOS. Если данный аргумент отсутствует, то используются текущие параметры операционной системы
DelimiterНеобязательный параметр типа Variant. Если открывается текстовый файл и параметр Format имеет значение, равное 6, то этот аргумент определяет символ-разделитель
NotifyНеобязательный параметр типа Variant. Если файл не может быть открыт для записи, то при задании данному аргументу значения True файл будет добавлен в список уведомления. Если данный аргумент равен False или отсутствует, то открыть файл будет невозможно
ConverterНеобязательный параметр типа Variant. Предназначен для определения индекса фильтра, который будет использован при открытии данного файла. Если фильтр не сможет распознать формат файла, то будут последовательно использованы все доступные фильтры
AddToMRUНеобязательный параметр типа Variant. Если данный параметр имеет значение True, то рабочая книга будет добавлена в список недавно использованных файлов. По умолчанию ему присвоено значение False

Таблица 5. Элементы синтаксиса метода Open

Метод PrintOut

Метод PrintOut позволяет распечатать рабочую книгу (Workbook), диаграмму (Chart), диапазон ячеек (Range), рабочий лист(Worksheet). Синтаксис метода PrintOut представлен ниже:

Expression.PrintOut(From, To, Copies, Previev, ActivePrinter, PrintToFile, Collate)

Синтаксис метода PrintOut содержит элементы, представленные в табл.6.

ЭлементОписание
ExpressionВыражение, возвращающее объект Workbook
FromНеобязательный параметр типа Variant задает страницу, с которой начинается печать. Если этот аргумент отсутствует, то печать начинается с первой страницы.
ToНеобязательный параметр типа Variant задает последнюю печатаемую страницу. Если этот аргумент отсутствует, то печать продолжается до последней страницы.
CopiesНеобязательный параметр типа Variant. Задает количество печатаемых копий
PreviewНеобязательный параметр типа Variant, принимающий одно из двух значений:
Присвоение ему значения True приводит к выводу перед печатью окна предварительного просмотра.
Для значения False (значение по умолчанию) печать производится без предварительного просмотра
ActivePrinterНеобязательный параметр типа Variant. Задает имя активного принтера
PrintToFileНеобязательный параметр типа Variant. Если данный параметр имеет значение True, то производится печать в файл. При этом пользователю выдается запрос на ввод имени файла
CollateНеобязательный параметр типа Variant. Если ему задать значение True, то копии будут объединены.

Таблица 6. Элементы синтаксиса метода PrintOut

Ниже приведен пример распечатки рабочего листа с именем Лист1:

WorkSheets (“Лист1”). PrintOut(1, 2, 1, False, PrintToFile:=True)