Report printable components

Chapter 7

Report system

7.5 報表元件 (report printable components)

通用報表元件(Generic printable component)

圖片報表元件(Image printable component)

備忘錄報表元件(Memo printable component)

統計圖報表元件(Statistic printable component)

條碼報表元件(Barcode printable component)

跳頁報表元件(Page break component)

共同屬性設定頁 (common properties)

　
- 位置 (location)：
  
  　
  - 位置(點) (location dot)：元件的位置及大小，由像素點來表示。
    　
  - 位置(英吋) (location inch)：元件的位置及大小，由英吋來表示。
    　
  - 墊充 (點) (inset dot)：元件內緣墊充，以像素點來表示。
    
    　
  - Clip Bounds：當列印資料內容超過範圍 (寬、高)，裁割掉超過的部分。
    
    　
  - Freeze Bounds：此元件大小尺寸，不列入表身 (content) 單筆資料記錄總高度的計算，當元件置於表身 (content) 列印時，只列印一次，不隨資料記錄移動而逐筆列印，適用於浮水印或格式化的報表。

框線 (frame)

　
- 線寬 (line width)：框線寬度，以浮點數值 (float) 設定，單位為 1/72 inch。
  　
- 左 (left)：左邊界框線。
- 左弧 (left )：左弧框線。
- 上 (top)：上邊界框線。
- 上弧 (top)：上弧框線。
- 右 (right)：右邊界框線。
- 右弧 (right)：右弧框線。
- 下 (bottom)：下邊界框線。
- 下弧 (bottom)：下弧框線。
  　
- 水平中心線 (horizontal center)：列印出水平線。
- 垂直中心線 (vertical Center)：列印出垂直線。
  　
- 左上右下對角線 (left_top -- right_bottom)：列印出左上到右下的框線。
- 右上左下對角線 (right_top -- left_bottom)：列印出右上到左下的框線。
  　
- 內切橢圓 (oval)：橢圓形框線。
  　
- 實線 (solid line)
- 虛線 (dash line)
  
  　
  - 虛線段長 (dash segment)：以浮點數值 (float) 設定，單位為 1/72 inch。
  - 虛線間隔 (space segment)：以浮點數值 (float) 設定，單位為 1/72 inch。

字型 (font)

　
- 字型 (font)：選擇字型
- 大小 (size)：選擇字型大小。
- 樣式 (style)：
  
  　
  - 粗體 (bold)
  - 斜體 (italic)
    
    　
- 顏色 (color)：
  
  　
  - 前景顏色 (foreground)
  - 背景顏色 (background)
    　
- 旋轉 (rotate)：將字型旋轉列印 (0 -- 360)。水平順時鐘為正值。
  
  　
可列印 (printable)：動態的以條件運算公式 (formula) 的結果決定是否列印資料。

　
- 列印限制 (print out constraint)：使用條件運算公式 (formula) 來控制列印與否。
  　
  - 條件 (condition)：依條件運算公式 (formula) 的結果決定是否列印此元件。
    　
- 換頁即強迫列印 (force to print while first record in new page)：忽略條件運算公式 (formula) 的結果，每一頁的第一筆記錄都會列印。

▲Top

通用報表元件 (Generic printable component )

共同屬性 (common properties)
　
內容 (content)

　
- 純文字 (simple text)：使用文字敘述當成要列印的內容。
  
  　
  - 頁碼 (page no)：列印頁碼。
    　
  - 當前 (current page no)：列印當頁的頁碼。
    　
  - 全部 (預估值) (total pages estimate)：由於 jLIVE Builder™ 報表系統提供強迫換頁及基於運算條件才列印的機制，所以實際的總頁數在某些情況下並不相等於預估總頁數。
    
    　
- 使用運算式 (use formula)：使用運算公式 (formula) 的結果值來列印。
  　
- Html 內容 (html content) ：運算式內容為 HTML 格式。允許以 HTML tag 格式化列印資料。
  　
- 加總 (sum result)：如果運算公式 (formula) 的結果值是數值資料，可以運用元件內部的加總功能，累計加總列印。
  　
  - 平均值 (average)：運用元件內部的加總功能，累計加總後列印平均值。
    　
- 歸零 (reset to zero)：元件內部的加總功能，歸零的時機。
  
  　
  - 永不 (never)：累計加總，不歸零。(例如：全部列印資料的"金額總計")
    　
  - 列印後 (after printout)：當列印之後歸零。(例如：列印單筆訂單的"金額小計")
    　
  - 換頁 (new page)：當換頁之後歸零。(例如：列印單一頁次的"金額小計")

