Синтаксис процедур и функций

Описание процедуры Sub в VBA имеет следующий вид:

[Private | Public] [Static] Sub имя([список-аргументов])тело-процедурыEnd Sub

Ключевое слово Public в заголовке процедуры используется, чтобы объявить процедуру общедоступной, то есть дать возможность вызывать ее из всех других процедур всех модулей любого проекта. Если модуль, в котором описана процедура, содержит закрывающий оператор Option Private, процедура будет доступна лишь модулям своего проекта. Альтернативный ключ Private используется, чтобы закрыть процедуру от всех модулей, кроме того, в котором она описана. По умолчанию процедура считается общедоступной.

Ключевое слово Static означает, что значения локальных (объявленных в теле процедуры) переменных будут сохраняться в промежутках между вызовами процедуры (используемые процедурой глобальные переменные, описанные вне ее тела, при этом не сохраняются).

Параметр имя – это имя процедуры, удовлетворяющее стандартным условиям VBA на имена переменных.

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

Последовательность операторов (тело процедуры) задает программу выполнения процедуры. Тело процедуры может включать как «пассивные» операторы объявления локальных данных процедуры (переменных, массивов, объектов и др.), так и «активные» – они изменяют состояния аргументов, локальных и внешних (глобальных) переменных и объектов. В тело может входить оператор Exit Sub, приводящий к немедленному завершению процедуры и передаче управления в вызывающую программу. Каждая процедура в VBA определяется отдельно от других, то есть тело одной процедуры не может включать описания других процедур и функций.

Рассмотрим подробнее структуру одного аргумента из списка-аргументов:

[Optional] [ByVal | ByRef] [ParamArray] переменная[()] [As тип] [= значение-по-умолчанию]

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

Альтернативные ключи ByVal и ByRef определяют способ передачи аргумента в процедуру.

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

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

Процедура VBA допускает возможность иметь необязательные аргументы, которые можно опускать в момент вызова. Обобщением такого подхода является возможность иметь переменное, заранее не фиксированное число аргументов. Достигается это за счет того, что один из параметров (последний в списке) может задавать массив аргументов, – в этом случае он задается с описателем ParamArray. Если список-аргументов включает массив аргументов ParamArray, ключ Optional использовать в списке нельзя. Ключевое слово ParamArray. может появиться перед последним аргументом в списке, чтобы указать, что этот аргумент – массив с произвольным числом элементов типа Variant. Перед ним нельзя использовать ключи ByVal, ByRef или Optional.

Переменная – это имя переменной, представляющей аргумент.

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

Параметр тип задает тип значения, передаваемого в процедуру. Он может быть одним из базисных типов VBA (не допускаются только строки String c фиксированной длиной). Обязательные аргументы могут также иметь тип определенной пользователем записи или класса. Если тип аргумента не указан, то по умолчанию ему приписывается тип Variant.

Для необязательных (Optional) аргументов можно явно задать значение по умолчанию. Это константа или константное выражение, значение которого передается в процедуру, если при ее вызове соответствующий аргумент не задан. Для аргументов типа объект (Object) в качестве значения по умолчанию можно задать только Nothing.

Синтаксис определения процедур-функций похож на определение обычных процедур:

[Public | Private] [Static] Function имя [(список-аргументов)] [As тип-значения]тело-функцииEnd Function

Отличие лишь в том, что вместо ключевого слова Sub для объявления функции используется ключевое слово Function, а после списка аргументов следует указать параметр тип-значения, определяющий тип возвращаемого функцией значения. В теле функции должен быть использован оператор присвоения вида:

имя = выражение

Здесь, в левой части оператора стоит имя функции, а в правой – значение выражения, задающего результат вычисления функции. Если при выходе из функции переменной имя значение явно не присвоено, функция возвращает значение соответствующего типа, определенное по умолчанию. Для числовых типов это 0, для строк – строка нулевой длины (««), для типа Variant функция вернет значение Empty, для ссылок на объекты – Nothing.

Чтобы немедленно завершить вычисления функции и выйти из нее, в теле функции можно использовать оператор Exit Function.

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

Function cube(ByVal N As Integer) As Longcube = N*N*NEnd Function

Вызов этой функции может иметь вид

Dim x As Integer, y As Integery = 2x = cube(y+3)

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

Sub cube1(ByVal N As Integer, ByRef C As Long)C = N*N*N ' получение результата в переменной, заданной по ссылкеEnd Sub

Ее также можно использовать для возведения в куб:

cube1(y+3, x)

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

x = cube(y)+sin(cube(x))

то его вычисление с помощью процедуры Cube1 потребовало бы выполнения нескольких операторов и ввода дополнительных переменных:

cube1(y, z)cube1(x, u)x = z+sin(u)

Функции с побочным эффектом

В классическом варианте все аргументы функции являются входными параметрами, и единственный результат вычисления функции – это ее возвращаемое значение, примером является функция Cube. Однако чаще всего, используются функции с побочным эффектом, то есть такие функции, которые помимо получения значения функции изменяют значения некоторых результирующих параметров, передаваемых функции по ссылке. Например:

Public Function SideEffect(ByVal X As Integer, ByRef Y As Integer) As IntegerSideEffect = X+YY = Y+1End Function Public Sub TestSideEffect()Dim X As Integer, Y As Integer, Z As IntegerX = 3: Y = 5Z = X+Y+SideEffect(X, Y)Debug.Print X, Y, ZX = 3: Y = 5Z = SideEffect(X, Y)+X+YDebug.Print X, Y, ZEnd Sub

Вот результаты вычислений:

3 6 16 3 6 17

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

Создание процедуры

Для создания новой процедуры, текст которой пишется вручную, нужно:

1) открыть в окне проектов «Проект-(VBA)Project» (Project Explorer) папку с модулем (формой, документом, рабочим листом и т.п.), к которому требуется добавить процедуру, и, щелкнув этот модуль, открыть окно редактора с кодами процедур модуля;

2) перейти в редактор, набрать ключевое слово (Sub, Function или Property), имя процедуры и ее аргументы; затем нажмите клавишу Enter, и VBA поместит ниже строку с соответствующим закрывающим оператором (End Sub, End Function, End Property);

3) написать текст процедуры между ее заголовком и закрывающим оператором.

Можно автоматизировать работу, вызвав диалоговое окно «Вставка процедуры» (Insert Procedure). Последовательность действий в этом случае следующая:

1) выбрать в меню «Вставка» (Insert) команду «Процедура» (Procedure);

2) в поле «Имя» (Name) появившегося окна «Вставка процедуры» (Insert Procedure) ввести имя процедуры;

3) указать в группе кнопок-переключателей «Тип» (Type) тип создаваемой процедуры: Подпрограмма (Sub), Функция (Function) или Свойство (Property);

4) указать в группе кнопок-переключателей «Область определения» (Scope) вид доступа к процедуре: Общая (Public) или Личная (Private);

5) пометить, если нужно, флажок «Все локальные переменные считать статическими» (All Local Variables as Statics), чтобы в заголовок процедуры добавился ключ Static;

6) щелкнуть кнопку «OK» – в окне редактора появится заготовка процедуры, состоящая из ее заголовка (без параметров) и закрывающего оператора;

7) добавить параметры в заголовок процедуры и написать текст процедуры между ее заголовком и закрывающим оператором.

⇐ Предыдущая 5 6 7 8 9 10 111213 14 Следующая ⇒