Partilhar via


Método ReportViewer.SetPageSettings

Define as configurações de página que são usadas para imprimir o relatório atual no controle ReportViewer ou exibi-lo no modo de layout de impressão.

Namespace:  Microsoft.Reporting.WinForms
Assembly:  Microsoft.ReportViewer.WinForms (em Microsoft.ReportViewer.WinForms.dll)

Sintaxe

'Declaração
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
)

Parâmetros

  • pageSettings
    Tipo: PageSettings
    Um objeto PageSettings que contém as novas configurações de página.
    Esse parâmetro não deve ser nulluma referência nula (Nothing no Visual Basic).

Comentários

Por padrão, o controle ReportViewer usa as configurações de página especificadas na definição de relatório ao imprimir o relatório atual ou exibi-lo no modo de layout de impressão.Use esse método para modificar as configurações de página para o relatório atual (não a página atual), como margens ou tamanho de papel.Esse método valida os valores de margem e de tamanho de página no parâmetro pageSettings.Observe que a alteração somente afeta o relatório atual no controle ReportViewer e não afeta o relatório pai ou os relatórios de detalhamento acessíveis a partir deles.

O controle ReportViewer usa a propriedade pageSettings**.PrinterSettings** para inicializar a caixa de diálogo Imprimir, mas não valida a propriedade pageSettings**.PrinterSettings**.As configurações da impressora no pageSettings**.PrinterSettings** afetam todos os relatórios exibidos no controle ReportViewer.Se o pageSettings**.PrinterSettings** for nulluma referência nula (Nothing no Visual Basic), as configurações existentes da impressora permanecerão inalteradas.

Se o controle ReportViewer estiver no modo de layout de impressão quando esse método for chamado, ele cancelará a operação de renderização de relatório em execução no momento e renderizará o relatório imediatamente.

Consulte também

Referência

ReportViewer Classe

Namespace Microsoft.Reporting.WinForms