VBA-Programmierung in Microsoft Excel

Tutorial: Die Dialoge

Add-Methode (PageFields-Auflistung)

Erstellt ein neues Seitenfeld. Gibt ein PageField-Objekt zurück.

Syntax

Ausdruck.Add(Source, FieldType, Name, TotalType, Index)

Ausdruck   Ein Ausdruck, der ein PageFields-Objekt zurückgibt.

Source   Variant erforderlich. Gibt die Quelle für das neue Seitenfeld an. Bei neuen Feldern des dscOutput-Typs gibt dieses Argument ein SchemaField-Objekt oder den Namen eines Schemafeldes an. Bei Feldern des dscCalculated-Typs gibt dieses Argument den Ausdruck für das berechnete Feld an. Bei neuen Feldern des dscGrouping-Typs gibt dieses Argument ein PageField-Objekt oder den Namen eines Seitenfeldes an, auf dem diese Gruppierung basiert.

FieldType   Variant optional. Gibt den neuen Feldtyp an. Der Standardwert und die zulässigen Werte hängen vom übergeordneten Objekt ab, das mit dieser Methode verwendet wird. Weitere Informationen finden Sie im Abschnitt "Hinweise" dieses Themas.

Name   Variant optional. Gibt den Namen des neuen Seitenfeldes an. Wenn Sie dieses Argument nicht angeben, ist der Name des Ausgabefeldes identisch mit dem Schemafeld, auf dem es basiert, und der Name des Gruppierungsfelds lautet "By<pagefieldname>" oder "<aggfunction>of<pagefieldname>". Der Name des berechneten Feldes lautet "Expr". In allen Fällen werden automatisch Ziffern angehängt, um den Namen eindeutig zu machen, falls erforderlich.

TotalType   Optionales dscTotalTypeEnum-Objekt. Der Standardwert ist dscNone.

Index   Variant optional. Gibt die Reihenfolgeposition, den Namen oder die aktuelle Objektreferenz für das Seitenfeld an, bevor die neue Seite hinzugefügt wird. Wenn Sie dieses Argument nicht angeben, wird die neue Seite am Ende der Auflistung hinzugefügt. Verwenden Sie dieses Argument ausschließlich in Zusammenhang mit der PageFieldsAuflistung eines GroupingDef-Objekts. Weitere Informationen finden Sie im Anschluss an diesen Absatz.

Anmerkungen

Die PageFields-Auflistung verfügt über drei verschiedene übergeordnete Objekte: RecordsetDef, PageRowsource und GroupingDef. Verwenden Sie die gleiche Add-Methode für alle diese übergeordneten Objekte. Es gibt jedoch einige Unterschiede bei den Standardwerten und den zulässigen Werten in Abhängigkeit von dem übergeordneten Objekt, das Sie verwenden.

  • Bei RecordsetDef.PageFields.Add ist dscOutput der Standardwert für FieldType. Andere zulässige FieldType-Werte sind dscCalculated und dscGrouping. Wenn FieldType auf dscOutput lautet, wird das angegebene Quellfeld der primären Seitenzeilenquelle in der Datensatzgruppendefinition hinzugefügt. Deshalb muss das Quellfeld in der entsprechenden Schemazeilenquelle vorhanden sein. Wenn FieldType auf dscGrouping lautet, muss der TotalType-Wert anders als dscNone sein (ein nichtaggregiertes Gruppierungsfeld kann nur in einer Gruppierungsdefinition existieren, nicht in einer Datensatzgruppendefinition). Sie können das Index-Argument in diesem Szenario nicht verwenden.

  • Bei PageRowsource.PageFields.Add lautet der Standardwert und einzig zulässige Wert für FieldType auf dscOutput. Der einzige zulässige Wert für TotalType lautet dscNone. Sie können das Index-Argument in diesem Szenario nicht verwenden. Durch Verwenden der Add-Methode können Sie Ausgabefelder hinzufügen, um nach Zeilenquellen zu suchen.

  • Bei GroupingDef.PageFields.Add lautet der Standardwert für FieldType auf dscOutput. Der andere zulässige FieldType-Wert ist dscCalculated. Sie können das Index-Argument in diesem Szenario verwenden (Reihenfolge ist wichtig bei der Gruppierung von Definitionen).