лЕМЧ Visual Basic

         

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


Поскольку свойство Value возвращает значение типа Variant, оно обеспечивает доступ к любому свойству. Для доступа к спискам следует использовать свойство IndexedValue.

Если свойство, представляемое объектом Property, доступно для чтения/записи, свойство Value также доступно для чтения/записи. Если свойство доступно только для чтения, попытка задать для него значение свойства Value приводит к ошибке. Если свойство допускает только запись, попытка возвратить значение свойства Value приводит к ошибке.

Свойство Value является используемым по умолчанию свойством объекта Property.



Объект CodeModule


Представляет программу, определенную для таких компонентов проекта как форма, класс или документ.

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

Объект CodeModule используется для изменения (добавления, удаления или изменения) программы, определенной для компонента.

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

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

Свойство Parent позволяет возвратить объект VBComponent, связанный с программным модулем.



Объект CommandBarEvents


Возвращается свойством CommandBarEvents. Объект CommandBarEvents запускает событие при выборе элемента управления на панели инструментов.

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

Объект CommandBarEvents возвращается свойством CommandBarEvents объекта Events. В интерфейсе возвращенного объекта имеется одно событие нажатия кнопки. Для обработки этого события используется описание WithEvents.



Семейство CommandBars


Содержит все панели команд в проекте, включая панели команд, поддерживающие контекстные меню.

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



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



Свойство FullPath


Возвращает значение типа String, содержащее путь и имя файла адресуемой библиотеки типов. Только для чтения.



Свойство Left


Возвращает или задает значение типа Single, содержащее положение левой границы окна на экране в единицах твип. Чтение/запись.

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

Значение, возвращаемое свойством Left, зависит от того, является ли окно связанным или закрепленным.

Примечание. Изменение значения свойства Left для связанного или закрепленного окна не имеет последствий, пока окно остается связанным или закрепленным.



Свойство LinkedWindowFrame


Возвращает объект Window, представляющий рамку, содержащую окно. Только для чтения.

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

Свойство LinkedWindowFrame обеспечивает доступ к объекту, представляющему рамку связанных окон, свойства которой отличаются от свойств содержащихся в ней окон. Если окно не является связанным, свойство LinkedWindowFrame возвращает значение Nothing.



Свойство MainWindow


Возвращает объект Window, представляющий главное окно среды разработчика Visual Basic. Только для чтения.

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

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



Свойство Major


Возвращает значение типа Long, содержащее основной номер версии адресуемой библиотеки типов. Только для чтения.

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

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



Свойство Minor


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

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

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



Свойство Mode


Возвращает значение, определяющее режим указанного проекта. Только для чтения.

Возвращаемые значения

Свойство Mode возвращает следующие значения:

Константа

Описание

vbext_vm_RunMode

Указанный проект находится в режиме выполнения.

vbext_vm_BreakMode

Указанный проект находится в режиме прерывания.

vbext_vm_DesignMode

Указанный проект находится в режиме конструктора.



Свойство Name


Возвращает или задает значение типа String, содержащее имя, которое используется в программе для идентификации объекта. Для объектов VBProject и VBComponent это свойство доступно для чтения/записи; для объекта Property и объекта Reference свойство доступно только для чтения.

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

В следующей таблице приводится описание способов применения свойства Name для разных объектов.

Объект

Применение свойства Name

  VBProject

Возвращает или задает имя активного проекта.

VBComponent

Возвращает или задает имя компонента. При попытке указать в свойстве Name уже используемое или недопустимое имя возникает ошибка.

Property

Возвращает имя свойства в том виде, как оно выводится в окне свойств. Это же значения используется для индексации семейства Properties. Это имя задать невозможно.

Reference

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

Имя, которое новые объекты получаю по умолчанию, образуется из типа объекта и уникального целого числа. Например, первый новый объект Form получает имя Form1, следующий объект Form имя Form2, а третий элемент управления, являющийся полем (TextBox) в форме имя TextBox3.

