1 | /* | |
2 | * $Id: PdfStructureElement.java 4065 2009-09-16 23:09:11Z psoares33 $ | |
3 | * | |
4 | * Copyright 2005 by Paulo Soares. | |
5 | * | |
6 | * The contents of this file are subject to the Mozilla Public License Version 1.1 | |
7 | * (the "License"); you may not use this file except in compliance with the License. | |
8 | * You may obtain a copy of the License at http://www.mozilla.org/MPL/ | |
9 | * | |
10 | * Software distributed under the License is distributed on an "AS IS" basis, | |
11 | * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License | |
12 | * for the specific language governing rights and limitations under the License. | |
13 | * | |
14 | * The Original Code is 'iText, a free JAVA-PDF library'. | |
15 | * | |
16 | * The Initial Developer of the Original Code is Bruno Lowagie. Portions created by | |
17 | * the Initial Developer are Copyright (C) 1999, 2000, 2001, 2002 by Bruno Lowagie. | |
18 | * All Rights Reserved. | |
19 | * Co-Developer of the code is Paulo Soares. Portions created by the Co-Developer | |
20 | * are Copyright (C) 2000, 2001, 2002 by Paulo Soares. All Rights Reserved. | |
21 | * | |
22 | * Contributor(s): all the names of the contributors are added in the source code | |
23 | * where applicable. | |
24 | * | |
25 | * Alternatively, the contents of this file may be used under the terms of the | |
26 | * LGPL license (the "GNU LIBRARY GENERAL PUBLIC LICENSE"), in which case the | |
27 | * provisions of LGPL are applicable instead of those above. If you wish to | |
28 | * allow use of your version of this file only under the terms of the LGPL | |
29 | * License and not to allow others to use your version of this file under | |
30 | * the MPL, indicate your decision by deleting the provisions above and | |
31 | * replace them with the notice and other provisions required by the LGPL. | |
32 | * If you do not delete the provisions above, a recipient may use your version | |
33 | * of this file under either the MPL or the GNU LIBRARY GENERAL PUBLIC LICENSE. | |
34 | * | |
35 | * This library is free software; you can redistribute it and/or modify it | |
36 | * under the terms of the MPL as stated above or under the terms of the GNU | |
37 | * Library General Public License as published by the Free Software Foundation; | |
38 | * either version 2 of the License, or any later version. | |
39 | * | |
40 | * This library is distributed in the hope that it will be useful, but WITHOUT | |
41 | * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS | |
42 | * FOR A PARTICULAR PURPOSE. See the GNU Library general Public License for more | |
43 | * details. | |
44 | * | |
45 | * If you didn't download this code from the following link, you should check if | |
46 | * you aren't using an obsolete version: | |
47 | * http://www.lowagie.com/iText/ | |
48 | */ | |
49 | ||
50 | package com.lowagie.text.pdf; | |
51 | ||
52 | import com.lowagie.text.error_messages.MessageLocalization; | |
53 | ||
54 | /** | |
55 | * This is a node in a document logical structure. It may contain a mark point or it may contain | |
56 | * other nodes. | |
57 | * @author Paulo Soares (psoares@consiste.pt) | |
58 | */ | |
59 | public class PdfStructureElement extends PdfDictionary { | |
60 | | |
61 | /** | |
62 | * Holds value of property kids. | |
63 | */ | |
64 | private PdfStructureElement parent; | |
65 | private PdfStructureTreeRoot top; | |
66 | | |
67 | /** | |
68 | * Holds value of property reference. | |
69 | */ | |
70 | private PdfIndirectReference reference; | |
71 | | |
72 | /** | |
73 | * Creates a new instance of PdfStructureElement. | |
74 | * @param parent the parent of this node | |
75 | * @param structureType the type of structure. It may be a standard type or a user type mapped by the role map | |
76 | */ | |
77 | public PdfStructureElement(PdfStructureElement parent, PdfName structureType) { | |
78 | top = parent.top; | |
79 |
1
1. |
init(parent, structureType); |
80 | this.parent = parent; | |
81 |
1
1. |
put(PdfName.P, parent.reference); |
82 | } | |
83 | | |
84 | /** | |
85 | * Creates a new instance of PdfStructureElement. | |
86 | * @param parent the parent of this node | |
87 | * @param structureType the type of structure. It may be a standard type or a user type mapped by the role map | |
88 | */ | |
89 | public PdfStructureElement(PdfStructureTreeRoot parent, PdfName structureType) { | |
90 | top = parent; | |
91 |
1
1. |
init(parent, structureType); |
92 |
1
1. |
put(PdfName.P, parent.getReference()); |
93 | } | |
94 | | |
95 | private void init(PdfDictionary parent, PdfName structureType) { | |
96 | PdfObject kido = parent.get(PdfName.K); | |
97 | PdfArray kids = null; | |
98 |
2
1. init : negated conditional → NO_COVERAGE 2. init : negated conditional → NO_COVERAGE |
if (kido != null && !kido.isArray()) |
99 | throw new IllegalArgumentException(MessageLocalization.getComposedMessage("the.parent.has.already.another.function")); | |
100 |
1
1. init : negated conditional → NO_COVERAGE |
if (kido == null) { |
101 | kids = new PdfArray(); | |
102 |
1
1. init : removed call to com/lowagie/text/pdf/PdfDictionary::put → NO_COVERAGE |
parent.put(PdfName.K, kids); |
103 | } | |
104 | else | |
105 | kids = (PdfArray)kido; | |
106 | kids.add(this); | |
107 |
1
1. init : removed call to com/lowagie/text/pdf/PdfStructureElement::put → NO_COVERAGE |
put(PdfName.S, structureType); |
108 | reference = top.getWriter().getPdfIndirectReference(); | |
109 | } | |
110 | | |
111 | /** | |
112 | * Gets the parent of this node. | |
113 | * @return the parent of this node | |
114 | */ | |
115 | public PdfDictionary getParent() { | |
116 | return parent; | |
117 | } | |
118 | | |
119 | void setPageMark(int page, int mark) { | |
120 |
2
1. setPageMark : changed conditional boundary → NO_COVERAGE 2. setPageMark : negated conditional → NO_COVERAGE |
if (mark >= 0) |
121 |
1
1. setPageMark : removed call to com/lowagie/text/pdf/PdfStructureElement::put → NO_COVERAGE |
put(PdfName.K, new PdfNumber(mark)); |
122 |
1
1. setPageMark : removed call to com/lowagie/text/pdf/PdfStructureTreeRoot::setPageMark → NO_COVERAGE |
top.setPageMark(page, reference); |
123 | } | |
124 | | |
125 | /** | |
126 | * Gets the reference this object will be written to. | |
127 | * @return the reference this object will be written to | |
128 | * @since 2.1.6 method removed in 2.1.5, but restored in 2.1.6 | |
129 | */ | |
130 | public PdfIndirectReference getReference() { | |
131 | return this.reference; | |
132 | } | |
133 | } | |
Mutations | ||
79 |
1.1 |
|
81 |
1.1 |
|
91 |
1.1 |
|
92 |
1.1 |
|
98 |
1.1 2.2 |
|
100 |
1.1 |
|
102 |
1.1 |
|
107 |
1.1 |
|
120 |
1.1 2.2 |
|
121 |
1.1 |
|
122 |
1.1 |