ReportViewer.SetPageSettings 方法
設定用來列印 ReportViewer 控制項中之目前報表或以整頁模式顯示此報表的頁面設定。
命名空間： Microsoft.Reporting.WinForms
組件： Microsoft.ReportViewer.WinForms (在 Microsoft.ReportViewer.WinForms.dll 中)
語法
'宣告
Public Sub SetPageSettings ( _
pageSettings As PageSettings _
)
'用途
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
)
參數
- pageSettings
型別：System.Drawing.Printing.PageSettings
包含新頁面設定的 PageSettings 物件。
此參數不得為 nullnull 參考 (在 Visual Basic 中為 Nothing)。
備註
根據預設，當列印目前報表或以整頁模式顯示此報表時，ReportViewer 控制項會使用報表定義中指定的頁面設定。請使用這個方法變更目前報表 (而不是目前頁面) 的頁面設定，例如邊界或頁面大小。這個方法會驗證 pageSettings 參數中的邊界和頁面大小值。請注意，變更只會影響 ReportViewer 控制項中的目前報表，並不會影響其父報表或可從目前報表存取的鑽研報表。
ReportViewer 控制項會使用 pageSettings**.PrinterSettings** 屬性初始化 [列印] 對話方塊，但不會驗證 pageSettings**.PrinterSettings** 屬性。pageSettings**.PrinterSettings** 中的印表機設定會影響 ReportViewer 控制項中顯示的所有報表。如果 pageSettings**.PrinterSettings** 為 nullnull 參考 (在 Visual Basic 中為 Nothing)，現有的印表機設定會保持不變。
如果在呼叫這個方法時 ReportViewer 控制項為整頁模式，則會取消任何目前執行中的報表轉譯作業並立即重新轉譯報表。