Имя объекта (значение свойства Name) должно начинаться с буквы и содержать не более 40 символов. В имя можно включать цифры и символы подчеркивания (_), но нельзя включать пробелы или знаки препинания. Имена форм и модулей не должны совпадать с именами других общих объектов, таких как Clipboard, Screen или App. Хотя в качестве значения свойства Name можно указать ключевое слово, имя свойства или имя другого объекта, делать это не рекомендуется во избежание конфликтов имен в программе.



Свойство NumIndices


Возвращает количество индексов для свойства, возвращаемого объектом Property.

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

Значением свойства NumIndices может быть любое целое число от 0 до 4. Для большинства свойств свойство NumIndices возвращает значение 0. Свойства, индексируемые обычным образом, возвращают значение 1. Массивы свойств могут возвращать значение 2.



Свойство Object


Возвращает или задает значение объекта, который возвращается свойством. Чтение/запись.

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

Если возвращается объект, то свойство Object позволяет задать или возвратить значение этого объекта.



Свойство Parent


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

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

Для большинства объектов определено либо свойство Parent, либо свойство Collection, указывающее на родительский объект, который данный объект имеет в иерархии объектов. Свойство Collection используется, если родительский объект является семейств.

Свойство Parent используют для доступа к свойствам, методам и элементам управления родительского объекта.



Свойство Protection


Возвращает значение, указывающее состояние защиты проекта. Только для чтения.

Возвращаемые значения

Свойство Protection возвращает следующие значения:

Константа

Описание

vbext_Protection

Указанный проект защищен.

vbext_NoProtection

Указанный проект не защищен.

vbext_Locked

Указанный проект блокирован.



Свойство ReferencesEvents


Возвращает объект ReferencesEvents. Только для чтения.

Значения

Аргумент, передаваемый в свойство ReferencesEvents, может иметь следующие значения:

Аргумент

Описание

 

проектVB

Если аргумент проектVB имеет значение Nothing, возвращенный объект будет передавать события в семейства References всех объектов VBProject в семействе VBProjects.

Если аргумент проектVB указывает на допустимый объект VBProject, то возвращенный объект будет передавать события только в семейство References этого проекта.

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

Свойство ReferencesEvents принимает аргумент и возвращает объект-источник события. Объект ReferencesEvents является источником событий, которые генерируются при добавлении или удалении ссылок.



Свойство Top


Возвращает или задает значение типа Single, указывающее положение верхнего края окна на экране в единицах твип. Чтение/запись.

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

Значение, возвращаемое свойством Top, зависит от того, является ли окно закрепленным окном, связанным окном или выводится в режиме закрепления.

Примечание. Изменение значения свойства Top для связанного или закрепленного окна не имеет последствий, пока окно остается связанным или закрепленным.



Свойство TopLine


Возвращает значение типа Long, указывающее номер верхней строки, которая выводится в области программы, или задающее номер строки, которая является верхней в области программы. Чтение/запись.

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

Свойство TopLine возвращает или задает номер строки, которая выводится верхней в области программы. Например, чтобы первой строкой в области программы была строка с номером 25, следует задать для свойства TopLine значение 25.

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



Свойство Type


Возвращает числовое или строковое значение, определяющее тип объекта. Только для чтения.

Возвращаемые значения

Значения свойства Type объекта Window перечислены в следующей таблице:

Константа

Значение

Описание

vbext_wt_CodeWindow

0

Окно программы

vbext_wt_Designer

1

Окно конструктора

vbext_wt_Browser

2

Окно поиска объекта

vbext_wt_Watch

3

Область контрольных значений

vbext_wt_Locals

4

Национальные настройки

vbext_wt_Immediate

5

Область проверки

vbext_wt_ProjectWindow

6

Окно проекта

vbext_wt_PropertyWindow

7

Окно свойств

vbext_wt_Find

8

Диалоговое окно поиска

vbext_wt_FindReplace

9

Диалоговое окно поиска и замены

vbext_wt_Toolbox

10

Набор инструментов

vbext_wt_LinkedWindowFrame

11

Рамка связанных окон

vbext_wt_MainWindow

12

Главное окно

vbext_wt_Preview

13

Окно предварительного просмотра

vbext_wt_ColorPalette

14

Окно палитры цветов

Значения свойства Type объекта VBComponent перечислены в следующей таблице:

Константа

