Методы коллекции 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)