Grundlegendes über Objekte, Eigenschaften und Methoden

Artikel
04/07/2023

Objekte sind die grundlegenden Bausteine von Microsoft Visual Basic. Fast alles, was Sie in Visual Basic tun, umfasst das Ändern von Objekten. Jedes Element von Microsoft Word – z. B. Dokumente, Tabellen, Absätze, Lesezeichen und Felder – kann durch ein Objekt in Visual Basic dargestellt werden.

Was sind Objekte und Auflistungen?

Ein -Objekt stellt ein Element von Word dar, z. B. ein Dokument, einen Absatz, ein Lesezeichen oder ein einzelnes Zeichen. Eine Auflistung ist ein Objekt, das mehrere andere Objekte enthält, in der Regel desselben Typs. Beispielsweise sind alle Lesezeichenobjekte in einem Dokument in einem einzelnen Auflistungsobjekt enthalten. Mithilfe von Eigenschaften und Methoden können Sie ein einzelnes Objekt oder eine ganze Auflistung von Objekten ändern.

Was ist eine Eigenschaft?

Eine Eigenschaft ist ein Attribut eines Objekts oder ein Aspekt seines Verhaltens. Beispielsweise gehören zu den Eigenschaften eines Dokuments dessen Name, sein Inhalt und sein Speicherstatus sowie ob die Änderungsverfolgung aktiviert ist. Sie können die Charakteristika eines Objekts ändern, indem Sie die Werte seiner Eigenschaften ändern.

Zum Festlegen des Werts einer Eigenschaft schreiben Sie nach dem Verweis auf ein Objekt einen Punkt, den Eigenschaftsnamen, ein Gleichheitszeichen und den neuen Eigenschaftswert. Im folgenden Beispiel wird im Dokument Sales.doc die Änderungsverfolgung aktiviert.

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

In diesem Beispiel Documents bezieht sich auf die Auflistung geöffneter Dokumente, und der Name "Sales.doc" identifiziert ein einzelnes Dokument in der Auflistung. Die TrackRevisions-Eigenschaft wird für dieses einzelne Dokument festgelegt.

Manche Eigenschaften können nicht festgelegt werden. Das Hilfethema für eine Eigenschaft gibt an, ob diese Eigenschaft festgelegt (Lese-/Schreibzugriff) oder nur gelesen (Schreibgeschützt) werden kann.

Durch Zurückgeben des Wertes einer seiner Eigenschaften können Sie Informationen zu einem Objekt erhalten. Im folgenden Beispiel wird der Name des aktiven Dokuments zurückgegeben.

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

In diesem Beispiel ActiveDocument bezieht sich auf das Dokument im aktiven Fenster in Word. Der Name dieses Dokuments wird der Variablen zugewiesen, bezieht sich auf das Dokument im aktiven Fenster in Word. Der Name dieses Dokuments wird der Variablen strDocNamezugewiesen.

HinwBemerkungeneise

Im Hilfethema für die einzelnen Eigenschaften wird angegeben, ob Sie diese Eigenschaft festlegen (Lese-/Schreibzugriff), nur lesen (Schreibgeschützt) oder nur schreiben (Nur Schreibzugriff) können. Der Objektkatalog im Visual Basic-Editor zeigt unten im Katalogfenster ebenfalls den Lese-/Schreibstatus an, wenn die Eigenschaft ausgewählt ist.

Was ist eine Methode?

Eine Methode ist eine Aktion, die ein Objekt ausführen kann. So wie beispielsweise ein Dokument gedruckt werden kann, verfügt das Document-Objekt über eine PrintOut-Methode . Häufig besitzen Methoden Argumente, die näher bestimmen, wie die Aktion durchgeführt wird. Im folgenden Beispiel werden die ersten drei Seiten des aktiven Dokuments gedruckt.

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

In den meisten Fällen sind Methoden Aktionen, und Eigenschaften sind Qualitäten. Die Verwendung einer Methode bewirkt, dass mit einem Objekt etwas passiert, während die Verwendung einer Eigenschaft Informationen zum Objekt zurückgibt oder bewirkt, dass sich eine Qualität des Objekts ändert.

Zurückgeben eines Objekts

Die meisten Objekte werden zurückgegeben, indem ein einzelnes Objekt der Auflistung zurückgegeben wird. Beispielsweise enthält die Documents-Auflistung die geöffneten Word-Dokumente. Sie verwenden die Documents-Eigenschaft des Application-Objekts (das Objekt oben in der Word-Objekthierarchie), um die Documents-Auflistung zurückzugeben.

Nachdem Sie auf die Auflistung zugegriffen haben, können Sie ein einzelnes Objekt zurückgeben, indem Sie einen Indexwert in Klammern angeben (ähnlich wie beim Arbeiten mit Datenfeldern). Der Indexwert ist normalerweise eine Nummer oder ein Name. Weitere Informationen finden Sie unter Zurückgeben eines Objekts aus einer Auflistung.

