ReportViewer.SetPageSettings 方法 (PageSettings)

  • 發行項

 

發佈時間: 2016年4月

設定用來列印 ReportViewer 控制項中之目前報表或以整頁模式顯示此報表的頁面設定。

命名空間:   Microsoft.Reporting.WinForms
組件:  Microsoft.ReportViewer.WinForms (在 Microsoft.ReportViewer.WinForms.dll 中)

語法

public void SetPageSettings(
    PageSettings pageSettings
)

public:
void SetPageSettings(
    PageSettings^ pageSettings
)

member SetPageSettings : 
        pageSettings:PageSettings -> unit

Public Sub SetPageSettings (
    pageSettings As PageSettings
)

參數

  • pageSettings
    包含新頁面設定的 PageSettings 物件。

    此參數不得為 null。

備註

根據預設，當列印目前報表或以整頁模式顯示此報表時，ReportViewer 控制項會使用報表定義中指定的頁面設定。請使用這個方法變更目前報表 (而不是目前頁面) 的頁面設定，例如邊界或頁面大小。這個方法會驗證 pageSettings 參數中的邊界和頁面大小值。請注意，變更只會影響 ReportViewer 控制項中的目前報表，並不會影響其父報表或可從目前報表存取的鑽研報表。

[ReportViewer] 控制項會使用 pageSettings**.PrinterSettings** 屬性以初始化 [列印] 對話方塊，但不會驗證 pageSettings**.PrinterSettings** 屬性。pageSettings**.PrinterSettings** 中的印表機設定會影響 [ReportViewer] 控制項中顯示的所有報表。如果 pageSettings**.PrinterSettings** 為 null，則現有的印表機設定會保持不變。

如果在呼叫這個方法時 ReportViewer 控制項為整頁模式，則會取消任何目前執行中的報表轉譯作業並立即重新轉譯報表。

請參閱

ReportViewer 類別
Microsoft.Reporting.WinForms 命名空間

回到頁首