Описание

 

vbext_ct_ClassModule

Модуль класса

vbext_ct_MSForm

Форма Microsoft

vbext_ct_StdModule

Стандартный модуль

vbext_ct_Document

Модуль документа

Значения свойства Type объекта Reference перечислены в следующей таблице:

Константа

Описание

 

vbext_rt_TypeLib

Библиотека типов

vbext_rt_Project

Проект



Свойство Value


Возвращает или задает значение типа Variant, определяющее значение свойства. Чтение/запись.



Свойство VBE


Возвращает корневой объект VBE. Только для чтения.

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

Все объекты имеют свойство VBE, указывающее на корневой объект VBE.



Свойство Version


Возвращает значение типа String, содержащее версию языка Visual Basic для приложений (VBA), используемую приложением. Только для чтения.

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

Значение свойства Version является строкой, содержащей одну или две цифры, точку и еще две цифры; остальная часть строки может содержать любой текст или цифры.



Свойство Visible


Для объекта Window возвращает или задает значение типа Boolean, указывающее, является ли окно видимым. Чтение/запись. Для объекта CodePane возвращает значение типа Boolean, указывающее, является ли видимой область программы в окне. Только для чтения.

Возвращаемые значения

Свойство Visible возвращает следующие значения:

Значение

Описание

True

(По умолчанию). Объект является видимым.

False

Объект является скрытым.



Свойство width


Возвращает или задает значение типа Single, содержащее ширину окна твип. Чтение/запись.

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

Изменение значения свойства width для связанного или закрепленного окна не имеет последствий, пока окно остается связанным или закрепленным.



Свойство Window


Возвращает окно, в котором выводится область программы. Только для чтения.



Свойство WindowState


Возвращает или задает числовое значение, определяющее вид окна. Чтение/запись.

Значения

Свойство WindowState возвращает или задает следующие значения:

Константа

Значение

Описание

vbext_ws_Normal

0

(По умолчанию). Обычное окно.

vbext_ws_Min

1

Окно свернуто в значок.

vbext_ws_Max

2

Окно развернуто до максимального размера.

Пример использования свойства ActiveCodePane

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

Debug.Print Application.VBE.ActiveCodePane.TopLine

Пример использования свойства ActiveVBProject

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

Debug.Print Application.VBE.ActiveVBProject.Name

Пример использования свойства ActiveWindow

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

Debug.Print Application.VBE.ActiveWindow.Caption

Пример использования свойства BuiltIn

В следующем примере свойство BuiltIn используется для возвращения переменной типа Boolean, указывающей, является ли некоторая ссылка в активном проекте встроенной.

Debug.Print Application.VBE.ActiveVBProject.References(1).BuiltIn

Пример использования свойства Caption

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

Debug.Print Application.VBE.ActiveWindow.Caption

Пример использования свойства CodeModule

В следующем примере свойства CodeModule и CountOfLines используются для определения числа строк в указанном программном модуле.

Debug.Print Application.VBE.ActiveVBProject.VBComponents(6).CodeModule.CountOfLines

Пример использования свойства CodePane

В данном примере свойства CodePane и TopLine используются для вывода на экран номера первой строки в программном модуле выделенного объекта VBComponent.

Debug.Print Application.VBE.SelectedVBComponent.CodeModule.CodePane.TopLine

Пример использования свойства CodePanes

В данном примере свойства CodePanes и TopLine используются для вывода на экран номера первой строки указанной области окна программы


Debug.Print Application.VBE.CodePanes(3).TopLine

Пример использования свойства CodePaneView

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

Debug.Print Application.VBE.CodePanes(3).CodePaneView

Пример использования свойства Collection

В следующем примере свойства Collection и Count используются для определения номеров объектов, содержащихся в активном проекте и рассматриваемых как семейство объектов.

Debug.Print Application.VBE.ActiveVBProject.Collection.Count

Пример использования свойства CommandBarEvents

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

Private WithEvents ce As CommandBarEvents

Sub Test()

Dim c As CommandBarControl

Set c = Application.VBE.CommandBars("Сервис").Controls(1)

Set ce = Application.VBE.Events.CommandBarEvents(c)

End Sub

