Инструкции Visual Basic

Инструкция

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

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

Инструкции описания

Инструкции присвоения, которые присваивают значение или выражение переменной или константе.

Инструкции присвоения

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

Исполняемые инструкции

Продолжение инструкций на несколько строк

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

Sub DemoBox() 'Эта процедура описывает строковую переменную,

' присваивает ей значение Мария и выводит

' сцепленное сообщение.

Dim myVar As String

myVar = "Иван"

MsgBox Prompt:="Привет " & myVar, _

Title:="Приветствие", _

Buttons:=vbExclamation

End Sub

Комментарии

Комментарии позволяют объяснить процедуру или определенную инструкцию всем читателям программы. Когда процедура выполняется, Visual Basic игнорирует комментарии. Строки комментария начинаются с апострофа (') или со слова Rem, за которым следует пробел. Их можно вносить в любое место процедуры. Чтобы внести комментарий в строку, на которой расположена инструкция, после инструкции следует поставить апостроф, а за ним комментарий. По умолчанию комментарии выделяются в тексте зеленым цветом.

Проверка синтаксических ошибок

Если после набора строки и нажатия клавиши ENTER строка выделяется красным цветом (может появиться также сообщение об ошибке), необходимо выяснить, что неправильно в данной инструкции и исправить ее.

Метод Add

Добавляет объект в семейство.

Синтаксис

объект.Add(компонент)

Синтаксис метода Add содержит следующие элементы:

Элемент

Описание

объект

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

компонент

Обязательный. Для семейства LinkedWindows это объект. Для семейства VBComponents -- специальная константа, представляющая модуль класса, форму или стандартный модуль.

В качестве аргумента компонент может использоваться одна из следующих констант:

Константа

Описание

vbext_ct_ClassModule

Добавляет модуль класса в семейство.

Vbext_ct_MSForm

Добавляет форму в семейство.

Vbext_ct_StdModule

Добавляет стандартный модуль в семейство.

Дополнительные сведения

Для семейства LinkedWindows метод Add добавляет окно в семейство текущих связанных окон.

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

Для семейства VBComponents метод Add создает новый стандартный компонент и добавляет его в проект.

Для семейства VBComponents метод Add возвращает объект VBComponent. Для семейства LinkedWindows метод Add возвращает значение Nothing.

Метод AddFromFile

Для семейства References добавляет ссылку на проект из некоторого файла. Для объекта CodeModule добавляет содержимое файла в модуль.

Синтаксис

объект.AddFromFile(имя_файла)

Синтаксис метода AddFromFile содержит следующие элементы:

Элемент

Описание

объект

имя_файла

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

Дополнительные сведения

Для объекта CodeModule метод AddFromFile вставляет содержимое файла, начиная со строки, предшествующей первой процедуре в программном модуле. Если модуль не содержит процедур, метод AddFromFile помещает содержимое файла в конец модуля.

Метод AddFromGuid

Добавляет ссылку в семейство Reference с помощью уникального кода ссылки (GUID).

Синтаксис

объект.AddFromGuid(GUID, старший, младший) As Reference

Синтаксис метода AddFromGuid содержит следующие элементы:

Элемент

Описание

объект

GUID

Обязательный. Строковое выражение, представляющее код GUID ссылки.

старший

Обязательный. Переменная типа Long, указывающая номер старшей версии ссылки.

младший

Обязательный. Переменная типа Long, указывающая номер младшей версии ссылки.

Дополнительные сведения

Чтобы найти ссылку, которую необходимо добавить, метод AddFromGuid ищет реестр. GUID может быть библиотекой типов, элементом управления, идентификатором класса и т.д.

Метод AddFromString

Добавляет текст в модуль.

Синтаксис

объект.AddFromString

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

Дополнительные сведения

Метод AddFromString вставляет текст, начиная со строки, предшествующей первой процедуре в модуле. Если модуль не содержит процедур, метод AddFromString помещает текст в конец модуля.

Метод Close

Закрывает и уничтожает окно.

Синтаксис

объект.Close

Дополнительные сведения

Метод Close по-разному действует на следующие типы окон:

Если окно является областью окна программы, Close разрушает эту область.

Если окно является конструктором, Close

уничтожает содержащийся в нем конструктор.

Если окно должно всегда оставаться доступным в пункте меню Вид, метод Close скрывает такое окно.

Метод CreateEventProc

Создает процедуру обработки события.

Синтаксис

объект.CreateEventProc(событие, источник) As Long

Синтаксис метода CreateEventProc содержит следующие элементы:

Элемент

Описание

объект

событие

Обязательный. Строковое выражение, указывающее имя события, которое добавляется в модуль.

источник

Обязательный. Строковое выражения, указывающее имя объекта, который является источником события.

Дополнительные сведения

Метод CreateEventProc используется для создания процедуры обработки события. Например, чтобы создать процедуру обработки события "Нажатие кнопки" (Click) для элемента управления Command Button с именем Command1, можно использовать следующий код (CM представляет собой объект типа CodeModule):

TextLocation = CM.CreateEventProc("Нажатие кнопки", "Command1")

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

Метод DeleteLines

Стирает одну строку или указанную последовательность строк.

Синтаксис

объект.DeleteLines (строка [, количество])

Синтаксис метода DeleteLines содержит следующие элементы:

Элемент

Описание

объект

строка

Обязательный. Переменная типа Long, указывающая номер первой строки, которую надо стереть.

количество

Необязательный. Переменная типа Long, указывающая количество строк, которые надо стереть.

Дополнительные сведения

Если число стираемых строк не указано, DeleteLines сотрет одну строку.

Метод Export

Сохраняет компонент как отдельный файл или файлы.

Синтаксис

объект.Export(имя_файла)

Синтаксис метода Export содержит следующие элементы:

Элемент

Описание

объект

имя_файла

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

Дополнительные сведения

Если метод Export используется для сохранения компонента как отдельного файла или файлов, имя этого файла не должно совпадать с именем уже существующего файла, иначе возникает ошибка.

Метод Find

Ищет активный модуль, содержащий указанную строку.

Синтаксис

объект.Find(образец, строка1, столбец1, строка2, столбец2 [, слово] [, регистр] [, выражение]) As Boolean

Синтаксис метода Find содержит следующие элементы:

Элемент

Описание

объект

образец

Обязательный. Переменная типа String, значением которой является искомый текст или образец.

строка1

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

столбец1

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

строка2

Обязательный. Переменная типа Long, указывающая номер последней строки совпадающего с образцом текста (если он найден).

столбец2

Обязательный. Переменная типа Long, указывающая номер последнего столбца совпадающего с образцом текста (если он найден).

слово

Необязательный. Переменная типа Boolean, указывающая, что проводится поиск слов только целиком; в этом случае для нее задается значение True. По умолчанию имеет значение False.

регистр

Необязательный. Переменная типа Boolean, указывающая, что поиск проводится с учетом буквенного регистра; в этом случае для нее задается значение True. По умолчанию имеет значение False.

выражение

Необязательный. Переменная типа Boolean, указывающая, что образцом представляет собой правильное выражение; в этом случае для нее задается значение True. По умолчанию имеет значение False.

Дополнительные сведения

Если найден текст, совпадающий с образцом, метод Find возвращает значение True, в противном случае -- значение False.

Аргументы регистр и образец являются взаимоисключающими. Если оба аргумента имеют значение True, возникает ошибка.

Метод Find не влияет на содержимое диалогового окна Find.

Метод GetSelection

Возвращает выделенный фрагмент в области окна программы.

Синтаксис

объект.GetSelection(строка1, столбец1, строка2, столбец2)

Синтаксис метода GetSelection содержит следующие элементы:

Элемент

Описание

объект

строка1

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

столбец1

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

строка2

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

столбец2

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

Дополнительные сведения

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

Метод Import

Добавляет компонент в проект из файла; возвращает этот вновь добавленный компонент.

Синтаксис

объект.Import(имя_файла) As VBComponent

Синтаксис метода Import содержит следующие элементы:

Элемент

Описание

объект

имя_файла

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

Дополнительные сведения

Метод Import может использоваться для добавления в проект компонента, формы, модуля, класса, и т.д.

Метод InsertLines

Вставляет одну или несколько строк в указанное место программы.

Синтаксис

объект.InsertLines(строка, текст)

Синтаксис метода InsertLines содержит следующие элементы:

Элемент

Описание

объект

строка

Обязательный. Переменная типа Long, указывающая место в программе, куда вставляются новые строки.

текст

Обязательный. Переменная типа String, содержащая вставляемый текст.

Дополнительные сведения

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

Метод Item

Возвращает компонент семейства с заданным номером.

Синтаксис

объект.Item(индекс)

Синтаксис метода Item содержит следующие элементы:

Элемент

Описание

объект

индекс

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

В следующей таблице перечислены семейства и соответствующие им аргументы key для использования с методом Item. Строка, передаваемая в метод Item должна совпадать с аргументом key семейства.

Семейство

Аргумент Key

Windows

Значение свойства Caption

LinkedWindows

Значение свойства Caption

CodePanes

Специальная строка не предусмотрена.

VBProjects

Значение свойства Name

VBComponents

Значение свойства Name

References

Значение свойства Name

Properties

Значение свойства Name

Дополнительные сведения

Аргумент индекс может быть числовым значением или строкой, содержащей заголовок объекта.

Метод Lines

Возвращает указанные строки программы.

Синтаксис

объект.Lines(строка, количество) As String

Синтаксис метода Lines содержит следующие элементы:

Элемент

Описание

объект

строка

Обязательный. Переменная типа Long, указывающая номер первой строки возвращаемого текста

количество

Обязательный. Переменная типа Long, указывающая количество строк возвращаемого текста.

Дополнительные сведения

Номера строк в программном модуле начинаются с 1.

Метод ProcBodyLine

Возвращает первую строку процедуры.

Синтаксис

объект.ProcBodyLine(имя_процедуры, тип_процедуры) As Long

Синтаксис метода ProcBodyLine содержит следующие элементы:

Элемент

Описание

объект

Имя_процедуры

Обязательный. Переменная типа String, содержащая имя процедуры.

Тип_процедуры

Обязательный. Указывает вид процедуры, которую надо найти. Поскольку в модуле может находиться несколько различных процедур Property, необходимо указывать вид искомой процедуры. Все процедуры, отличные от процедур-свойств (т.е., процедуры Sub и Function) используют аргумент vbext_pk_Proc.

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

Константа

Описание

vbext_pk_Get

Соответствует процедуре, возвращающей значение свойства.

vbext_pk_Let

Соответствует процедуре, присваивающей свойству значение.

vbext_pk_Set

Соответствует процедуре, задающей ссылку на объект.

vbext_pk_Proc

Используется со всеми процедурами, отличными от процедур-свойств.

Дополнительные сведения

Первой строкой процедуры является строка, на которой находится инструкция Sub, Function или Property.

Метод ProcCountLines

Возвращает количество строк в указанной процедуре.

Синтаксис

объект.ProcCountLines(имя_процедуры, тип_процедуры) As Long

Синтаксис метода ProcCountLines содержит следующие элементы:

Элемент

Описание

объект

имя_процедуры

Обязательный. Переменная типа String, содержащая имя процедуры.

тип_процедуры

Обязательный. Указывает вид процедуры, которую надо найти. Поскольку в модуле может находиться несколько различных процедур Property, необходимо указывать вид искомой процедуры. Все процедуры, отличные от процедур-свойств(т.е., процедуры Sub и Function) используют аргумент vbext_pk_Proc.

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

Константа

Описание

vbext_pk_Get

Соответствует процедуре, возвращающей значение свойства.

vbext_pk_Let

Соответствует процедуре, присваивающей свойству значение.

vbext_pk_Set

Соответствует процедуре, задающей ссылку на объект.

vbext_pk_Proc

Используется со всеми процедурами, отличными от процедур-свойств.

Дополнительные сведения

Метод ProcCountLines учитывает все пустые строки или строки комментария, предшествующие описанию процедуры, и, если процедура является последней в программном модуле, все пустые строки, следующие за процедурой.