Общие сведения о синтаксисе Visual Basic

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

Синтаксис метода Activate

object.Activate

В синтаксисе метода Activate слово "object", написанное курсивом, является заполнителем для предоставляемых данных — в данном случае это код, возвращающий объект. Необходимо четко придерживаться написания слов, выделенных полужирным шрифтом. Например, следующая процедура активирует второе окно в активном документе.

Sub MakeActive() 
    Windows(2).Activate 
End Sub

Синтаксис функции MsgBox

MsgBox (prompt, [ buttons, ] [ title, ] [ helpfile, context ])

В синтаксисе функции MsgBox выделенные курсивом слова являются именованными аргументами функции. Аргументы, заключенные в квадратные скобки, использовать не обязательно. (Не используйте квадратные скобки в коде Visual Basic). Единственный обязательный аргумент для функции MsgBox — это текст для приглашения.

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

MsgBox "Your answer is correct!",0,"Answer Box" 

Чтобы указать аргументы по имени, необходимо после имени аргумента поставить двоеточие и знак равенства (:=), а затем задать значение аргумента. Именованные аргументы можно указывать в любом порядке, например:

MsgBox Title:="Answer Box", Prompt:="Your answer is correct!" 

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

В примере ниже возвращаемое значение функции MsgBox представляет собой число, обозначающее выбранную кнопку, которая хранится в переменной myVar. Так как используется возвращаемое значение, скобки обязательны. Значение переменной отображается в другом окне сообщения.

Sub Question() 
    myVar = MsgBox(Prompt:="I enjoy my job.", _ 
        Title:="Answer Box", Buttons:="4") 
    MsgBox myVar 
End Sub

Синтаксис оператора Option Compare

Option Compare { Binary | Text | Database }

В синтаксисе оператора Option Compare фигурные скобки и вертикальная черта обозначают обязательный выбор между тремя элементами. (Не используйте фигурные скобки в операторе Visual Basic). Например, этот оператор указывает, что строки модуля будут сравниваться в порядке сортировки без учета регистра.

Option Compare Text 

Синтаксис оператора Dim

Dimvarname [([ subscripts ])] [ Astype, ] [ varname [([ subscripts ])] [ Astype ]] . .

В синтаксисе оператора Dim слово Dim является необходимым ключевым словом. Единственным обязательным элементом является элемент varname (имя переменной).

Например, указанный ниже оператор создает три переменные: myVar, nextVar и thirdVar. Они автоматически объявляются переменными типа Variant.

Dim myVar, nextVar, thirdVar 

В приведенном ниже примере показано объявление переменной типа String. Добавление типа данных экономит память и помогает находить ошибки в коде.

Dim myAnswer As String 

Чтобы объявить несколько переменных в одном операторе, включите тип данных для каждой переменной. Переменным, объявленным без типа данных, автоматически назначается тип Variant.

Dim x As Integer, y As Integer, z As Integer 

В представленном ниже операторе переменным x и y назначается тип данных Variant. Переменная z является единственной, которой присваивается тип данных Integer.

Dim x, y, z As Integer 

Сокращение для объявления переменных x и y типом Integer в приведенном выше операторе

Dim x%, y%, z as Integer

Сокращение для типов: % – Integer; & – Long; @ – Currency; # – Double; ! – Single; $ – String

При объявлении переменной массива необходимо использовать скобки. Подстрочные знаки в этом случае не обязательны. Указанный ниже оператор определяет размеры динамического массива myArray.

Dim myArray() 

См. также

Поддержка и обратная связь

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