PDFlib

高度なPDFアプリケーションの開発を支援する定番プログラムライブラリー Supported by インフォテック株式会社

PDFlib サンプル集(クックブック)

本サンプルプログラムは、PDF 文書生成ライブラリーの実装である PDFlib の基本的な機能を実際のプログラムで紹介したものです。

本サイトでダウンロードした PDFlib は、一部機能の制限を除き、評価版として無償でお使いいただけます。

テーブルセル内のテキスト配置位置の調整

テーブルのセル内に配置するテキストの縦方向の配置位置を、各行毎に一定に調整します。

1 つ目のテーブルでは、すべての行でテキストの縦方向の配置位置をセルの中心に設定しています。これは PDF_add_table_cell() の position オプションで指定しています。(その他、セル枠までの距離を各行で同じ (margin = 4) に設定しています)

2 つ目のテーブルでは、大文字の高さを揃えることで縦方向の配置位置を揃えています。これは PDF_add_table_cell() の fontsize オプションの capheight サブオプションで指定することができ、計算後のフォントサイズが適用されます。(日本語の場合では文字毎の高さが等しいため、fontsize として設定した場合と同じになります)。


/*
 * Vertical text alignment:
 * Demonstrate the vertical alignment of text lines and Textflows in a table
 * cell.
 * 
 * Create a simple table with some text lines and a Textflow which are
 * vertically centered in the table cell.
 * Then, create the same table but with all cell contents having the same
 * vertical distance from the cell borders regardless of whether they are
 * Textflows or text lines.
 *
 * Required software: PDFlib/PDFlib+PDI/PPS 9
 * Required data: none
 */
package com.pdflib.cookbook.pdflib.table;

import com.pdflib.pdflib;
import com.pdflib.PDFlibException;

