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.