Свойства объектов в Visual Basic
Возвращает или задает значение типа Single, содержащее положение левой границы окна на экране в единицах твип. Чтение/запись.
Дополнительные сведения
Значение, возвращаемое свойством Left, зависит от того, является ли окно связанным или закрепленным.
Примечание. Изменение значения свойства Left для связанного или закрепленного окна не имеет последствий, пока окно остается связанным или закрепленным.
Возвращает объект Window, представляющий рамку, содержащую окно. Только для чтения.
Дополнительные сведения
Свойство LinkedWindowFrame обеспечивает доступ к объекту, представляющему рамку связанных окон, свойства которой отличаются от свойств содержащихся в ней окон. Если окно не является связанным, свойство LinkedWindowFrame возвращает значение Nothing.
Возвращает значение типа String, содержащее путь и им
Возвращает значение типа Long, содержащее основной номер версии адресуемой библиотеки типов. Только для чтения.
Дополнительные сведения
Значение, возвращаемое свойством Major, соответствует основному номеру версии, сохраненному в библиотеке типов, на которую задается ссылка.
Возвращает значение типа Long, содержащее дополнительный номер версии адресуемой библиотеки типов. Только для чтения.
Дополнительные сведения
Значение, возвращаемое свойством Minor, соответствует дополнительному номеру версии, сохраненному в библиотеке типов, на которую задается ссылка.
Возвращает значение, определяющее режим указанного проекта. Только для чтения.
Возвращаемые значения
Свойство Mode возвращает следующие значения:
|
Константа |
Описание |
|
vbext_vm_RunMode |
Указанный проект находится в режиме выполнения. |
|
vbext_vm_BreakMode |
Указанный проект находится в режиме прерывания. |
|
vbext_vm_DesignMode |
Указанный проект находится в режиме конструктора. |
Возвращает или задает значение типа 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 можно указать ключевое слово, имя свойства или имя другого объекта, делать это не рекомендуется во избежание конфликтов имен в программе.
Возвращает количество индексов для свойства, возвращаемого объектом Property.
Дополнительные сведения
Значением свойства NumIndices может быть любое целое число от 0 до 4. Для большинства свойств свойство NumIndices возвращает значение 0. Свойства, индексируемые обычным образом, возвращают значение 1. Массивы свойств могут возвращать значение 2.
Возвращает или задает значение объекта, который возвращается свойством. Чтение/запись.
Дополнительные сведения
Если возвращается объект, то свойство Object позволяет задать или возвратить значение этого объекта.
Возвращает объект или семейство, которое содержит другой объект или семейство. Только для чтения.
Дополнительные сведения
Для большинства объектов определено либо свойство Parent, либо свойство Collection, указывающее на родительский объект, который данный объект имеет в иерархии объектов. Свойство Collection используется, если родительский объект является семейств.
Свойство Parent используют для доступа к свойствам, методам и элементам управления родительского объекта.
Возвращает значение, указывающее состояние защиты проекта. Только для чтения.
Возвращаемые значения
Свойство Protection возвращает следующие значения:
|
Константа |
Описание |
|
vbext_Protection |
Указанный проект защищен. |
|
vbext_NoProtection |
Указанный проект не защищен. |
|
vbext_Locked |
Указанный проект блокирован. |
Возвращает объект ReferencesEvents. Только для чтения.
Значения
Аргумент, передаваемый в свойство ReferencesEvents, может иметь следующие значения:
|
Аргумент |
Описание |
|
проектVB |
Если аргумент проектVB имеет значение Nothing, возвращенный объект будет передавать события в семейства References всех объектов VBProject в семействе VBProjects. |
Дополнительные сведения
Свойство ReferencesEvents принимает аргумент и возвращает объект-источник события. Объект ReferencesEvents является источником событий, которые генерируются при добавлении или удалении ссылок.
Возвращает или задает значение типа Single, указывающее положение верхнего края окна на экране в единицах твип. Чтение/запись.
Дополнительные сведения
Значение, возвращаемое свойством Top, зависит от того, является ли окно закрепленным окном, связанным окном или выводится в режиме закрепления.
Примечание. Изменение значения свойства Top для связанного или закрепленного окна не имеет последствий, пока окно остается связанным или закрепленным.
Возвращает значение типа Long, указывающее номер верхней строки, которая выводится в области программы, или задающее номер строки, которая является верхней в области программы. Чтение/запись.
Дополнительные сведения
Свойство TopLine возвращает или задает номер строки, которая выводится верхней в области программы. Например, чтобы первой строкой в области программы была строка с номером 25, следует задать для свойства TopLine значение 25.
Значение свойства TopLine должно быть целым положительным числом. Если для свойства TopLine задается значение, превышающее число строк в программе, то значением этого свойства становится номер последней строки.
Возвращает числовое или строковое значение, определяющее тип объекта. Только для чтения.
Возвращаемые значения
Значения свойства 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 |
Проект |
Возвращает или задает значение типа Variant, определяющее значение свойства. Чтение/запись.
Поскольку свойство Value возвращает значение типа Variant, оно обеспечивает доступ к любому свойству. Для доступа к спискам следует использовать свойство IndexedValue.
Если свойство, представляемое объектом Property, доступно для чтения/записи, свойство Value также доступно для чтения/записи. Если свойство доступно только для чтения, попытка задать для него значение свойства Value приводит к ошибке. Если свойство допускает только запись, попытка возвратить значение свойства Value приводит к ошибке.
Свойство Value является используемым по умолчанию свойством объекта Property.
Возвращает корневой объект VBE. Только для чтения.
Дополнительные сведения
Все объекты имеют свойство VBE, указывающее на корневой объект VBE.
Возвращает значение типа String, содержащее версию языка Visual Basic для приложений (VBA), используемую приложением. Только для чтения.
Дополнительные сведения
Значение свойства Version является строкой, содержащей одну или две цифры, точку и еще две цифры; остальная часть строки может содержать любой текст или цифры.
Для объекта Window возвращает или задает значение типа Boolean, указывающее, является ли окно видимым. Чтение/запись. Для объекта CodePane возвращает значение типа Boolean, указывающее, является ли видимой область программы в окне. Только для чтения.
Возвращаемые значения
Свойство Visible возвращает следующие значения:
|
Значение |
Описание |
|
True |
(По умолчанию). Объект является видимым. |
|
False |
Объект является скрытым. |
Возвращает или задает значение типа Single, содержащее ширину окна твип. Чтение/запись.
Дополнительные сведения
Изменение значения свойства width для связанного или закрепленного окна не имеет последствий, пока окно остается связанным или закрепленным.
Возвращает окно, в котором выводится область программы. Только для чтения.
Возвращает или задает числовое значение, определяющее вид окна. Чтение/запись.
Значения
Свойство 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
Представляет программу, определенную для таких компонентов проекта как форма, класс или документ.
Дополнительные сведения
Объект CodeModule используется для изменения (добавления, удаления или изменения) программы, определенной для компонента.
Каждый компонент связывается с одним объектом CodeModule. Однако объект CodeModule может быть связан с несколькими областями программы.
Методы, определенные для объекта CodeModule, позволяют построчно обрабатывать программы и возвращать информацию о тексте программы. Например, метод AddFromString используют для добавления текста в модуль. Метод AddFromString помещает текст непосредственно перед первой процедурой в модуле или в конец модуля, если в модуле нет процедур.
Свойство Parent позволяет возвратить объект VBComponent, связанный с программным модулем.
Возвращается свойством CommandBarEvents. Объект CommandBarEvents запускает событие при выборе элемента управления на панели инструментов.
Дополнительные сведения
Объект CommandBarEvents возвращается свойством CommandBarEvents объекта Events. В интерфейсе возвращенного объекта имеется одно событие нажатия кнопки. Для обработки этого события используется описание WithEvents.
Содержит все панели команд в проекте, включая панели команд, поддерживающие контекстные меню.
Дополнительные сведения
Для включения надстроек, добавляющих панели команд и элементы управления, а также для добавления элементов управления на существующие встроенные панели команд, используют семейство CommandBars.
Назад | Содержание | Вперед