FastReport的報表生成器（無論VCL平臺還是.NET平臺），跨平臺的多語言腳本引擎FastScript，桌面OLAP FastCube，如今都被世界各地的開發者所認可，這些名字被等價于“速度”、“可靠”和“品質”,在美國，歐洲和非洲不同國家均設有辦事處。FastReports網站有10種不同語言的介紹，FastReports報表擁有40種語言的本地化的信息。

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

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

OutlineRoot 方法會將當前元素移動到大綱的根部。例如，下面的腳本:

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

將創建以下大綱：

Item1 Item2 Item3 Item4

引用系統變量

要引用系統變量，請使用報告對象的 GetVariableValue 方法：

DateTime date = (DateTime)Report.GetVariableValue("Date");

在 "Data "窗口中可以看到系統變量列表。您可以將變量拖入腳本中，FastReport 會自動創建用于引用變量的代碼。

引用總值

要引用總值，請使用報告對象的 GetTotalValue 方法：

float sales = Report.GetTotalValue("TotalSales");

總計值具有 FastReport.Variant 類型。It can be directly in any expression, because the FastReport.Variant type is automatically converted to any type.例如

float tax = Report.GetTotalValue("TotalSales") * 0.2f;

在處理過程中，可以參考總值。通常情況下，總值在打印帶子的那一刻就 "ready to use"。

引用報告參數

要引用報告參數，請使用報告對象的 GetParameterValue 方法：

參數可以嵌套。在這種情況下，請標出父參數的名稱，并在句號后標出子參數的名稱：

Report.GetParameterValue("ParentParameter.ChildParameter")

要更改參數值，請使用報告對象的 SetParameterValue 方法：

Report.SetParameterValue("MyParameter", 10);

本次關于 FastReport .Net 介紹就講解到這里了，點擊此處查看關于用戶指南的更多內容。如果您想獲取更多產品試用/授權/價格信息，請點擊FastReport .Net了解，或者點擊咨詢。

FastReport技術QQ群：585577353      歡迎進群一起討論