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