Private Sub ce_Click(ByVal CommandBarControl As Object, Handled As Boolean, CancelDefault As Boolean)

' Место для программы обработки событий.

End Sub

Пример использования свойства Count

В следующем примере свойство Count используется для определения числа объектов VBComponent в указанном проекте.

Debug.Print Application.VBE.VBProjects(1).VBComponents.Count

Пример использования свойства CountOfDeclarationLines

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

Debug.Print Application.VBE.CodePanes(2).CodeModule.CountOfDeclarationLines

Пример использования свойства CountOfLines

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

Application.VBE.CodePanes(2).CodeModule.CountOfLines

Пример использования свойства CountOfVisibleLines

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



Debug.Print Application.VBE.Codepanes(3).CountOfVisibleLines

Пример использования свойства Description

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

Во втором примере свойство Description используется для возвращения подробных имен указанных объектов Reference некоторого проекта.

Application.VBE.VBProjects(1).Description = "Горячие пирожки"

Debug.Print Application.VBE.VBProjects(1).Description

Debug.Print Application.VBE.VBProjects(1).References(1).Description

Debug.Print Application.VBE.VBProjects(1).References(2).Description

Пример использования свойства Designer

В следующем примере свойства Designer и Count используются для определения числа элементов управления в форме. При этом окно, содержащее данную форму, должно быть выделено. Объектом свойства Designer (конструктор) является сама форма.

Debug.Print Application.VBE.SelectVBComponent.Designer.Controls.Count

Пример использования свойства DesignerWindow

В следующем примере свойства DesignerWindow и Visibile использованы, чтобы определить, является ли некоторый конструктор видимым. При этом объект VBComponent должен представлять собой форму.

Debug.Print Application.VBE.VBProjects(1).VBComponents(1).DesignerWindow.Visible

Пример использования свойства FullPath

В следующем примере свойство FullPath используется для возвращения полного пути к библиотеке объектов для указанной ссылки.

Debug.Print Application.VBE.ActiveVBProject.References(1).FullPath

Пример использования свойства GUID

В следующем примере свойство GUID используется для возвращения кода GUID для указанного объекта Reference конкретного проекта.

Debug.Print Application.VBE.VBProjects(1).References(1).GUID

Пример использования свойства HasOpenDesigner

В следующем примере свойство HasOpenDesigner использовано, чтобы определить, имеет ли указанный компонент некоторого проекта (в данном случае форма) открытый конструктор.



Debug.Print Application.VBE.VBProjects(1).VBComponents(1).HasOpenDesigner

Пример использования свойств height и width

В следующем примере свойства height и width используются для определения высоты и ширины ( в твипах) некоторого окна. Когда указанное окно связано с другим окном или закреплено в главном окне, параметры этих свойств изменяются, поскольку в этих случаях они относятся к объекту Window, в котором исходное окно связано или закреплено.

Debug.Print Application.VBE.Windows(9).height

Debug.Print Application.VBE.Windows(9).width

Пример использования свойства HelpContextID

В следующем примере свойство HelpContextID используется для возвращения идентификатора контекстной справки для файла справочной системы, соответствующего проекту.

Debug.Print Application.VBE.VBProjects(1).HelpContextID

Пример использования свойства HelpFile

В следующем примере свойство HelpFile используется для введения файла справочной системы в проект. Затем полный путь данного файла выводится на печать для проверки выполнения описанной операции.

Application.VBE.VBProjects(1).HelpFile = "C:\HelpStuff\veenob3.hlp"

Debug.Print Application.VBE.VBProjects(1).HelpFile

Пример использования свойства IsBroken

В следующем примере свойство IsBroken используется для возвращения значения, которое определяет, указанный объект Reference в некотором проекте неразрешенной ссылкой.

Debug.Print Application.VBE.vbprojects(1).References(1).IsBroken

Пример использования свойств Left и Top

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

Debug.Print Application.VBE.Windows(9).Left

Debug.Print Application.VBE.Windows(9).Top

Пример использования свойства MainWindow

В следующем примере свойство MainWindow используется для определения объекта Window, представляющего главное окно. Затем заголовок главного окна выводится на печать.



