Общие сведения об объектах, свойствах и методах

2023-04-07

Объекты являются основными стандартными блоками Microsoft Visual Basic; Почти все, что вы делаете в Visual Basic, включает в себя изменение объектов. Каждый элемент Microsoft Word, например документы, таблицы, абзацы, закладки и поля, может быть представлен объектом в Visual Basic.

Что такое объекты и коллекции?

Объект представляет элемент Word, например документ, абзац, закладку или один символ. Коллекция — это объект, содержащий несколько других объектов, обычно одного типа; Например, все объекты закладки в документе содержатся в одном объекте коллекции. С помощью свойств и методов можно изменить один объект или целую коллекцию объектов.

Что такое свойство?

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

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

Sub TrackChanges() 
    Documents("Sales.doc").TrackRevisions = True 
End Sub

В этом примере Documents ссылается на коллекцию открытых документов, а имя "Sales.doc" определяет один документ в коллекции. Свойство TrackRevisions задано для этого документа.

Некоторые свойства нельзя задать. Раздел справки для свойства указывает, можно ли задать это свойство (чтение и запись) или только чтение (только для чтения).

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

Sub GetDocumentName() 
    Dim strDocName As String 
    strDocName = ActiveDocument.Name 
    MsgBox strDocName 
End Sub

В этом примере ActiveDocument ссылается на документ в активном окне в Word. Имя этого документа присваивается переменной, которая ссылается на документ в активном окне Word. Имя этого документа присваивается переменной strDocName.

Замечания

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

Что такое метод?

Метод — это действие, которое может выполняться объектом. Например, как документ можно распечатать, объект Document имеет метод PrintOut . Методы часто имеют аргументы, определяющие способ выполнения действия. В следующем примере выводится первые три страницы активного документа.

Sub PrintThreePages() 
    ActiveDocument.PrintOut Range:=wdPrintRangeOfPages, Pages:="1-3" 
End Sub

В большинстве случаев методы — это действия, а свойства — качества. Использование метода приводит к тому, что что-то происходит с объектом, а свойство возвращает сведения об объекте или вызывает изменение качества объекта.

Возвращение объекта

Большинство объектов возвращаются путем возврата одного объекта из коллекции. Например, коллекция Documents содержит открытые документы Word. Свойство Documents объекта Application (объект в верхней части иерархии объектов Word) используется для возврата коллекции Documents .

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

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

Sub CloseDocument() 
    Documents(1).Close 
End Sub

В следующем примере используется имя (указанное в виде строки) для идентификации объекта Document в коллекции Documents .

Sub CloseSalesDoc() 
    Documents("Sales.doc").Close 
End Sub

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

Sub SaveAllOpenDocuments() 
    Documents.Save 
End Sub

Объект Document также имеет метод Save , доступный для сохранения одного документа. В следующем примере документ с именем Sales.doc сохраняется.

Sub SaveSalesDoc() 
    Documents("Sales.doc").Save 
End Sub

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

Чтобы узнать, как это делается, откройте редактор Visual Basic и щелкните Обозреватель объектов в меню Вид . Щелкните Приложение в списке Классы слева. Затем щелкните ActiveDocument в списке участников справа. Текст в нижней части обозревателя объектов указывает, что ActiveDocument является свойством только для чтения, которое возвращает объект Document . Щелкните Документ в нижней части обозревателя объектов; Объект Document автоматически выбирается в списке Классы , а в списке Участники отображаются члены объекта Document . Прокрутите список участников, пока не найдите Закрыть. Щелкните метод Close (Закрыть ). В тексте в нижней части окна Обозревателя объектов отображается синтаксис метода . Для получения дополнительных сведений о методе нажмите клавишу F1 или нажмите кнопку Справка , чтобы перейти к разделу Справка по методу Закрыть .

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

Sub CloseDocSaveChanges() 
    ActiveDocument.Close SaveChanges:=wdSaveChanges 
End Sub

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

Sub MaximizeDocumentWindow() 
    ActiveDocument.ActiveWindow.WindowState = wdWindowStateMaximize 
End Sub

Свойство ActiveWindow возвращает объект Window , представляющий активное окно. Для свойства WindowState задается константная максимума (wdWindowStateMaximize).

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

Sub CreateSaveNewDocument() 
    Documents.Add.Save 
End Sub

Свойство Documents возвращает коллекцию Documents . Метод Add создает документ и возвращает объект Document . Затем к объекту Document применяется метод Save.

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

Получение справки по объектам, методам и свойствам

Пока вы не ознакомитесь с объектной моделью Word, вы можете использовать средства, которые помогут вам детализировать иерархию.

Microsoft IntelliSense. При вводе точки (.) после объекта в редакторе Visual Basic отображается список доступных свойств и методов. Например, при вводе Application.отображается раскрывающийся список методов и свойств объекта Application .
Справка. Вы также можете использовать справку, чтобы узнать, какие свойства и методы можно использовать с объектом . Каждый раздел объекта в справке содержит переход см. также, в котором отображается список свойств и методов для объекта . Нажмите клавишу F1 в обозревателе объектов или в модуле, чтобы перейти к соответствующему разделу справки.
Обозреватель объектов. Обозреватель объектов в редакторе Visual Basic отображает элементы (свойства и методы) объектов Word.

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

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