Méthode ReportViewer.SetPageSettings
Définit les paramètres de page utilisés pour imprimer le rapport actuel dans le contrôle ReportViewer ou pour l'afficher en mode Page.
Espace de noms : Microsoft.Reporting.WinForms
Assembly : Microsoft.ReportViewer.WinForms (en Microsoft.ReportViewer.WinForms.dll)
Syntaxe
'Déclaration
Public Sub SetPageSettings ( _
pageSettings As PageSettings _
)
'Utilisation
Dim instance As ReportViewer
Dim pageSettings As PageSettings
instance.SetPageSettings(pageSettings)
public void SetPageSettings(
PageSettings pageSettings
)
public:
void SetPageSettings(
PageSettings^ pageSettings
)
member SetPageSettings :
pageSettings:PageSettings -> unit
public function SetPageSettings(
pageSettings : PageSettings
)
Paramètres
- pageSettings
Type : System.Drawing.Printing.PageSettings
Objet PageSettings qui contient les nouveaux paramètres de page.
Ce paramètre ne doit pas être nullune référence Null (Nothing dans Visual Basic).
Notes
Par défaut, le contrôle ReportViewer utilise les paramètres de page spécifiés dans la définition de rapport pour imprimer le rapport actuel ou pour l'afficher en mode Page. Utilisez cette méthode pour modifier les paramètres de page du rapport actuel (et non la page en cours), tels que les marges ou le format du papier. Cette méthode valide les valeurs de marge et de format de page dans le paramètrepageSettings. Notez que les modifications n'affectent que le rapport actuel dans le contrôle ReportViewer. Elles n'affectent pas son rapport parent, ni les rapports d'extraction auxquels il permet d'accéder.
Le contrôle ReportViewer utilise la propriété pageSettings**.PrinterSettings** pour initialiser la boîte de dialogue Imprimer, mais ne valide pas la propriété pageSettings**.PrinterSettings**. Les paramètres de l'imprimante dans pageSettings**.PrinterSettings** affectent tous les rapports affichés dans le contrôle ReportViewer. Si pageSettings**.PrinterSettings** est nullune référence Null (Nothing dans Visual Basic), les paramètres de l'imprimante existants restent inchangés.
Si le contrôle ReportViewer se trouve en mode Page lorsque cette méthode est appelée, il annule toutes les opérations actuelles de rendu de rapport et rend immédiatement le rapport une nouvelle fois.