Im folgenden Beispiel wird die Documents-Eigenschaft zum Zugreifen auf die Documents-Auflistung verwendet. Die Indexnummer wird zur Rückgabe des ersten Dokuments in der Documents-Auflistung verwendet. Die Close-Methode wird dann auf das Document-Objekt angewendet, um das erste Dokument in der Documents-Auflistung zu schließen.

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

Im folgenden Beispiel wird zum Identifizieren eines Document-Objekts innerhalb der Documents-Auflistung ein (als Zeichenfolge angegebener) Name verwendet.

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

Auflistungsobjekte verfügen häufig über Methoden und Eigenschaften, mit denen Sie die gesamte Auflistung von Objekten ändern können. Das Documents-Objekt verfügt über eine Save-Methode , die alle Dokumente in der Auflistung speichert. Im folgenden Beispiel werden die geöffneten Dokumente mithilfe der Save-Methode gespeichert.

Sub SaveAllOpenDocuments() 
    Documents.Save 
End Sub

Das Document-Objekt verfügt auch über eine Save-Methode , die zum Speichern eines einzelnen Dokuments verfügbar ist. Im folgenden Beispiel wird das Dokument mit dem Namen Sales.doc gespeichert.

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

Wenn ein Objekt zurückgegeben werden soll, das sich unten in der Word-Objekthierarchie befindet, müssen Sie einen "Drilldown" zu diesem Objekt ausführen, indem Sie Eigenschaften und Methoden zum Zurückgeben von Objekten verwenden.

Um dies zu sehen, öffnen Sie den Visual Basic-Editor, und klicken Sie im Menü Ansicht auf Objektbrowser. Klicken Sie links in der Liste Klassen auf Anwendung. Klicken Sie dann in der Liste der Mitglieder auf der rechten Seite auf ActiveDocument . Der Text unten im Objektbrowser gibt an, dass ActiveDocument eine schreibgeschützte Eigenschaft ist, die ein Document-Objekt zurückgibt. Klicken Sie unten im Objektbrowser auf Dokument . Das Document-Objekt wird automatisch in der Liste Klassen ausgewählt, und in der Liste Elemente werden die Elemente des Document-Objekts angezeigt. Scrollen Sie durch die Liste der Mitglieder, bis Sie Schließen finden. Klicken Sie auf die Close-Methode . Der Text am unteren Rand des Fensters Objektbrowser zeigt die Syntax für die -Methode an. Wenn Sie weitere Informationen zur Methode benötigen, drücken Sie F1, oder klicken Sie auf die Schaltfläche Hilfe , um zum Hilfethema Close-Methode zu springen.

Mit diesen Informationen können Sie die folgende Anweisung zum Schließen des aktiven Dokuments schreiben.

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

Im folgenden Beispiel wird das aktive Dokumentfenster maximiert.

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

Die ActiveWindow-Eigenschaft gibt ein Window-Objekt zurück, welches das aktive Fenster darstellt. Für die WindowState-Eigenschaft wird die Maximierungskonstante festgelegt (wdWindowStateMaximize).

Im folgenden Beispiel wird ein Dokument erstellt und das Dialogfeld Speichern unter angezeigt, sodass ein Name für das Dokument angegeben werden kann.

Sub CreateSaveNewDocument() 
    Documents.Add.Save 
End Sub

Die Documents-Eigenschaft gibt die Documents-Auflistung zurück. Die Add-Methode erstellt ein neues Dokument und gibt ein Document-Objekt zurück. Die Save-Methode wird dann auf das Document-Objekt angewandt.

Wie Sie sehen, verwenden Sie Methoden oder Eigenschaften, um einen Drilldown zu einem Objekt durchzuführen. Das heißt, Sie geben ein Objekt zurück, indem Sie auf ein in der Objekthierarchie darüber liegendes Objekt eine Methode anwenden oder einem solchen Objekt eine Eigenschaft zuweisen. Nachdem Sie das gewünschte Objekt zurückgegeben haben, können Sie die Methoden anwenden und die Eigenschaften dieses Objekts steuern.

Anzeigen von Hilfeinformationen zu Objekten, Methoden und Eigenschaften

Bis Sie sich mit dem Word-Objektmodell vertraut machen, gibt es Tools, mit denen Sie einen Drilldown durch die Hierarchie durchführen können.

Microsoft IntelliSense. Wenn Sie einen Punkt (.) nach einem Objekt im Visual Basic-Editor eingeben, wird eine Liste der verfügbaren Eigenschaften und Methoden angezeigt. Wenn Sie beispielsweise eingeben Application., wird eine Dropdownliste mit Methoden und Eigenschaften des Application-Objekts angezeigt.
Hilfe. Sie können auch die Hilfe verwenden, um herauszufinden, welche Eigenschaften und Methoden mit einem Objekt verwendet werden können. Jedes Objektthema in der Hilfe enthält einen Sprung siehe auch, der eine Liste der Eigenschaften und Methoden für das Objekt anzeigt. Drücken Sie F1 , während Sie im Objektbrowser oder in einem Modul zum entsprechenden Hilfethema wechseln.
Objektbrowser. Der Objektbrowser im Visual Basic-Editor zeigt die Elemente (Eigenschaften und Methoden) der Word-Objekte an.

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.