ReportViewer.SetPageSettings-Methode
Legt die Seiteneinstellungen fest, die zum Drucken des aktuellen Berichts im ReportViewer-Steuerelement oder zum Anzeigen im Drucklayoutmodus verwendet werden.
Namespace: Microsoft.Reporting.WinForms
Assembly: Microsoft.ReportViewer.WinForms (in Microsoft.ReportViewer.WinForms.dll)
Syntax
'Declaration
Public Sub SetPageSettings ( _
pageSettings As PageSettings _
)
public void SetPageSettings(
PageSettings pageSettings
)
public:
void SetPageSettings(
PageSettings^ pageSettings
)
member SetPageSettings :
pageSettings:PageSettings -> unit
public function SetPageSettings(
pageSettings : PageSettings
)
Parameter
- pageSettings
Typ: PageSettings
Ein PageSettings-Objekt, das die neuen Seiteneinstellungen enthält.
Dieser Parameter darf nicht nullein Nullverweis (Nothing in Visual Basic) sein.
Hinweise
Standardmäßig verwendet das ReportViewer-Steuerelement beim Drucken des aktuellen Berichts oder beim Anzeigen des aktuellen Berichts im Drucklayoutmodus die in der Berichtsdefinition angegebenen Seiteneinstellungen.Verwenden Sie diese Methode zum Ändern der Seiteneinstellungen für den aktuellen Bericht (nicht die aktuelle Seite), z.B. Ränder und Papierformat.Diese Methode überprüft die Werte für den Rand und das Papierformat im pageSettings-Parameter.Beachten Sie, dass sich die Änderung nur auf den aktuellen Bericht im ReportViewer-Steuerelement auswirkt und nicht für seinen übergeordneten Bericht oder die darüber zugänglichen Drillthroughberichte gilt.
Das ReportViewer-Steuerelement verwendet die pageSettings**.PrinterSettings-Eigenschaft zum Initialisieren des Dialogfelds Drucken, führt aber keine Überprüfung der pageSettings.PrinterSettings-Eigenschaft durch.Die Druckereinstellungen in pageSettings.PrinterSettings** wirken sich auf alle Berichte aus, die im ReportViewer-Steuerelement angezeigt werden.Wenn pageSettings**.PrinterSettings** den Wert nullein Nullverweis (Nothing in Visual Basic) hat, bleiben die bestehenden Druckereinstellungen unverändert.
Falls sich das ReportViewer-Steuerelement beim Aufrufen dieser Methode im Drucklayoutmodus befindet, bricht es alle momentan ausgeführten Renderingvorgänge für Berichte ab und rendert den Bericht unverzüglich neu.