Debug.Print Application.VBE.MainWindow.Caption

Пример использования свойства Major

В следующем примере свойство Major используется для возвращения номера максимальной версии указанного объекта Reference в некотором проекте.

Debug.Print Application.VBE.VBProjects(1).References(1).Major

Пример использования свойства Minor

В следующем примере свойство Minor используется для возвращения номера минимальной версии указанного объекта Reference в некотором проекте.

Debug.Print Application.VBE.VBProjects(1).References(1).Minor

Пример использования свойства Mode

В следующем примере свойство Mode используется для определения режима активного проекта. При этом возвращается заранее определенная константа, соответствующая режиму проекта.

Debug.Print Application.VBE.ActiveVBProject.Mode

Пример использования свойства Name

В следующем примере свойство Name используется для определения имени указанного компонента семейства VBComponents в некотором проекте.

Debug.Print Application.VBE.VBProjects(1).VBComponents(1).Name

Пример использования свойства NumIndices

В следующем примере свойство NumIndices используется для возвращения числа индексов, относящихся к указанному свойству определенного объекта VBComponent.

Debug.Print Application.VBE.VBProjects(1).VBComponents(1).Properties(40).NumIndices

Пример использования свойства Object

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

Set Application.VBE.ActiveVBProject.VBComponents(1).Properties("Значок").Object = LoadPicture("Baseball.ico")

Пример использования свойства Parent

В следующем примере свойство Parent используется для возвращения имени объекта, который в иерархии объектов является родительским для указанного объекта.

Debug.Print Application.VBE.ActiveVBProject.VBComponents.Parent.Name

Пример использования свойства Protection

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



Debug.Print Application.VBE.ActiveVBProject.Protection

Пример использования свойства ReferencesEvents

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

Private WithEvents X As ReferencesEvents

Sub Test()

Set X = Application.VBE.Events.ReferencesEvents

End Sub

Private Sub X_ItemAdded(ByVal Reference As VBIDE.Reference)

' Место для программы добавления элемента.

End Sub

Private Sub X_ItemRemoved(ByVal Reference As VBIDE.Reference)

' Место для программы удаления элемента.

End Sub

Пример использования свойства Saved

В следующем примере свойство Saved используется для возвращения переменной типа Boolean, указывающей, был ли указанный проект сохранен в текущем состоянии.

Debug.Print Application.VBE.VBProjects(1).Saved

Пример использования свойства SelectedVBComponent

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

Debug.Print Application.VBE.SelectedVBComponent.Name

Пример использования свойства TopLine

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

Debug.Print Application.VBE.CodePanes(3).TopLine

Пример использования свойства Type

В следующем примере свойство Type используется для возвращения значения, соответствующего типу указанного компонента семейства VBComponents в некотором проекте. Возвращаемое значение представляет собой константу, определенную заранее для одного из объектных типов компонентов.

Debug.Print Application.VBE.VBProjects(1).VBComponents(1).Type

Пример использования свойства Value

В следующем примере свойство Value используется для возвращения значения указанного свойства одного из компонентов семейства VBComponents.

Debug.Print Application.VBE. ActiveVBProject.VBComponents(1).Properties("AcceptLabelsInFormulas").Value

Пример использования свойства VBE

В следующем примере свойства VBE и Name используются для определения имени активного проекта.



Debug.Print Application.VBE.ActiveVBProject.Name

Пример использования свойства Version

В следующем примере свойство Version используется для определения номера версии главного приложения.

Debug.Print Application.VBE.Version

Пример использования свойства Visible

В следующем примере свойство Visible используется для возвращения переменной типа Boolean, которая показывает, является ли указанное окно видимым.

Debug.Print Application.VBE.Windows(9).Visible

Пример использования свойства Window

В следующем примере свойства Window и Caption используются для возвращения заголовка указанной области окна программы.

Debug.Print Application.VBE.CodePanes(1).Window.Caption

Пример использования свойства WindowState

В следующем примере свойство WindowState используется для определения внешнего вида указанного окна. Возвращаемое значение представляет собой заранее определенную константу, соответствующую внешнему виду окна.

Debug.Print Application.VBE.Windows(9).WindowState