1 /* 2 * $Id: PDFAction.java,v 1.4.2.1 2003/02/25 14:29:37 jeremias Exp $ 3 * ============================================================================ 4 * The Apache Software License, Version 1.1 5 * ============================================================================ 6 * 7 * Copyright (C) 1999-2003 The Apache Software Foundation. All rights reserved. 8 * 9 * Redistribution and use in source and binary forms, with or without modifica- 10 * tion, are permitted provided that the following conditions are met: 11 * 12 * 1. Redistributions of source code must retain the above copyright notice, 13 * this list of conditions and the following disclaimer. 14 * 15 * 2. Redistributions in binary form must reproduce the above copyright notice, 16 * this list of conditions and the following disclaimer in the documentation 17 * and/or other materials provided with the distribution. 18 * 19 * 3. The end-user documentation included with the redistribution, if any, must 20 * include the following acknowledgment: "This product includes software 21 * developed by the Apache Software Foundation (http://www.apache.org/)." 22 * Alternately, this acknowledgment may appear in the software itself, if 23 * and wherever such third-party acknowledgments normally appear. 24 * 25 * 4. The names "FOP" and "Apache Software Foundation" must not be used to 26 * endorse or promote products derived from this software without prior 27 * written permission. For written permission, please contact 28 * apache@apache.org. 29 * 30 * 5. Products derived from this software may not be called "Apache", nor may 31 * "Apache" appear in their name, without prior written permission of the 32 * Apache Software Foundation. 33 * 34 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, 35 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND 36 * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 37 * APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, 38 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLU- 39 * DING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS 40 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON 41 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 42 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 43 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 44 * ============================================================================ 45 * 46 * This software consists of voluntary contributions made by many individuals 47 * on behalf of the Apache Software Foundation and was originally created by 48 * James Tauber <jtauber@jtauber.com>. For more information on the Apache 49 * Software Foundation, please see <http://www.apache.org/>. 50 */ 51 package org.apache.fop.pdf; 52 53 /** 54 * class representing an action object. 55 */ 56 public abstract class PDFAction extends PDFObject { 57 58 59 /** 60 * create an Action object. 61 * this constructor is used for passing on the object number to the PDFObject 62 * 63 * @param number the object's number 64 */ 65 public PDFAction(int number) { 66 67 /* generic creation of object */ 68 super(number); 69 } 70 71 /** 72 * empty constructor for PDFAction. 73 * this constructor is used when there is no additional object being created 74 * 75 */ 76 public PDFAction() {} 77 78 /** 79 * represent the action to call 80 * this method should be implemented to return the action which gets 81 * called by the Link Object. This could be a reference to another object 82 * or the specific destination of the link 83 * 84 * @return the action to place next to /A within a Link 85 */ 86 public abstract String getAction(); 87 88 89 /** 90 * represent the object in PDF 91 * this method should be implemented to return the PDF which is to be 92 * generated by the Action object 93 * 94 * @return the PDF string 95 */ 96 public abstract byte[] toPDF(); 97 98 } 99