applied patch #46212 by Gisella Bronzetti: initial implementation of XWPFRun object
git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@714244 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
parent
6a8bb2c748
commit
2e2062d99a
78
src/ooxml/java/org/apache/poi/xwpf/usermodel/TextAlignment.java
Executable file
78
src/ooxml/java/org/apache/poi/xwpf/usermodel/TextAlignment.java
Executable file
@ -0,0 +1,78 @@
|
|||||||
|
/* ====================================================================
|
||||||
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||||
|
contributor license agreements. See the NOTICE file distributed with
|
||||||
|
this work for additional information regarding copyright ownership.
|
||||||
|
The ASF licenses this file to You 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.
|
||||||
|
==================================================================== */
|
||||||
|
package org.apache.poi.xwpf.usermodel;
|
||||||
|
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies all types of vertical alignment which are available to be applied to of all text
|
||||||
|
* on each line displayed within a paragraph.
|
||||||
|
*
|
||||||
|
* @author Gisella Bronzetti
|
||||||
|
*/
|
||||||
|
public enum TextAlignment {
|
||||||
|
/**
|
||||||
|
* Specifies that all text in the parent object shall be
|
||||||
|
* aligned to the top of each character when displayed
|
||||||
|
*/
|
||||||
|
TOP(1),
|
||||||
|
/**
|
||||||
|
* Specifies that all text in the parent object shall be
|
||||||
|
* aligned to the center of each character when displayed.
|
||||||
|
*/
|
||||||
|
CENTER(2),
|
||||||
|
/**
|
||||||
|
* Specifies that all text in the parent object shall be
|
||||||
|
* aligned to the baseline of each character when displayed.
|
||||||
|
*/
|
||||||
|
BASELINE(3),
|
||||||
|
/**
|
||||||
|
* Specifies that all text in the parent object shall be
|
||||||
|
* aligned to the bottom of each character when displayed.
|
||||||
|
*/
|
||||||
|
BOTTOM(4),
|
||||||
|
/**
|
||||||
|
* Specifies that all text in the parent object shall be
|
||||||
|
* aligned automatically when displayed.
|
||||||
|
*/
|
||||||
|
AUTO(5);
|
||||||
|
|
||||||
|
private final int value;
|
||||||
|
|
||||||
|
private TextAlignment(int val){
|
||||||
|
value = val;
|
||||||
|
}
|
||||||
|
|
||||||
|
public int getValue(){
|
||||||
|
return value;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static Map<Integer, TextAlignment> imap = new HashMap<Integer, TextAlignment>();
|
||||||
|
static{
|
||||||
|
for (TextAlignment p : values()) {
|
||||||
|
imap.put(p.getValue(), p);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public static TextAlignment valueOf(int type){
|
||||||
|
TextAlignment align = imap.get(type);
|
||||||
|
if(align == null) throw new IllegalArgumentException("Unknown text alignment: " + type);
|
||||||
|
return align;
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
163
src/ooxml/java/org/apache/poi/xwpf/usermodel/UnderlinePatterns.java
Executable file
163
src/ooxml/java/org/apache/poi/xwpf/usermodel/UnderlinePatterns.java
Executable file
@ -0,0 +1,163 @@
|
|||||||
|
/* ====================================================================
|
||||||
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||||
|
contributor license agreements. See the NOTICE file distributed with
|
||||||
|
this work for additional information regarding copyright ownership.
|
||||||
|
The ASF licenses this file to You 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.
|
||||||
|
==================================================================== */
|
||||||
|
package org.apache.poi.xwpf.usermodel;
|
||||||
|
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies the types of patterns which may be used to create the underline
|
||||||
|
* applied beneath the text in a run.
|
||||||
|
*
|
||||||
|
* @author Gisella Bronzetti
|
||||||
|
*/
|
||||||
|
public enum UnderlinePatterns {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies an underline consisting of a single line beneath all characters
|
||||||
|
* in this run.
|
||||||
|
*/
|
||||||
|
SINGLE(1),
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies an underline consisting of a single line beneath all non-space
|
||||||
|
* characters in the run. There shall be no underline beneath any space
|
||||||
|
* character (breaking or non-breaking).
|
||||||
|
*/
|
||||||
|
WORDS(2),
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies an underline consisting of two lines beneath all characters in
|
||||||
|
* this run
|
||||||
|
*/
|
||||||
|
DOUBLE(3),
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies an underline consisting of a single thick line beneath all
|
||||||
|
* characters in this run.
|
||||||
|
*/
|
||||||
|
THICK(4),
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies an underline consisting of a series of dot characters beneath
|
||||||
|
* all characters in this run.
|
||||||
|
*/
|
||||||
|
DOTTED(5),
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies an underline consisting of a series of thick dot characters
|
||||||
|
* beneath all characters in this run.
|
||||||
|
*/
|
||||||
|
DOTTED_HEAVY(6),
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies an underline consisting of a dashed line beneath all characters
|
||||||
|
* in this run.
|
||||||
|
*/
|
||||||
|
DASH(7),
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies an underline consisting of a series of thick dashes beneath all
|
||||||
|
* characters in this run.
|
||||||
|
*/
|
||||||
|
DASHED_HEAVY(8),
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies an underline consisting of long dashed characters beneath all
|
||||||
|
* characters in this run.
|
||||||
|
*/
|
||||||
|
DASH_LONG(9),
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies an underline consisting of thick long dashed characters beneath
|
||||||
|
* all characters in this run.
|
||||||
|
*/
|
||||||
|
DASH_LONG_HEAVY(10),
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies an underline consisting of a series of dash, dot characters
|
||||||
|
* beneath all characters in this run.
|
||||||
|
*/
|
||||||
|
DOT_DASH(11),
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies an underline consisting of a series of thick dash, dot
|
||||||
|
* characters beneath all characters in this run.
|
||||||
|
*/
|
||||||
|
DASH_DOT_HEAVY(12),
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies an underline consisting of a series of dash, dot, dot
|
||||||
|
* characters beneath all characters in this run.
|
||||||
|
*/
|
||||||
|
DOT_DOT_DASH(13),
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies an underline consisting of a series of thick dash, dot, dot
|
||||||
|
* characters beneath all characters in this run.
|
||||||
|
*/
|
||||||
|
DASH_DOT_DOT_HEAVY(14),
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies an underline consisting of a single wavy line beneath all
|
||||||
|
* characters in this run.
|
||||||
|
*/
|
||||||
|
WAVE(15),
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies an underline consisting of a single thick wavy line beneath all
|
||||||
|
* characters in this run.
|
||||||
|
*/
|
||||||
|
WAVY_HEAVY(16),
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies an underline consisting of a pair of wavy lines beneath all
|
||||||
|
* characters in this run.
|
||||||
|
*/
|
||||||
|
WAVY_DOUBLE(17),
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies no underline beneath this run.
|
||||||
|
*/
|
||||||
|
NONE(18);
|
||||||
|
|
||||||
|
private final int value;
|
||||||
|
|
||||||
|
private UnderlinePatterns(int val) {
|
||||||
|
value = val;
|
||||||
|
}
|
||||||
|
|
||||||
|
public int getValue() {
|
||||||
|
return value;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static Map<Integer, UnderlinePatterns> imap = new HashMap<Integer, UnderlinePatterns>();
|
||||||
|
static {
|
||||||
|
for (UnderlinePatterns p : values()) {
|
||||||
|
imap.put(p.getValue(), p);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public static UnderlinePatterns valueOf(int type) {
|
||||||
|
UnderlinePatterns align = imap.get(type);
|
||||||
|
if (align == null)
|
||||||
|
throw new IllegalArgumentException("Unknown underline pattern: "
|
||||||
|
+ type);
|
||||||
|
return align;
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
75
src/ooxml/java/org/apache/poi/xwpf/usermodel/VerticalAlign.java
Executable file
75
src/ooxml/java/org/apache/poi/xwpf/usermodel/VerticalAlign.java
Executable file
@ -0,0 +1,75 @@
|
|||||||
|
/* ====================================================================
|
||||||
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||||
|
contributor license agreements. See the NOTICE file distributed with
|
||||||
|
this work for additional information regarding copyright ownership.
|
||||||
|
The ASF licenses this file to You 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.
|
||||||
|
==================================================================== */
|
||||||
|
package org.apache.poi.xwpf.usermodel;
|
||||||
|
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies possible values for the alignment of the contents of this run in
|
||||||
|
* relation to the default appearance of the run's text. This allows the text to
|
||||||
|
* be repositioned as subscript or superscript without altering the font size of
|
||||||
|
* the run properties.
|
||||||
|
*
|
||||||
|
* @author Gisella Bronzetti
|
||||||
|
*/
|
||||||
|
public enum VerticalAlign {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies that the text in the parent run shall be located at the
|
||||||
|
* baseline and presented in the same size as surrounding text.
|
||||||
|
*/
|
||||||
|
BASELINE(1),
|
||||||
|
/**
|
||||||
|
* Specifies that this text should be subscript. This setting shall lower
|
||||||
|
* the text in this run below the baseline and change it to a smaller size,
|
||||||
|
* if a smaller size is available.
|
||||||
|
*/
|
||||||
|
SUPERSCRIPT(2),
|
||||||
|
/**
|
||||||
|
* Specifies that this text should be superscript. This setting shall raise
|
||||||
|
* the text in this run above the baseline and change it to a smaller size,
|
||||||
|
* if a smaller size is available.
|
||||||
|
*/
|
||||||
|
SUBSCRIPT(3);
|
||||||
|
|
||||||
|
private final int value;
|
||||||
|
|
||||||
|
private VerticalAlign(int val) {
|
||||||
|
value = val;
|
||||||
|
}
|
||||||
|
|
||||||
|
public int getValue() {
|
||||||
|
return value;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static Map<Integer, VerticalAlign> imap = new HashMap<Integer, VerticalAlign>();
|
||||||
|
static {
|
||||||
|
for (VerticalAlign p : values()) {
|
||||||
|
imap.put(p.getValue(), p);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public static VerticalAlign valueOf(int type) {
|
||||||
|
VerticalAlign align = imap.get(type);
|
||||||
|
if (align == null)
|
||||||
|
throw new IllegalArgumentException("Unknown vertical alignment: "
|
||||||
|
+ type);
|
||||||
|
return align;
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
@ -1,105 +1,373 @@
|
|||||||
/* ====================================================================
|
/* ====================================================================
|
||||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||||
contributor license agreements. See the NOTICE file distributed with
|
contributor license agreements. See the NOTICE file distributed with
|
||||||
this work for additional information regarding copyright ownership.
|
this work for additional information regarding copyright ownership.
|
||||||
The ASF licenses this file to You under the Apache License, Version 2.0
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
||||||
(the "License"); you may not use this file except in compliance with
|
(the "License"); you may not use this file except in compliance with
|
||||||
the License. You may obtain a copy of the License at
|
the License. You may obtain a copy of the License at
|
||||||
|
|
||||||
http://www.apache.org/licenses/LICENSE-2.0
|
http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
|
||||||
Unless required by applicable law or agreed to in writing, software
|
Unless required by applicable law or agreed to in writing, software
|
||||||
distributed under the License is distributed on an "AS IS" BASIS,
|
distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
See the License for the specific language governing permissions and
|
See the License for the specific language governing permissions and
|
||||||
limitations under the License.
|
limitations under the License.
|
||||||
==================================================================== */
|
==================================================================== */
|
||||||
package org.apache.poi.xwpf.usermodel;
|
package org.apache.poi.xwpf.usermodel;
|
||||||
|
|
||||||
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTR;
|
import java.math.BigInteger;
|
||||||
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTRPr;
|
|
||||||
import org.openxmlformats.schemas.wordprocessingml.x2006.main.STOnOff;
|
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTFonts;
|
||||||
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTText;
|
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTHpsMeasure;
|
||||||
|
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTOnOff;
|
||||||
/**
|
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTR;
|
||||||
* XWPFRun object defines a region of text with a common set of properties
|
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTRPr;
|
||||||
*
|
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTSignedHpsMeasure;
|
||||||
* @author Yegor Kozlov
|
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTText;
|
||||||
*/
|
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTUnderline;
|
||||||
public class XWPFRun {
|
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTVerticalAlignRun;
|
||||||
private CTR run;
|
import org.openxmlformats.schemas.wordprocessingml.x2006.main.STOnOff;
|
||||||
private XWPFParagraph paragraph;
|
import org.openxmlformats.schemas.wordprocessingml.x2006.main.STUnderline;
|
||||||
|
import org.openxmlformats.schemas.wordprocessingml.x2006.main.STVerticalAlignRun;
|
||||||
/**
|
|
||||||
*
|
/**
|
||||||
* @param r the CTR bean which holds the run attributes
|
* XWPFRun object defines a region of text with a common set of properties
|
||||||
* @param p the parent paragraph
|
*
|
||||||
*/
|
* @author Yegor Kozlov
|
||||||
protected XWPFRun(CTR r, XWPFParagraph p){
|
*/
|
||||||
this.run = r;
|
public class XWPFRun {
|
||||||
this.paragraph = p;
|
private CTR run;
|
||||||
}
|
private XWPFParagraph paragraph;
|
||||||
|
|
||||||
public CTR getCTR(){
|
/**
|
||||||
return run;
|
* @param r the CTR bean which holds the run attributes
|
||||||
}
|
* @param p the parent paragraph
|
||||||
|
*/
|
||||||
public XWPFParagraph getParagraph(){
|
protected XWPFRun(CTR r, XWPFParagraph p) {
|
||||||
return paragraph;
|
this.run = r;
|
||||||
}
|
this.paragraph = p;
|
||||||
|
}
|
||||||
/**
|
|
||||||
* Whether the bold property shall be applied to all non-complex script characters in the
|
public CTR getCTR() {
|
||||||
* contents of this run when displayed in a document
|
return run;
|
||||||
*
|
}
|
||||||
* @return <code>true</code> if the bold property is applied
|
|
||||||
*/
|
public XWPFParagraph getParagraph() {
|
||||||
public boolean isBold(){
|
return paragraph;
|
||||||
CTRPr pr = run.getRPr();
|
}
|
||||||
return pr != null && pr.isSetB();
|
|
||||||
}
|
/**
|
||||||
|
* Whether the bold property shall be applied to all non-complex script
|
||||||
/**
|
* characters in the contents of this run when displayed in a document
|
||||||
* Whether the bold property shall be applied to all non-complex script characters in the
|
*
|
||||||
* contents of this run when displayed in a document
|
* @return <code>true</code> if the bold property is applied
|
||||||
*
|
*/
|
||||||
* <p>
|
public boolean isBold() {
|
||||||
* This formatting property is a toggle property, which specifies that its behavior differs between its use within a
|
CTRPr pr = run.getRPr();
|
||||||
* style definition and its use as direct formatting. When used as part of a style definition, setting this property
|
return pr != null && pr.isSetB();
|
||||||
* shall toggle the current state of that property as specified up to this point in the hierarchy (i.e. applied to not
|
}
|
||||||
* applied, and vice versa). Setting it to <code>false</code> (or an equivalent) shall result in the current
|
|
||||||
* setting remaining unchanged. However, when used as direct formatting, setting this property to true or false
|
/**
|
||||||
* shall set the absolute state of the resulting property.
|
* Whether the bold property shall be applied to all non-complex script
|
||||||
* </p>
|
* characters in the contents of this run when displayed in a document
|
||||||
* <p>
|
* <p/>
|
||||||
* If this element is not present, the default value is to leave the formatting applied at previous level in the style
|
* <p/>
|
||||||
* hierarchy. If this element is never applied in the style hierarchy, then bold shall not be applied to non-complex
|
* This formatting property is a toggle property, which specifies that its
|
||||||
* script characters.
|
* behavior differs between its use within a style definition and its use as
|
||||||
* </p>
|
* direct formatting. When used as part of a style definition, setting this
|
||||||
*
|
* property shall toggle the current state of that property as specified up
|
||||||
* @param value <code>true</code> if the bold property is applied to this run
|
* to this point in the hierarchy (i.e. applied to not applied, and vice
|
||||||
*/
|
* versa). Setting it to <code>false</code> (or an equivalent) shall
|
||||||
public void setBold(boolean value){
|
* result in the current setting remaining unchanged. However, when used as
|
||||||
CTRPr pr = run.isSetRPr() ? run.getRPr() : run.addNewRPr();
|
* direct formatting, setting this property to true or false shall set the
|
||||||
pr.addNewB().setVal(value ? STOnOff.TRUE : STOnOff.FALSE);
|
* absolute state of the resulting property.
|
||||||
}
|
* </p>
|
||||||
|
* <p/>
|
||||||
/**
|
* If this element is not present, the default value is to leave the
|
||||||
* Return the string content of this text run
|
* formatting applied at previous level in the style hierarchy. If this
|
||||||
*
|
* element is never applied in the style hierarchy, then bold shall not be
|
||||||
* @return the text of this text run or <code>null</code> if not set
|
* applied to non-complex script characters.
|
||||||
*/
|
* </p>
|
||||||
public String getText(){
|
*
|
||||||
return run.sizeOfTArray() == 0 ? null : run.getTArray(0).getStringValue();
|
* @param value <code>true</code> if the bold property is applied to
|
||||||
}
|
* this run
|
||||||
|
*/
|
||||||
/**
|
public void setBold(boolean value) {
|
||||||
* Sets the text of this text run
|
CTRPr pr = run.isSetRPr() ? run.getRPr() : run.addNewRPr();
|
||||||
*
|
CTOnOff bold = pr.isSetB() ? pr.getB() : pr.addNewB();
|
||||||
* @param value the literal text which shall be displayed in the document
|
bold.setVal(value ? STOnOff.TRUE : STOnOff.FALSE);
|
||||||
*/
|
}
|
||||||
public void setText(String value){
|
|
||||||
CTText t = run.sizeOfTArray() == 0 ? run.addNewT() : run.getTArray(0);
|
/**
|
||||||
t.setStringValue(value);
|
* Return the string content of this text run
|
||||||
}
|
*
|
||||||
}
|
* @return the text of this text run or <code>null</code> if not set
|
||||||
|
*/
|
||||||
|
public String getText() {
|
||||||
|
return run.sizeOfTArray() == 0 ? null : run.getTArray(0)
|
||||||
|
.getStringValue();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Sets the text of this text run
|
||||||
|
*
|
||||||
|
* @param value the literal text which shall be displayed in the document
|
||||||
|
*/
|
||||||
|
public void setText(String value) {
|
||||||
|
CTText t = run.sizeOfTArray() == 0 ? run.addNewT() : run.getTArray(0);
|
||||||
|
t.setStringValue(value);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Whether the italic property should be applied to all non-complex script
|
||||||
|
* characters in the contents of this run when displayed in a document.
|
||||||
|
*
|
||||||
|
* @return <code>true</code> if the italic property is applied
|
||||||
|
*/
|
||||||
|
public boolean isItalic() {
|
||||||
|
CTRPr pr = run.getRPr();
|
||||||
|
return pr != null && pr.isSetI();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Whether the bold property shall be applied to all non-complex script
|
||||||
|
* characters in the contents of this run when displayed in a document
|
||||||
|
* <p/>
|
||||||
|
* <p/>
|
||||||
|
* This formatting property is a toggle property, which specifies that its
|
||||||
|
* behavior differs between its use within a style definition and its use as
|
||||||
|
* direct formatting. When used as part of a style definition, setting this
|
||||||
|
* property shall toggle the current state of that property as specified up
|
||||||
|
* to this point in the hierarchy (i.e. applied to not applied, and vice
|
||||||
|
* versa). Setting it to <code>false</code> (or an equivalent) shall
|
||||||
|
* result in the current setting remaining unchanged. However, when used as
|
||||||
|
* direct formatting, setting this property to true or false shall set the
|
||||||
|
* absolute state of the resulting property.
|
||||||
|
* </p>
|
||||||
|
* <p/>
|
||||||
|
* If this element is not present, the default value is to leave the
|
||||||
|
* formatting applied at previous level in the style hierarchy. If this
|
||||||
|
* element is never applied in the style hierarchy, then bold shall not be
|
||||||
|
* applied to non-complex script characters.
|
||||||
|
* </p>
|
||||||
|
*
|
||||||
|
* @param value <code>true</code> if the italic property is applied to
|
||||||
|
* this run
|
||||||
|
*/
|
||||||
|
public void setItalic(boolean value) {
|
||||||
|
CTRPr pr = run.isSetRPr() ? run.getRPr() : run.addNewRPr();
|
||||||
|
CTOnOff italic = pr.isSetI() ? pr.getI() : pr.addNewI();
|
||||||
|
italic.setVal(value ? STOnOff.TRUE : STOnOff.FALSE);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies that the contents of this run should be displayed along with an
|
||||||
|
* underline appearing directly below the character heigh
|
||||||
|
*
|
||||||
|
* @return the Underline pattern applyed to this run
|
||||||
|
* @see UnderlinePatterns
|
||||||
|
*/
|
||||||
|
public UnderlinePatterns getUnderline() {
|
||||||
|
CTRPr pr = run.getRPr();
|
||||||
|
return (pr != null && pr.isSetU()) ? UnderlinePatterns.valueOf(pr
|
||||||
|
.getU().getVal().intValue()) : null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies that the contents of this run should be displayed along with an
|
||||||
|
* underline appearing directly below the character heigh
|
||||||
|
* <p/>
|
||||||
|
* <p/>
|
||||||
|
* If this element is not present, the default value is to leave the
|
||||||
|
* formatting applied at previous level in the style hierarchy. If this
|
||||||
|
* element is never applied in the style hierarchy, then an underline shall
|
||||||
|
* not be applied to the contents of this run.
|
||||||
|
* </p>
|
||||||
|
*
|
||||||
|
* @param value -
|
||||||
|
* underline type
|
||||||
|
* @see UnderlinePatterns : all possible patterns that could be applied
|
||||||
|
*/
|
||||||
|
public void setUnderline(UnderlinePatterns value) {
|
||||||
|
CTRPr pr = run.isSetRPr() ? run.getRPr() : run.addNewRPr();
|
||||||
|
CTUnderline underline = pr.isSetU() ? pr.getU() : pr.addNewU();
|
||||||
|
underline.setVal(STUnderline.Enum.forInt(value.getValue()));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies that the contents of this run shall be displayed with a single
|
||||||
|
* horizontal line through the center of the line.
|
||||||
|
*
|
||||||
|
* @return <code>true</code> if the strike property is applied
|
||||||
|
*/
|
||||||
|
public boolean isStrike() {
|
||||||
|
CTRPr pr = run.getRPr();
|
||||||
|
return pr != null && pr.isSetStrike();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies that the contents of this run shall be displayed with a single
|
||||||
|
* horizontal line through the center of the line.
|
||||||
|
* <p/>
|
||||||
|
* This formatting property is a toggle property, which specifies that its
|
||||||
|
* behavior differs between its use within a style definition and its use as
|
||||||
|
* direct formatting. When used as part of a style definition, setting this
|
||||||
|
* property shall toggle the current state of that property as specified up
|
||||||
|
* to this point in the hierarchy (i.e. applied to not applied, and vice
|
||||||
|
* versa). Setting it to false (or an equivalent) shall result in the
|
||||||
|
* current setting remaining unchanged. However, when used as direct
|
||||||
|
* formatting, setting this property to true or false shall set the absolute
|
||||||
|
* state of the resulting property.
|
||||||
|
* </p>
|
||||||
|
* <p/>
|
||||||
|
* If this element is not present, the default value is to leave the
|
||||||
|
* formatting applied at previous level in the style hierarchy. If this
|
||||||
|
* element is never applied in the style hierarchy, then strikethrough shall
|
||||||
|
* not be applied to the contents of this run.
|
||||||
|
* </p>
|
||||||
|
*
|
||||||
|
* @param value <code>true</code> if the strike property is applied to
|
||||||
|
* this run
|
||||||
|
*/
|
||||||
|
public void setStrike(boolean value) {
|
||||||
|
CTRPr pr = run.isSetRPr() ? run.getRPr() : run.addNewRPr();
|
||||||
|
CTOnOff strike = pr.isSetStrike() ? pr.getStrike() : pr.addNewStrike();
|
||||||
|
strike.setVal(value ? STOnOff.TRUE : STOnOff.FALSE);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies the alignment which shall be applied to the contents of this
|
||||||
|
* run in relation to the default appearance of the run's text.
|
||||||
|
* This allows the text to be repositioned as subscript or superscript without
|
||||||
|
* altering the font size of the run properties.
|
||||||
|
*
|
||||||
|
* @return VerticalAlign
|
||||||
|
* @see VerticalAlign all possible value that could be applyed to this run
|
||||||
|
*/
|
||||||
|
public VerticalAlign getSubscript() {
|
||||||
|
CTRPr pr = run.getRPr();
|
||||||
|
return (pr != null && pr.isSetVertAlign()) ? VerticalAlign.valueOf(pr
|
||||||
|
.getVertAlign().getVal().intValue()) : null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies the alignment which shall be applied to the contents of this
|
||||||
|
* run in relation to the default appearance of the run's text. This allows
|
||||||
|
* the text to be repositioned as subscript or superscript without altering
|
||||||
|
* the font size of the run properties.
|
||||||
|
* <p/>
|
||||||
|
* If this element is not present, the default value is to leave the
|
||||||
|
* formatting applied at previous level in the style hierarchy. If this
|
||||||
|
* element is never applied in the style hierarchy, then the text shall not
|
||||||
|
* be subscript or superscript relative to the default baseline location for
|
||||||
|
* the contents of this run.
|
||||||
|
* </p>
|
||||||
|
*
|
||||||
|
* @param valign
|
||||||
|
* @see VerticalAlign
|
||||||
|
*/
|
||||||
|
public void setSubscript(VerticalAlign valign) {
|
||||||
|
CTRPr pr = run.isSetRPr() ? run.getRPr() : run.addNewRPr();
|
||||||
|
CTVerticalAlignRun ctValign = pr.isSetVertAlign() ? pr.getVertAlign() : pr.addNewVertAlign();
|
||||||
|
ctValign.setVal(STVerticalAlignRun.Enum.forInt(valign.getValue()));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies the fonts which shall be used to display the text contents of
|
||||||
|
* this run. Specifies a font which shall be used to format all characters
|
||||||
|
* in the ASCII range (0 - 127) within the parent run
|
||||||
|
*
|
||||||
|
* @return a string representing the font family
|
||||||
|
*/
|
||||||
|
public String getFontFamily() {
|
||||||
|
CTRPr pr = run.getRPr();
|
||||||
|
return (pr != null && pr.isSetRFonts()) ? pr.getRFonts().getAscii()
|
||||||
|
: null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies the fonts which shall be used to display the text contents of
|
||||||
|
* this run. Specifies a font which shall be used to format all characters
|
||||||
|
* in the ASCII range (0 - 127) within the parent run
|
||||||
|
*
|
||||||
|
* @param fontFamily
|
||||||
|
*/
|
||||||
|
public void setFontFamily(String fontFamily) {
|
||||||
|
CTRPr pr = run.getRPr();
|
||||||
|
CTFonts fonts = pr.isSetRFonts() ? pr.getRFonts() : pr.addNewRFonts();
|
||||||
|
fonts.setAscii(fontFamily);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies the font size which shall be applied to all non complex script
|
||||||
|
* characters in the contents of this run when displayed.
|
||||||
|
*
|
||||||
|
* @return value representing the font size
|
||||||
|
*/
|
||||||
|
public BigInteger getFontSize() {
|
||||||
|
CTRPr pr = run.getRPr();
|
||||||
|
return (pr != null && pr.isSetSz()) ? pr.getSz().getVal() : null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specifies the font size which shall be applied to all non complex script
|
||||||
|
* characters in the contents of this run when displayed.
|
||||||
|
* <p/>
|
||||||
|
* If this element is not present, the default value is to leave the value
|
||||||
|
* applied at previous level in the style hierarchy. If this element is
|
||||||
|
* never applied in the style hierarchy, then any appropriate font size may
|
||||||
|
* be used for non complex script characters.
|
||||||
|
* </p>
|
||||||
|
*
|
||||||
|
* @param size
|
||||||
|
*/
|
||||||
|
public void setFontSize(BigInteger size) {
|
||||||
|
CTRPr pr = run.isSetRPr() ? run.getRPr() : run.addNewRPr();
|
||||||
|
CTHpsMeasure ctSize = pr.isSetSz() ? pr.getSz() : pr.addNewSz();
|
||||||
|
ctSize.setVal(size);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This element specifies the amount by which text shall be raised or
|
||||||
|
* lowered for this run in relation to the default baseline of the
|
||||||
|
* surrounding non-positioned text. This allows the text to be repositioned
|
||||||
|
* without altering the font size of the contents.
|
||||||
|
*
|
||||||
|
* @return a big integer representing the amount of text shall be "moved"
|
||||||
|
*/
|
||||||
|
public BigInteger getTextPosition() {
|
||||||
|
CTRPr pr = run.getRPr();
|
||||||
|
return (pr != null && pr.isSetPosition()) ? pr.getPosition().getVal()
|
||||||
|
: null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This element specifies the amount by which text shall be raised or
|
||||||
|
* lowered for this run in relation to the default baseline of the
|
||||||
|
* surrounding non-positioned text. This allows the text to be repositioned
|
||||||
|
* without altering the font size of the contents.
|
||||||
|
* <p/>
|
||||||
|
* If the val attribute is positive, then the parent run shall be raised
|
||||||
|
* above the baseline of the surrounding text by the specified number of
|
||||||
|
* half-points. If the val attribute is negative, then the parent run shall
|
||||||
|
* be lowered below the baseline of the surrounding text by the specified
|
||||||
|
* number of half-points.
|
||||||
|
* </p>
|
||||||
|
* <p/>
|
||||||
|
* If this element is not present, the default value is to leave the
|
||||||
|
* formatting applied at previous level in the style hierarchy. If this
|
||||||
|
* element is never applied in the style hierarchy, then the text shall not
|
||||||
|
* be raised or lowered relative to the default baseline location for the
|
||||||
|
* contents of this run.
|
||||||
|
* </p>
|
||||||
|
*
|
||||||
|
* @param val
|
||||||
|
*/
|
||||||
|
public void setTextPosition(BigInteger val) {
|
||||||
|
CTRPr pr = run.isSetRPr() ? run.getRPr() : run.addNewRPr();
|
||||||
|
CTSignedHpsMeasure position = pr.isSetPosition() ? pr.getPosition() : pr.addNewPosition();
|
||||||
|
position.setVal(val);
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
|
135
src/ooxml/testcases/org/apache/poi/xwpf/usermodel/TestXWPFRun.java
Executable file
135
src/ooxml/testcases/org/apache/poi/xwpf/usermodel/TestXWPFRun.java
Executable file
@ -0,0 +1,135 @@
|
|||||||
|
/* ====================================================================
|
||||||
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||||
|
contributor license agreements. See the NOTICE file distributed with
|
||||||
|
this work for additional information regarding copyright ownership.
|
||||||
|
The ASF licenses this file to You 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.
|
||||||
|
==================================================================== */
|
||||||
|
package org.apache.poi.xwpf.usermodel;
|
||||||
|
|
||||||
|
import java.math.BigInteger;
|
||||||
|
|
||||||
|
import junit.framework.TestCase;
|
||||||
|
|
||||||
|
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTR;
|
||||||
|
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTRPr;
|
||||||
|
import org.openxmlformats.schemas.wordprocessingml.x2006.main.STOnOff;
|
||||||
|
import org.openxmlformats.schemas.wordprocessingml.x2006.main.STUnderline;
|
||||||
|
import org.openxmlformats.schemas.wordprocessingml.x2006.main.STVerticalAlignRun;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Tests for XWPF Run
|
||||||
|
*/
|
||||||
|
public class TestXWPFRun extends TestCase {
|
||||||
|
|
||||||
|
public CTR ctRun;
|
||||||
|
public XWPFParagraph p;
|
||||||
|
|
||||||
|
protected void setUp() {
|
||||||
|
XWPFDocument doc = new XWPFDocument();
|
||||||
|
p = doc.createParagraph();
|
||||||
|
|
||||||
|
this.ctRun = CTR.Factory.newInstance();
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testSetGetBold() {
|
||||||
|
CTRPr rpr = ctRun.addNewRPr();
|
||||||
|
rpr.addNewB().setVal(STOnOff.TRUE);
|
||||||
|
|
||||||
|
XWPFRun run = new XWPFRun(ctRun, p);
|
||||||
|
assertEquals(true, run.isBold());
|
||||||
|
|
||||||
|
run.setBold(false);
|
||||||
|
assertEquals(STOnOff.FALSE, rpr.getB().getVal());
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testSetGetItalic() {
|
||||||
|
CTRPr rpr = ctRun.addNewRPr();
|
||||||
|
rpr.addNewI().setVal(STOnOff.TRUE);
|
||||||
|
|
||||||
|
XWPFRun run = new XWPFRun(ctRun, p);
|
||||||
|
assertEquals(true, run.isItalic());
|
||||||
|
|
||||||
|
run.setItalic(false);
|
||||||
|
assertEquals(STOnOff.FALSE, rpr.getI().getVal());
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testSetGetStrike() {
|
||||||
|
CTRPr rpr = ctRun.addNewRPr();
|
||||||
|
rpr.addNewStrike().setVal(STOnOff.TRUE);
|
||||||
|
|
||||||
|
XWPFRun run = new XWPFRun(ctRun, p);
|
||||||
|
assertEquals(true, run.isStrike());
|
||||||
|
|
||||||
|
run.setStrike(false);
|
||||||
|
assertEquals(STOnOff.FALSE, rpr.getStrike().getVal());
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testSetGetUnderline() {
|
||||||
|
CTRPr rpr = ctRun.addNewRPr();
|
||||||
|
rpr.addNewU().setVal(STUnderline.DASH);
|
||||||
|
|
||||||
|
XWPFRun run = new XWPFRun(ctRun, p);
|
||||||
|
assertEquals(UnderlinePatterns.DASH.getValue(), run.getUnderline()
|
||||||
|
.getValue());
|
||||||
|
|
||||||
|
run.setUnderline(UnderlinePatterns.NONE);
|
||||||
|
assertEquals(STUnderline.NONE.intValue(), rpr.getU().getVal()
|
||||||
|
.intValue());
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testSetGetVAlign() {
|
||||||
|
CTRPr rpr = ctRun.addNewRPr();
|
||||||
|
rpr.addNewVertAlign().setVal(STVerticalAlignRun.SUBSCRIPT);
|
||||||
|
|
||||||
|
XWPFRun run = new XWPFRun(ctRun, p);
|
||||||
|
assertEquals(VerticalAlign.SUBSCRIPT, run.getSubscript());
|
||||||
|
|
||||||
|
run.setSubscript(VerticalAlign.BASELINE);
|
||||||
|
assertEquals(STVerticalAlignRun.BASELINE, rpr.getVertAlign().getVal());
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testSetGetFontFamily() {
|
||||||
|
CTRPr rpr = ctRun.addNewRPr();
|
||||||
|
rpr.addNewRFonts().setAscii("Times New Roman");
|
||||||
|
|
||||||
|
XWPFRun run = new XWPFRun(ctRun, p);
|
||||||
|
assertEquals("Times New Roman", run.getFontFamily());
|
||||||
|
|
||||||
|
run.setFontFamily("Verdana");
|
||||||
|
assertEquals("Verdana", rpr.getRFonts().getAscii());
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testSetGetFontSize() {
|
||||||
|
CTRPr rpr = ctRun.addNewRPr();
|
||||||
|
rpr.addNewSz().setVal(new BigInteger("4000"));
|
||||||
|
|
||||||
|
XWPFRun run = new XWPFRun(ctRun, p);
|
||||||
|
assertEquals(4000, run.getFontSize().longValue());
|
||||||
|
|
||||||
|
run.setFontSize(new BigInteger("2400"));
|
||||||
|
assertEquals(2400, rpr.getSz().getVal().longValue());
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testSetGetTextForegroundBackground() {
|
||||||
|
CTRPr rpr = ctRun.addNewRPr();
|
||||||
|
rpr.addNewPosition().setVal(new BigInteger("4000"));
|
||||||
|
|
||||||
|
XWPFRun run = new XWPFRun(ctRun, p);
|
||||||
|
assertEquals(4000, run.getTextPosition().longValue());
|
||||||
|
|
||||||
|
run.setTextPosition(new BigInteger("2400"));
|
||||||
|
assertEquals(2400, rpr.getPosition().getVal().longValue());
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
Loading…
Reference in New Issue
Block a user