org.docx4j.model.listnumbering.ListLevel Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of docx4j-core Show documentation
Show all versions of docx4j-core Show documentation
docx4j is a library which helps you to work with the Office Open
XML file format as used in docx
documents, pptx presentations, and xlsx spreadsheets.
/*
* Copyright 2007-2008, Plutext Pty Ltd.
*
* This file is part of docx4j.
docx4j is licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
This file is a translation into Java of a portion of
Program.cs from Microsoft's OpenXmlViewer, which was made available to
the project under the following license:
(c) Microsoft Corporation
Microsoft Public License (Ms-PL)
This license governs use of the accompanying software. If you use the
software, you accept this license. If you do not accept the license, do
not use the software.
1. Definitions
The terms "reproduce," "reproduction," "derivative works," and "distribution"
have the same meaning here as under U.S. copyright law.
A "contribution" is the original software, or any additions or changes to the software.
A "contributor" is any person that distributes its contribution under this license.
"Licensed patents" are a contributor's patent claims that read directly on its contribution.
2. Grant of Rights
(A) Copyright Grant- Subject to the terms of this license, including the
license conditions and limitations in section 3, each contributor
grants you a non-exclusive, worldwide, royalty-free copyright license
to reproduce its contribution, prepare derivative works of its
contribution, and distribute its contribution or any derivative works
that you create.
(B) Patent Grant- Subject to the terms of this
license, including the license conditions and limitations in section 3,
each contributor grants you a non-exclusive, worldwide, royalty-free
license under its licensed patents to make, have made, use, sell, offer
for sale, import, and/or otherwise dispose of its contribution in the
software or derivative works of the contribution in the software.
3. Conditions and Limitations
(A) No Trademark License- This license does not grant you rights to use any contributors' name, logo, or trademarks.
(B) If you bring a patent claim against any contributor over patents that
you claim are infringed by the software, your patent license from such
contributor to the software ends automatically.
(C) If you distribute any portion of the software, you must retain all copyright,
patent, trademark, and attribution notices that are present in the
software.
(D) If you distribute any portion of the software in
source code form, you may do so only under this license by including a
complete copy of this license with your distribution. If you distribute
any portion of the software in compiled or object code form, you may
only do so under a license that complies with this license.
(E) The software is licensed "as-is." You bear the risk of using it. The
contributors give no express warranties, guarantees or conditions. You
may have additional consumer rights under your local laws which this
license cannot change. To the extent permitted under your local laws,
the contributors exclude the implied warranties of merchantability,
fitness for a particular purpose and non-infringement.
*/
package org.docx4j.model.listnumbering;
import java.math.BigInteger;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.docx4j.wml.Lvl;
import org.docx4j.wml.NumFmt;
import org.docx4j.wml.NumberFormat;
public class ListLevel {
/* TODO 2011 02 23: in addition to having numbering in the
* Main document part, you can have numbering in other
* stories:
* - headers/footers
* - comments
* - footnotes/endnotes
* This means that ListLevel should have independent counters
* for each story, or the there should be a ListLevel defined
* for each story!
*
* 2012 01 10: numbering set up on a per-part basis
* seems the most sensible approach.
*
*/
protected static Logger log = LoggerFactory.getLogger(ListLevel.class);
private Lvl jaxbAbstractLvl;
public Lvl getJaxbAbstractLvl() {
return jaxbAbstractLvl;
}
private Lvl jaxbOverrideLvl;
public Lvl getJaxbOverrideLvl() {
return jaxbOverrideLvl;
}
/**
* The counter is kept at the abstract level, since
* each instance definition shares a single counter.
*
*/
private Counter counter;
protected Counter getCounter() {
return counter;
}
/**
* Constructor for a ListLevel in an abstract definition.
*/
public ListLevel(Lvl levelNode)
{
this.jaxbAbstractLvl = levelNode;
this.id = levelNode.getIlvl().toString();
counter = new Counter();
Lvl.Start startValueNode = levelNode.getStart();
if (startValueNode != null)
{
this.startValue = startValueNode.getVal().subtract(BigInteger.ONE);
// Start value is one less than the user set it to,
// since whenever we fetch the number, we first increment it.
counter.setCurrentValue(this.startValue);
}
Lvl.LvlText levelTextNode = levelNode.getLvlText();
if (levelTextNode != null)
{
this.levelText = levelTextNode.getVal();
}
org.docx4j.wml.RFonts fontNode = null;
if (levelNode.getRPr() != null) {
//XmlNode fontNode = levelNode.SelectSingleNode(".//w:rFonts", nsm);
fontNode = levelNode.getRPr().getRFonts();
}
if (fontNode != null)
{
this.font = fontNode.getHAnsi(); //getAttributeValue(fontNode, "w:hAnsi");
}
//XmlNode enumTypeNode = levelNode.SelectSingleNode("w:numFmt", nsm);
NumFmt enumTypeNode = levelNode.getNumFmt();
if (enumTypeNode != null)
{
this.numFmt = enumTypeNode.getVal();
// w:numFmt="bullet" indicates a bulleted list
this.isBullet = numFmt.equals( NumberFormat.BULLET );
// this.isBullet = String.Compare(type, "bullet", StringComparison.OrdinalIgnoreCase) == 0;
}
}
/**
* Constructor for a ListLevel in an instance definition.
*/
public ListLevel(ListLevel masterCopy)
{
this.jaxbAbstractLvl = masterCopy.jaxbAbstractLvl;
this.id = masterCopy.id;
this.levelText = masterCopy.levelText;
this.startValue = masterCopy.startValue;
//this.counter = this.startValue;
this.counter = masterCopy.counter; // reference the abstract one, since this is shared
this.font = masterCopy.font;
this.isBullet = masterCopy.isBullet;
this.numFmt = masterCopy.numFmt;
}
/**
* Get overridden values
* @param levelNode
*/
public void SetOverrides(Lvl levelNode)
{
this.jaxbOverrideLvl = levelNode;
Lvl.Start startValueNode = levelNode.getStart();
if (startValueNode != null)
{
this.startValue = startValueNode.getVal().subtract(BigInteger.ONE);
// Start value is one less than the user set it to,
// since whenever we fetch the number, we first increment it.
counter.setCurrentValue(this.startValue);
}
Lvl.LvlText levelTextNode = levelNode.getLvlText();
if (levelTextNode != null)
{
this.levelText = levelTextNode.getVal();
}
//XmlNode fontNode = levelNode.SelectSingleNode(".//w:rFonts", nsm);
org.docx4j.wml.RFonts fontNode =null;
if (levelNode.getRPr() != null) {
fontNode = levelNode.getRPr().getRFonts();
}
if (fontNode != null)
{
this.font = fontNode.getHAnsi();
}
//XmlNode enumTypeNode = levelNode.SelectSingleNode("w:numFmt", nsm);
NumFmt enumTypeNode = levelNode.getNumFmt();
if (enumTypeNode != null)
{
this.numFmt = enumTypeNode.getVal();
// w:numFmt="bullet" indicates a bulleted list
this.isBullet = numFmt.equals( NumberFormat.BULLET );
}
}
private String id;
/**
* returns the ID of the level
* @return
*/
public String getID()
{
return this.id;
}
private BigInteger startValue = BigInteger.ZERO;
public void setStartValue(BigInteger startValue) {
this.startValue = startValue;
startAtUsed = false;
}
/**
* start value of that level
* @return
*/
public BigInteger getStartValue()
{
return this.startValue;
}
/**
* The current number, formatted using numFmt.
*/
public String getCurrentValueFormatted()
{
/*
* If you look at the OpenXML spec or
* STNumberFormat.java, you'll see there are some 60 number formats.
*
* Of these, we currently aim to support:
*
* decimal
* upperRoman
* lowerRoman
* upperLetter
* lowerLetter
* bullet
* none
*
* What about?
*
* ordinal
* cardinalText
* ordinalText
*
*/
if (numFmt.equals( NumberFormat.DECIMAL ) ) {
return this.counter.getCurrentValue().toString();
}
if (numFmt.equals( NumberFormat.NONE ) ) {
return "";
}
if (numFmt.equals( NumberFormat.BULLET ) ) {
// TODO - revisit how this is handled.
// The code elsewhere for handling bullets
// overlaps with this numFmt stuff.
return "*";
}
int current = this.counter.getCurrentValue().intValue();
if (numFmt.equals( NumberFormat.UPPER_ROMAN ) ) {
NumberFormatRomanUpper converter = new NumberFormatRomanUpper();
return converter.format(current);
}
if (numFmt.equals( NumberFormat.LOWER_ROMAN ) ) {
NumberFormatRomanLower converter = new NumberFormatRomanLower();
return converter.format(current);
}
if (numFmt.equals( NumberFormat.LOWER_LETTER ) ) {
NumberFormatLowerLetter converter = new NumberFormatLowerLetter();
return converter.format(current);
}
if (numFmt.equals( NumberFormat.UPPER_LETTER ) ) {
NumberFormatLowerLetter converter = new NumberFormatLowerLetter();
return converter.format(current).toUpperCase();
}
if (numFmt.equals( NumberFormat.DECIMAL_ZERO ) ) {
NumberFormatDecimalZero converter = new NumberFormatDecimalZero();
return converter.format(current);
}
log.error("Unhandled numFmt: " + numFmt.name() );
return this.counter.getCurrentValue().toString();
}
public String getCurrentValueUnformatted()
{
return this.counter.getCurrentValue().toString();
}
/**
* increments the current count of list items of that level
*/
public void IncrementCounter()
{
if (startAtUsed==false
|| (!counter.encounteredAlready)) {
// Defer setting the startValue until the list
// is actually encountered in the main document part,
// since otherwise earlier numbering (using the
// same abstract number) would use this startValue
counter.setCurrentValue(this.startValue);
log.debug("not encounteredAlready; set to startValue " + startValue);
counter.encounteredAlready = true;
startAtUsed = true;
}
counter.IncrementCounter();
}
protected boolean startAtUsed = true;
/**
* resets the counter to the start value
*/
public void ResetCounter()
{
counter.setCurrentValue(this.startValue);
}
private String levelText;
/**
* returns the indicated lvlText value
* @return
*/
public String getLevelText()
{
return this.levelText;
}
private String font;
/**
* returns the font name
* @return
*/
@Deprecated
public String getFont()
{
return this.font;
}
private NumberFormat numFmt; // TODO: alter schema
// w:numFmt = RTF's \levelnfcN
// private void setNumFmt(STNumberFormat numFmt) {
// this.numFmt = numFmt;
// }
public NumberFormat getNumFmt() {
return numFmt;
}
private boolean isBullet;
/**
* returns whether the enumeration type is a bulleted list or not
*
* @return
*/
public boolean IsBullet()
{
return this.isBullet;
}
protected class Counter {
protected boolean encounteredAlready = false;
protected boolean isEncounteredAlready() {
return encounteredAlready;
}
private BigInteger currentValue;
Counter() {
currentValue = BigInteger.ZERO;
}
public void setCurrentValue(BigInteger currentValue) {
this.currentValue = currentValue;
}
/**
* returns the current count of list items of that level
* @return
*/
public BigInteger getCurrentValue()
{
log.debug("counter: " + currentValue.intValue() );
return this.currentValue;
}
/**
* increments the current count of list items of that level
*/
public void IncrementCounter()
{
setCurrentValue( currentValue.add(BigInteger.ONE));
log.debug("counter now: " + currentValue.intValue() );
}
}
}