PDFlib Cookbook

cookbook

table/spread_text_over_cells

Use the 'continue' option of add_table_cell() to continue a Textflow in another cell.

Download Java Code  Switch to PHP Code  Show Output 

/*
 * Spread text over cells:
 * Spread a Textflow over several cells.
 * 
 * Create a simple table with a Textflow which is spread over several cells. Use
 * the "continuetextflow" option of add_table_cell() for each Textflow cell the
 * Textflow is to be spread over. 
 *
 * 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 spread_text_over_cells
{
    public static void main (String argv[])
    {
        /* This is where the data files are. Adjust as necessary. */
        String searchpath = "../input";
        String outfile = "spread_text_over_cells.pdf";
        String title = "Spread Text over Cells";

        pdflib p = null;
        int font, boldfont, tf = -1, tbl = -1, image;
        int rowheight = 60;
        String result, optlist;
        String imagefile = "kraxi_logo.tif";
        int exitcode = 0;
        
        /* Page width and height */
        int pagewidth = 595, pageheight = 421;
        
        /* 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 = 100, urx = 300, ury = 350;
        
        final String tf_text =
            "Our paper planes are the ideal way of passing the time. We " +
            "offer revolution­ary new develop­ments of the " +
            "trad­itional common paper planes. If your les­son, " +
            "conference, or lect­ure turn out to be deadly boring, you can " +
            "have a wonderful time with our planes. All our models are folded " +
            "from one pap­er sheet. They are exclu­sively folded without " +
            "the use of any adhes­ive. Se­veral mod­els are " +
            "equip­ped with a folded landing gear.";

        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 normal font */
            font = p.load_font("Helvetica", "unicode", "");
            if (font == -1)
                throw new Exception("Error: " + p.get_errmsg());
            
            /* Load bold font */
            boldfont = p.load_font("Helvetica-Bold", "unicode", "");
            if (boldfont == -1)
                throw new Exception("Error: " + p.get_errmsg());
            
            /* Start the page */
            p.begin_page_ext(pagewidth, pageheight, "");
            
            /* Output some descriptive text */
            p.setfont(boldfont, 11);
            p.fit_textline("Use the \"textflow\" option of add_table_cell() ",
                llx, ury + 30, "");
            p.fit_textline("to spread a Textflow over several cells", 
                llx, ury + 15, ""); 
            
            
            /* -----------------
             * Add an image cell
             * -----------------
             * 
             * The image is placed in a cell starting in column 1 row 2. The column
             * width is 90 points. The cell margins are set to 4 points. 
             */
            image = p.load_image("auto", imagefile, "");
            if (image == -1)
                throw new Exception("Error: " + p.get_errmsg());

            optlist = "image=" + image + " colwidth=" + c1 + " margin=4";

            tbl = p.add_table_cell(tbl, 1, 2, "", optlist);
            if (tbl == -1)
                throw new Exception("Error: " + p.get_errmsg());
            
            
            /* Add the Textflow */
            optlist = "font=" + font + " fontsize=8 leading=110% charref"; 
            
            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
             * 
             * Use the "continuetextflow" option to continue the Textflow in further
             * cells.
             * To avoid any space from the top add the Textflow cell use 
             * "fittextflow={firstlinedist=capheight}". Then add a margin of 4 
             * points.
             */
            optlist = "textflow=" + tf + " fittextflow={firstlinedist=capheight} " +
                "colwidth=" + c2 + " rowheight=" + rowheight + 
                " margin=4 continuetextflow";
            
            /* Add the Textflow table cell in column 1 row 1 */
            tbl = p.add_table_cell(tbl, 1, 1, "", optlist);
            if (tbl == -1)
                throw new Exception("Error: " + p.get_errmsg());
            
            /* Continue the Textflow table cell in column 2 row 2 */
            tbl = p.add_table_cell(tbl, 2, 2, "", optlist);
            if (tbl == -1)
                throw new Exception("Error: " + p.get_errmsg());
            
            /* Continue the Textflow table cell in column 1 row 3 */
            tbl = p.add_table_cell(tbl, 1, 3, "", optlist);
            if (tbl == -1)
                throw new Exception("Error: " + p.get_errmsg());
            
            /* Colorize the table cell in column 2 row 1 and column 2 row 3 using a
             * matchbox
             */
            optlist = "matchbox={fillcolor={rgb 0.8 0.8 0.87}}";
            tbl = p.add_table_cell(tbl, 2, 1, "", optlist);
            if (tbl == -1)
                throw new Exception("Error: " + p.get_errmsg());
            
            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, "");
            
            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.toString());
            exitcode = 1;
        } finally {
            if (p != null) {
                p.delete();
            }
            System.exit(exitcode);
        }
    }
}