使用 HTMLDocument 來建立 XSL FO 資料

產生的 XSL FO 來源會遵循 XSL FO 格式化模型。此模型使用一些稱為「區域 (area)」 的矩形元素來保留個別的內容元素，這些元素可能是影像、文字、其他 XSL FO 或什麼都不是。下列清單說明四種基本區域：

• 範圍 (Region) 的作用相當於最高層次的儲存器。
• 區塊區域代表區塊層次元素，如段落或清單項目等。
• 行區域代表區塊內的一行文字。
• 內含區域代表一行的某些部分，如單一字元、註腳或數學方程式等。

IBM® Toolbox for Java™ 建立的 XSL FO 標籤會遵循 W3C 建議事項中說明的 XSL 標準。有關 XSL、XSL FOs 和 W3C 建議事項的資訊，請參閱下列內容：

可延伸樣式表語言 (XSL) 1.0 版

產生 XSL FO 來源資料

建立 XSL FO 來源時，HTMLDocument 內容代表可指定頁面大小、 方向和邊距的 XSL FO 標籤。此外，HTMLDocument 還會從許多 HTML 類別中擷取該內容元素的對應 XSL FO 標籤。

使用 HTMLDocument 產生 XSL FO 來源之後，您可以使用 XSL 格式製作程式（如 XSLReportWriter 類別）， 將內容元素放置於文件的頁面中。

HTMLDocument 會在兩個主要區段中產生 XSL FO 來源資料：

• 第一個區段包含 <fo:root> 和 <fo:layout-master-set> XSL FO 標籤，其中包含關於頁面高度、頁面寬度和頁面邊距的一般頁面佈置資訊。 若要指定佈置資訊的值， 請使用 HTMLDocument set 方法來設定相關內容的值。
• 第二個區段包含 XSL FO <fo:page-sequence> 標籤，其中包含個別的內容元素。 若要指定屬於 HTML 類別實例的個別內容元素， 請從 HTML 物件中擷取對應的 XSL FO 標籤。請務必留意，就內容元素而言，您只能使用具有 getFoTag() 方法的 HTML 類別。
  註： 嘗試從沒有 getFoTag() 方法的 HTML 類別中擷取 XSL FO 標籤， 將會造成註解標籤。

針對含有 XSL FO 標籤使用方法的 HTML 類別，如需相關資訊，請參閱下面的 Javadoc 參考文件：

可使用 XSL FO 的類別

建立 HTMLDocument 實例並設定佈置內容之後， 請使用 setUseFO()、getFoTag() 和 getTag() 等方法，從 HTML 物件中擷取 XSL FO 標籤。

• 您可以在 HTMLDocument 或個別的 HTML 物件中使用 setUseFO()。使用 setUseFO() 時，您可以使用 HTMLDocument.getTag() 來擷取 XSL FO 標籤。
• 此外，您還可以在 HTMLDocument 或個別的 HTML 物件中使用 getFoTag() 方法。若您必須從 HTMLDocument 或 HTML 物件中產生 XSL FO 和 HTML 來源時，您可以使用這項替代方法。

範例：使用 HTMLDocument

建立 XSL FO 來源資料後， 您必須將該 XSL FO 資料轉換成使用者可以檢視及列印的形式。下列範例說明如何產生 XSL FO 來源資料（和 HTML 來源）， 然後使用 XSLReportWriter 和 Context 類別將 XSL FO 來源資料轉換成 PDF 文件：

範例：使用 HTMLDocument 來同時產生 HTML 來源和 XSL FO 來源

範例：將 XSL FO 來源資料轉換成 PDF

Javadoc 參考文件

有關 HTMLDocument 類別的資訊，請參閱下列 Javadoc 參考文件：

HTMLDocument

下列免責聲明適用於所有的 IBM Toolbox for Java 範例：

程式碼範例免責聲明

IBM 授予您使用所有程式設計程式碼範例的非專屬授權，您可以依據這些範例產生類似的功能，來符合您的特定需要。

IBM 提供的所有範例程式碼僅供說明之用。這些範例尚未徹底經過所有情況的測試。因此，IBM 不擔保或默示這些程式的可靠性、服務性或功能。

所有內含於此的程式是以「現況」提供給您，不具任何形式的擔保。IBM 明示排除有關這些程式的不侵權、可售性、符合特定使用目的之默示擔保。