public class vertical_text_alignment
{
    public static void main (String argv[])
    {
    /* This is where the data files are. Adjust as necessary. */
    String searchpath = "../input";
    String outfile = "vertical_text_alignment.pdf";
    String title = "Vertical Text Alignment";

    pdflib p = null;
    int font, tf=-1, tbl=-1;
    String result, optlist;
    int exitcode = 0;
    
    /* Define the column widths of the first and the second column */
    int c1 = 80, c2 = 120;
    
    /* Define the lower left and upper right corners of the table instance.
     * The table width of 200 matches the sum of the widths of the two table
     * columns 80 + 120.
     */
    double llx=100, lly=500, urx=300, ury=600;
    
    /* Text for filling a table cell with multi-line Textflow */
    String tf_text = "It is amazingly robust and can even do aerobatics. " +
             "But it is best suited to gliding.";

    try {
        p = new pdflib();

        p.set_option("searchpath={" + searchpath + "}");

        /* This means we must check return values of load_font() etc. */
        p.set_option("errorpolicy=return");

        if (p.begin_document(outfile, "") == -1)
        throw new Exception("Error: " + p.get_errmsg());

        p.set_info("Creator", "PDFlib Cookbook");
        p.set_info("Title", title);

        /* Load the font */
        font = p.load_font("Helvetica", "unicode", "");
        if (font == -1)
        throw new Exception("Error: " + p.get_errmsg());
        
        /* Start the page */
        p.begin_page_ext(0, 0, "width=a4.width height=a4.height");
        
        
        /* ---------------------------------------------------------
         * Create a simple table with some text lines and a Textflow
         * ---------------------------------------------------------
         */
        
        /* Define the option list for three text line cells placed in the first
         * column. Define a fixed column width of 80 points. The position of the
         * text line with a font size of 8 is in the center on the left with a
         * margin of 4 points.
         */
        optlist = "fittextline={position={left center} font=" + font +
        " fontsize=8} colwidth=" + c1 + " margin=4";

        /* Add a text line cell in column 1 row 1 */
        tbl = p.add_table_cell(tbl, 1, 1, "Our Paper Planes", optlist);
        if (tbl == -1)
        throw new Exception("Error: " + p.get_errmsg());

        /* Add a text line cell in column 1 row 2 */
        tbl = p.add_table_cell(tbl, 1, 2, "Material", optlist);
        if (tbl == -1)
        throw new Exception("Error: " + p.get_errmsg());

        /* Add a text line cell in column 1 row 3 */
        tbl = p.add_table_cell(tbl, 1, 3, "Benefit", optlist);
        if (tbl == -1)
        throw new Exception("Error: " + p.get_errmsg());

        /* Define the option list for a text line placed in the second column.
         * It is similar to the options defined above except of the column width
         * being increased to 120.
         */
        optlist = "fittextline={position={left center} font=" + font +
        " fontsize=8} colwidth=" + c2 + " margin=4";
        
        /* Add a text line cell in column 2 row 2 */
        tbl = p.add_table_cell(tbl, 2, 2, "Offset print paper 220g/sqm",
        optlist);
        if (tbl == -1)
        throw new Exception("Error: " + p.get_errmsg());

        /* Add a Textflow to be placed in a table cell later */
        optlist = "font=" + font + " fontsize=8 leading=110%"; 
        tf = p.add_textflow(-1, tf_text, optlist);
        if (tf == -1)
        throw new Exception("Error: " + p.get_errmsg());

        /* Define the option list for the Textflow cell using the handle
         * retrieved above. The column width for the cell is 120 with a margin 
         * of 4 points.
         */
        optlist = "textflow=" + tf + " margin=4 colwidth=" + c2;

        /* Add the Textflow table cell in column 2 row 3 */
        tbl = p.add_table_cell(tbl, 2, 3, "", optlist);
        if (tbl == -1)
        throw new Exception("Error: " + p.get_errmsg());

        /* Define the option list for fitting the table.
         * 
         * The "stroke" option specifies the table ruling. The 
         * "line=frame linewidth=0.8" suboptions define an outside ruling with a
         * line width of 0.8 and the "line=other linewidth=0.3" suboptions 
         * define a cell ruling with a line width of 0.3.
         */
        optlist = "stroke={{line=frame linewidth=0.8} " +
        "{line=other linewidth=0.3}}";

        /* Place the table instance */
        result = p.fit_table(tbl, llx, lly, urx, ury, optlist);

        /* Check the result; "_stop" means all is ok */
        if (!result.equals("_stop")) {
        if (result.equals( "_error"))
            throw new Exception("Error: " + p.get_errmsg());
        else {
            /* Other return values require dedicated code to deal with */
        }
        }

        /* Delete the table handle. This will also delete any Textflow handles
         * used in the table
         */
        p.delete_table(tbl, "");
        
        
        /* -------------------------------------------------------------------
         * Create the same table but in this case we want all cell contents to
         * have the same vertical distance from the cell borders regardless of
         * whether they are Textflows or text lines.
         * -------------------------------------------------------------------
         */
        
        tbl = -1;
        tf = -1;
        
        /* Prepare the option list for the text line cells placed in the first
         * column.
         *  
         * Define a fixed row height of 14 points, and the position of the text
         * line to be on the top left with a margin of 4 points. 
         * The "fontsize=8" option which has been supplied above doesn't exactly
         * represent the letter height but adds some space below and above.
         * However, the height of an uppercase letter is exactly represented by
         * the capheight value of the font. For this reason use 
         * "fontsize={capheight=6}" which will approximately result in a font
         * size of 8 points and (along with "margin=4"), will sum up to an
         * overall height of 14 points corresponding to the "rowheight" option. 
        */
        optlist = "fittextline={position={left top} font=" + font + 
        " fontsize={capheight=6}} rowheight=14 colwidth=" + c1 +
        " margin=4";
        
        /* Add the text line cells */
        tbl = p.add_table_cell(tbl, 1, 1, "Our Paper Planes", optlist);
        if (tbl == -1)
        throw new Exception("Error: " + p.get_errmsg());

        tbl = p.add_table_cell(tbl, 1, 2, "Material", optlist);
        if (tbl == -1)
        throw new Exception("Error: " + p.get_errmsg());

        tbl = p.add_table_cell(tbl, 1, 3, "Benefit", optlist);
        if (tbl == -1)
        throw new Exception("Error: " + p.get_errmsg());
        
        /* Define the option list for the text line placed in the second 
         * column. It is similar to the options defined above except of the 
         * column width increased to 120.
         */
        optlist = "fittextline={position={left top} font=" + font + 
        " fontsize={capheight=6}} rowheight=14 colwidth=" + c2 +
        " margin=4";

        tbl = p.add_table_cell(tbl, 2, 2, "Offset print paper 220g/sqm",
        optlist);
        if (tbl == -1)
        throw new Exception("Error: " + p.get_errmsg());

        /* Prepare the option list for adding the Textflow.
         * Use "fontsize={capheight=6}" which will approximately result in a
         * font size of 8 points and (along with "margin=4"), will sum up to an
         * overall height of 14 points as for the text lines above.
         */
        optlist = "font=" + font + " fontsize={capheight=6} leading=110%"; 
        
        /* Add the Textflow to be placed in a table cell later */
        tf = p.add_textflow(-1, tf_text, optlist);
        if (tf == -1)
        throw new Exception("Error: " + p.get_errmsg());
        
        /* Prepare the option list for the Textflow cell 
         * 
         * The first line of the Textflow should be aligned with the baseline of
         * the "Benefit" text line. At the same time, the "Benefit" text should
         * have the same distance from the top cell border as the "Material"
         * text. To avoid any space from the top add the Textflow cell using
         * "fittextflow={firstlinedist=capheight}". Then add a margin of 4
         * points, the same as for the text lines.
         */
        optlist = "textflow=" + tf + " fittextflow={firstlinedist=capheight} " +
        "colwidth=" + c2 + " margin=4";
        
        tbl = p.add_table_cell(tbl, 2, 3, "", optlist);
        if (tbl == -1)
            throw new Exception("Error: " + p.get_errmsg());

        /* Define the option list for fitting the table. The "stroke" option
         * specifies the table ruling. The "line=frame linewidth=0.8" suboptions
         * define an outside ruling with a line width of 0.8 and the 
         * "line=other linewidth=0.3" suboptions define a cell ruling with a
         * line width of 0.3.
         */
        optlist = "stroke={{line=frame linewidth=0.8} " +
        "{line=other linewidth=0.3}}";
        
        /* Place the table instance */
        result = p.fit_table(tbl, llx, lly-150, urx, ury-150, optlist);

        if (result.equals("_error"))
            throw new Exception("Error: " + p.get_errmsg());
        p.end_page_ext("");
     
        p.end_document("");

        } catch (PDFlibException e) {
            System.err.println("PDFlib exception occurred:");
            System.err.println("[" + e.get_errnum() + "] " + e.get_apiname() +
                ": " + e.get_errmsg());
        exitcode = 1;
        } catch (Exception e) {
            System.err.println(e);
        exitcode = 1;
        } finally {
            if (p != null) {
                p.delete();
            }
        System.exit(exitcode);
        }
    }
}
(Sep 18, 2013 - May 23, 2019)