001: /**
002: * Copyright (c) 2004, www.pdfbox.org
003: * All rights reserved.
004: *
005: * Redistribution and use in source and binary forms, with or without
006: * modification, are permitted provided that the following conditions are met:
007: *
008: * 1. Redistributions of source code must retain the above copyright notice,
009: * this list of conditions and the following disclaimer.
010: * 2. Redistributions in binary form must reproduce the above copyright notice,
011: * this list of conditions and the following disclaimer in the documentation
012: * and/or other materials provided with the distribution.
013: * 3. Neither the name of pdfbox; nor the names of its
014: * contributors may be used to endorse or promote products derived from this
015: * software without specific prior written permission.
016: *
017: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
018: * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
019: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
020: * DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY
021: * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
022: * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
023: * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
024: * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
025: * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
026: * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
027: *
028: * http://www.pdfbox.org
029: *
030: */package org.pdfbox.pdmodel.interactive.action;
031:
032: import org.pdfbox.cos.COSBase;
033: import org.pdfbox.cos.COSDictionary;
034:
035: import org.pdfbox.pdmodel.common.COSObjectable;
036: import org.pdfbox.pdmodel.interactive.action.type.PDAction;
037:
038: /**
039: * This class represents a page object's dictionary of actions
040: * that occur due to events.
041: *
042: * @author <a href="mailto:ben@benlitchfield.com">Ben Litchfield</a>
043: * @author Panagiotis Toumasis (ptoumasis@mail.gr)
044: * @version $Revision: 1.2 $
045: */
046: public class PDPageAdditionalActions implements COSObjectable {
047: private COSDictionary actions;
048:
049: /**
050: * Default constructor.
051: */
052: public PDPageAdditionalActions() {
053: actions = new COSDictionary();
054: }
055:
056: /**
057: * Constructor.
058: *
059: * @param a The action dictionary.
060: */
061: public PDPageAdditionalActions(COSDictionary a) {
062: actions = a;
063: }
064:
065: /**
066: * Convert this standard java object to a COS object.
067: *
068: * @return The cos object that matches this Java object.
069: */
070: public COSBase getCOSObject() {
071: return actions;
072: }
073:
074: /**
075: * Convert this standard java object to a COS object.
076: *
077: * @return The cos object that matches this Java object.
078: */
079: public COSDictionary getCOSDictionary() {
080: return actions;
081: }
082:
083: /**
084: * This will get an action to be performed when the page
085: * is opened. This action is independent of any that may be
086: * defined by the OpenAction entry in the document catalog,
087: * and is executed after such an action.
088: *
089: * @return The O entry of page object's additional actions dictionary.
090: */
091: public PDAction getO() {
092: COSDictionary o = (COSDictionary) actions
093: .getDictionaryObject("O");
094: PDAction retval = null;
095: if (o != null) {
096: retval = PDActionFactory.createAction(o);
097: }
098: return retval;
099: }
100:
101: /**
102: * This will set an action to be performed when the page
103: * is opened. This action is independent of any that may be
104: * defined by the OpenAction entry in the document catalog,
105: * and is executed after such an action.
106: *
107: * @param o The action to be performed.
108: */
109: public void setO(PDAction o) {
110: actions.setItem("O", o);
111: }
112:
113: /**
114: * This will get an action to be performed when the page
115: * is closed. This action applies to the page being closed,
116: * and is executed before any other page opened.
117: *
118: * @return The C entry of page object's additional actions dictionary.
119: */
120: public PDAction getC() {
121: COSDictionary c = (COSDictionary) actions
122: .getDictionaryObject("C");
123: PDAction retval = null;
124: if (c != null) {
125: retval = PDActionFactory.createAction(c);
126: }
127: return retval;
128: }
129:
130: /**
131: * This will set an action to be performed when the page
132: * is closed. This action applies to the page being closed,
133: * and is executed before any other page opened.
134: *
135: * @param c The action to be performed.
136: */
137: public void setC(PDAction c) {
138: actions.setItem("C", c);
139: }
140: }
|