列印格式 (format)

　
- 格式 (format printout)：設定列印資料的資料型態及列印格式。
  　
- Render 類別 (render type)：將資料格式化為 Render 型式。
  　
- 格式 (format)：顯示格式樣板 (format pattern)。
  　
- 對齊列印 (alignment printout)：
  
  　
  - 水平 (horizontal)：水平對齊方式。
    　
  - 垂直 (vertical)：垂直對齊方式。
    
    　
- 自動轉折 (multi line )：當文字資料比顯示的範圍方塊區間還長時，自動轉折至下行。
  
  　
- 行距 (row gap)：橫向列印每行間距，中文直式列印每列間距。
  　
- 中文直排字距 (vertical character gap)：中文直式列印，每直式列印單元間距。
  　
- 中文直排 (由右到左) (Chinese vertical layout -- right to left)
  
  　
  - 中文直排 -- 英數字元間隔 (break) 方式：中文直式列印，由橫式資料轉為直式列印單元時資料擷取間隔 (break) 方式。
    
    　
    - 字元間隔 (character break)：以字元為單元轉印為直式，不論中文或英數字皆為一個直式列印單元，每個單元定寬定高。
      　
    - 字元間隔 ASCII 字元翻轉 (character break and ASCII rotate)：以字元為單元轉印為直式，不論中文或英數字皆為一個直式列印單元，每個單元定寬定高。單元字元 (character) 為 ASCII 字元時，順時鐘旋轉九十度。
      　
    - 英文(數)字間隔 (English word break)：以英文字 (word) 及一中文字為單元轉印為直式，英文字 (word) 橫式列印，每個單元按所需寬度及高度列印，所有資料中的ASCII 空白 (space) 自動忽略不列印。
      　
    - 英文(數)字間隔且翻轉 (English word break and rotate)：以英文字 (word) 及一中文字為單元轉印為直式，英文字 (word) 順時鐘旋轉九十度，每個單元按所需高度列印。

▲Top

圖片報表元件 (Image printable component)

共同屬性 (common properties)

　
圖片 (Image)：選擇資料來源的資料欄位內含值，或是靜態圖片檔，作為圖檔來源。資料來源的資料欄位內含值， jLIVE Builder™ 會以欄位型別(data field type) ，自動判斷其內含值是二進位的圖檔資料 (LONGVARBINARY)，亦或是圖片檔路徑名稱 (VARCHAR 、 CHAR) 。若資料欄位內含值是二進位的圖檔資料 (LONGVARBINARY)， jLIVE Builder™ 支援內含 JPG 格式資料。若資料欄位內含值是圖檔路徑(VARCHAR 、 CHAR) 名稱，則支援 JPG 及 GIF。

　
- 資料來源 (data source)：選擇資料來源。
  　
- 資料欄位 (data field)：選擇資料欄位。
  　
- ImageScale (image scale)：當圖檔實際大小大於列印元件範圍時，系統將以何種演算法將圖檔按比例列印於元件範圍內。特別在於將圖檔當成 freeze bound 的浮水印或圖檔上擺設其他列印元件時，當圖檔輸出至印表機時，圖檔縮放的演算法會影響擺設於圖檔上的其他列印元件輸出，請按圖檔及印表機型別選擇適當演算法。
  　
  - SCALE_DEFAULT：使用預設 default image-scaling 演算法。
  - SCALE_FAST：Choose an image-scaling algorithm that gives higher priority to scaling speed than smoothness of the scaled image。
  - SCALE_SMOOTH：Choose an image-scaling algorithm that gives higher priority to image smoothness than scaling speed。
  - SCALE_REPLICATE：Use the image scaling algorithm embodied in the ReplicateScaleFilter class。
  - SCALE_AREA_AVERAGING：Use the Area Averaging image scaling algorithm。
    　
- 靜態圖片 (static image)：是否要使用圖檔 (image file) 列印。

▲Top

備忘錄報表元件 (Memo printable component)

共同屬性 (common properties)
　
備忘錄 (Memo)：選擇資料來源的資料欄位內含值，或使用靜態檔案。使用靜態檔案，必須放在相對路徑的..\class\doc 下。資料來源的資料欄位內含值， jLIVE Builder™ 會以欄位型別(data field type) 自動判斷其內含值，是檔案 (LONGVARCHAR) 資料或是檔案路徑(VARCHAR 、 CHAR)名稱。jLIVE Builder™ 支援 TXT、RTF、HTML 格式資料檔。

　
- 資料來源 (data source)：選擇資料來源。
  　
- 資料欄位 (data field)：選擇資料欄位。
  　
- 靜態檔案 (static file)：選擇檔案，目前支援 TXT 、RTF 與 HTML 等資料格式的檔案。