Sheets (Sammlung)

<< Click to Display Table of Contents >>

Sheets (Sammlung)

Zugriffspfade:

Application à Workbooks à Item à Sheets

Application à ActiveWorkbook à Sheets

 1  Beschreibung

Die Sammlung Sheets enthält alle Arbeitsblätter (sheet = englisch für "Blatt") eines Dokuments. Die einzelnen Elemente dieser Sammlung sind vom Typ Sheet.

 2  Zugriff auf die Sammlung

Jedes geöffnete Dokument besitzt genau eine Instanz der Sheets-Sammlung. Diese wird über Workbook.Sheets angesprochen:

' Anzahl der Arbeitsblätter des aktiven Dokuments anzeigen

MsgBox pm.ActiveWorkbook.Sheets.Count

 3  Eigenschaften, Objekte, Sammlungen und Methoden

Eigenschaften:

Count R/O

 

Objekte:

Item Sheet

Application Application

Parent Workbook

 

Methoden:

Add

Count (Eigenschaft, R/O)

Datentyp: Long

Liefert die Anzahl der Sheet-Objekte des Dokuments – in anderen Worten: die Anzahl der Arbeitsblätter des Dokuments.

Item (Zeiger auf Objekt)

Datentyp: Object

Liefert ein einzelnes Sheet-Objekt, also ein einzelnes Arbeitsblatt.

Welches Sheet-Objekt Sie erhalten, hängt von dem Parameter ab, den Sie an Item übergeben. Dies kann entweder der numerische Index oder der Name des gewünschten Arbeitsblatts sein:

' Zeige den Namen des ersten Arbeitsblatts

MsgBox pm.Application.ActiveWorkbook.Sheets.Item(1).Name

 

' Zeige den Namen des Arbeitsblatts mit dem Namen "Einnahmen"

MsgBox pm.Application.ActiveWorkbook.Sheets.Item("Einnahmen").Name

Application (Zeiger auf Objekt)

Liefert das Application-Objekt.

Parent (Zeiger auf Objekt)

Liefert das übergeordnete Objekt, also ein Objekt vom Typ Workbook.

Add (Methode)

Fügt dem Dokument ein neues leeres Arbeitsblatt hinzu und gibt das Sheet-Objekt zurück, das das neue Arbeitsblatt repräsentiert.

Syntax:

 Add [Name]

Parameter:

Name (optional; Typ: String): Name für das neue Arbeitsblatt. Lassen Sie den Parameter weg, wird der Name automatisch generiert ("Tabelle1", "Tabelle2", "Tabelle3" etc.).

Rückgabetyp:

Object

Beispiel:

Sub Main()

 Dim pm as Object

 Dim newDoc as Object

 Dim newSheet as Object

 

 Set pm = CreateObject("PlanMaker.Application")

 pm.Visible = True

 

 ' Ein Dokument hinzufügen

 Set newDoc = pm.Workbooks.Add

 

 ' Dem Dokument ein Arbeitsblatt hinzufügen

 Set newSheet = newDoc.Sheets.Add("MySheet")

 

 ' Namen des neuen Arbeitsblatts anzeigen

 MsgBox newSheet.Name

End Sub

Mit dem von Add zurückgegebenen Sheet können Sie arbeiten wie mit jedem anderen Arbeitsblatt. Sie können aber auch den Rückgabewert von Add ignorieren und sich das neue Arbeitsblatt über ActiveSheet holen.