報告和引擎對象

FastReport .Net是一款全功能的Windows Forms、ASP.NET和MVC報表分析解決方案，使用FastReport .NET可以創建獨立于應用程序的.NET報表，同時FastReport .Net支持中文、英語等14種語言，可以讓你的產品保證真正的國際性。

FastReport.NET官方版下載

除了報告中包含的對象外，腳本中還定義了兩個變量：報告和引擎。

報告變量指的是當前的報告。在下面的列表中，列出了報告對象的方法：

Engine.PageWidth 和 Engine.PageHeight 屬性決定打印區域的大小，幾乎總是小于頁面的實際大小。打印區域的大小由頁邊距決定，頁邊距由 LeftMargin、TopMargin、RightMargin 和 BottomMargin 頁面屬性給出。

Engine.FreeSpace 屬性決定頁面上可用空間的高度。如果頁面上有 ""Report footer" "帶，則在計算 FreeSpace 時會考慮其高度。請注意，打印頁邊框后，可用空間會減少。

如何形成準備好的報告頁面？

FastReport 引擎在頁面上顯示條帶，直到有足夠的空間進行條帶輸出。當沒有可用空間時，將打印 "報告頁腳 "條帶并形成新的空頁。顯示條帶從當前位置開始，當前位置由 X 和 Y 坐標決定。該位置由 Engine.CurX 和 Engine.CurY 屬性重新調整。打印帶狀圖后，CurY 會自動按打印帶狀圖的高度增加。打印多欄報表時，CurX 的位置會發生變化。

Engine.CurX 和 Engine.CurY 屬性不僅可用于讀取，也可用于寫入。這意味著您可以通過使用一個合適的事件來手動移動條帶。使用這些屬性的示例請參見 "示例 "部分。

在使用返回尺寸或位置的屬性時，請記住這些屬性是以屏幕像素為單位的。

通過使用 AddOutline、OutlineRoot 和 OutlineUp 方法，可以手動創建報告大綱。通常，這都是借助 OutlineExpression 屬性自動完成的，每個波段和報表頁面都有 OutlineExpression 屬性。

AddOutline 方法為當前大綱元素添加一個子元素，并使其成為當前元素。當前的報告頁面和頁面上的當前位置都與新元素相關聯。如果多次調用 AddOutline 方法，就會產生如下結構：

Item1
    Item2
        Item3

為了控制當前元素，有 OutlineUp 和 OutlineRoot 方法。第一個方法將指針移到位于更高層的元素上。因此，腳本:

Engine.AddOutline("Item1");
Engine.AddOutline("Item2");
Engine.AddOutline("Item3");
Engine.OutlineUp();
Engine.AddOutline("Item4");

Item1
    Item2
        Item3
        Item4

Engine.AddOutline("Item1");
Engine.AddOutline("Item2");
Engine.AddOutline("Item3");
Engine.OutlineRoot();
Engine.AddOutline("Item4");

將創建以下大綱：

Item1
    Item2
        Item3
Item4

在處理書簽時，需要使用引擎對象的 AddBookmark 和 GetBookmarkPage 方法。通常，書簽會在使用書簽屬性時自動添加，報告的所有對象都有該屬性。

通過使用 Add Bookmark 方法，可以以編程方式添加書簽。該方法會在當前頁面的當前打印位置創建一個書簽。

GetBookmarkPage 方法會返回書簽所在的頁碼。該方法通常用于創建目錄，以顯示頁碼。在這種情況下，報告必須有雙通道。