public abstract class HSLFTextShape extends HSLFSimpleShape implements TextShape<HSLFShape,HSLFTextParagraph>
TextShape.TextAutofit, TextShape.TextDirection, TextShape.TextPlaceholder
Modifier and Type | Field and Description |
---|---|
static int |
WrapByPoints
Specifies a wrapping rule that is equivalent to that of WrapSquare
Excel 97, Excel 2000, Excel 2002, and Office Excel 2003 use this value.
|
static int |
WrapNone
Specifies that a line of text will extend into or beyond a margin instead
of continuing on subsequent lines.
|
static int |
WrapSquare
Specifies that a line of text will continue on subsequent lines instead
of extending into or beyond a margin.
|
static int |
WrapThrough
Specifies a wrapping rule that is undefined and MUST be ignored.
|
static int |
WrapTopBottom
Specifies a wrapping rule that is undefined and MUST be ignored.
|
_hyperlink, ADJUST_VALUES, DEFAULT_LINE_WIDTH
Modifier | Constructor and Description |
---|---|
|
HSLFTextShape()
Create a new TextBox.
|
protected |
HSLFTextShape(EscherContainerRecord escherRecord,
ShapeContainer<HSLFShape,HSLFTextParagraph> parent)
Create a TextBox object and initialize it from the supplied Record container.
|
|
HSLFTextShape(ShapeContainer<HSLFShape,HSLFTextParagraph> parent)
Create a new TextBox.
|
Modifier and Type | Method and Description |
---|---|
protected void |
afterInsert(HSLFSheet sh)
When a textbox is added to a sheet we need to tell upper-level
PPDrawing about it. |
HSLFTextRun |
appendText(java.lang.String text,
boolean newParagraph)
Adds the supplied text onto the end of the TextParagraphs,
creating a new RichTextRun for it to sit in.
|
double |
getBottomInset()
Returns the distance (in points) between the bottom of the text frame
and the bottom of the inscribed rectangle of the shape that contains the text.
|
protected EscherTextboxWrapper |
getEscherTextboxWrapper() |
RoundTripHFPlaceholder12 |
getHFPlaceholderAtom()
Return
RoundTripHFPlaceholder12 , the atom that describes a header/footer placeholder. |
java.util.List<HSLFHyperlink> |
getHyperlinks()
Returns the array of all hyperlinks in this text run
|
Insets2D |
getInsets() |
double |
getLeftInset()
Returns the distance (in points) between the left edge of the text frame
and the left edge of the inscribed rectangle of the shape that contains
the text.
|
<S extends Shape<S,P>,P extends TextParagraph<S,P,? extends TextRun>> |
getMetroShape()
Get alternative representation of text shape stored as metro blob escher property.
|
OEPlaceholderAtom |
getPlaceholderAtom()
Return
OEPlaceholderAtom , the atom that describes a placeholder. |
java.lang.String |
getRawText()
Returns the raw text content of the shape.
|
double |
getRightInset()
Returns the distance (in points) between the right edge of the
text frame and the right edge of the inscribed rectangle of the shape
that contains the text.
|
int |
getRunType()
Returns the type of the text, from the TextHeaderAtom.
|
java.lang.String |
getText()
Returns the text contained in this text frame, which has been made safe
for printing and other use.
|
TextShape.TextDirection |
getTextDirection() |
double |
getTextHeight()
Compute the cumulative height occupied by the text
|
double |
getTextHeight(java.awt.Graphics2D graphics)
Compute the cumulative height occupied by the text
|
int |
getTextId() |
java.util.List<HSLFTextParagraph> |
getTextParagraphs() |
TextShape.TextPlaceholder |
getTextPlaceholder() |
java.lang.Double |
getTextRotation()
The text rotation can be independent specified from the shape rotation.
|
double |
getTopInset()
Returns the distance (in points) between the top of the text frame
and the top of the inscribed rectangle of the shape that contains the text.
|
VerticalAlignment |
getVerticalAlignment()
Returns the type of vertical alignment for the text.
|
boolean |
getWordWrap() |
int |
getWordWrapEx()
Returns the value indicating word wrap.
|
boolean |
isAlignToBaseline() |
boolean |
isHorizontalCentered()
Returns if the text is centered.
|
boolean |
isPlaceholder()
Checks if the shape is a placeholder.
|
java.util.Iterator<HSLFTextParagraph> |
iterator() |
java.awt.geom.Rectangle2D |
resizeToFitText()
Adjust the size of the shape so it encompasses the text inside it.
|
java.awt.geom.Rectangle2D |
resizeToFitText(java.awt.Graphics2D graphics)
Adjust the size of the shape so it encompasses the text inside it.
|
void |
setAlignToBaseline(boolean alignToBaseline)
Sets the vertical alignment relative to the baseline
|
void |
setBottomInset(double margin)
Sets the botom margin.
|
protected void |
setDefaultTextProperties(HSLFTextParagraph _txtrun)
Set default properties for the TextRun.
|
void |
setHorizontalCentered(java.lang.Boolean isCentered)
Sets if the paragraphs are horizontal centered
|
void |
setInsets(Insets2D insets)
Sets the shape margins
|
void |
setLeftInset(double margin)
Sets the left margin.
|
void |
setRightInset(double margin)
Sets the right margin.
|
void |
setRunType(int type)
Changes the type of the text.
|
void |
setSheet(HSLFSheet sheet)
Assign the
SlideShow this shape belongs to |
HSLFTextRun |
setText(java.lang.String text)
Sets (overwrites) the current text.
|
void |
setTextDirection(TextShape.TextDirection orientation)
sets the vertical orientation
|
void |
setTextId(int id)
Sets text ID
|
void |
setTextPlaceholder(TextShape.TextPlaceholder placeholder)
Sets the text placeholder
|
void |
setTextRotation(java.lang.Double rotation)
Sets the text rotation.
|
void |
setTopInset(double margin)
Sets the top margin.
|
void |
setVerticalAlignment(VerticalAlignment vAlign)
Sets the type of vertical alignment for the text.
|
void |
setWordWrap(boolean wrap) |
void |
setWordWrapEx(int wrap)
Specifies how the text should be wrapped
|
java.util.Spliterator<HSLFTextParagraph> |
spliterator() |
protected void |
storeText()
Saves the modified paragraphs/textrun to the records.
|
createHyperlink, createSpContainer, getAdjustValue, getFillColor, getGeometry, getHyperlink, getLineBackgroundColor, getLineCap, getLineColor, getLineCompound, getLineDash, getLineDecoration, getLineHeadDecoration, getLineHeadLength, getLineHeadWidth, getLineTailDecoration, getLineTailLength, getLineTailWidth, getLineWidth, getPlaceholder, getPlaceholderDetails, getShadow, getShadowAngle, getShadowColor, getShadowDistance, getStrokeStyle, setFillColor, setHyperlink, setLineBackgroundColor, setLineCap, setLineColor, setLineCompound, setLineDash, setLineHeadDecoration, setLineHeadLength, setLineHeadWidth, setLineTailDecoration, setLineTailLength, setLineTailWidth, setLineWidth, setPlaceholder, setStrokeStyle
draw, getAnchor, getClientData, getClientDataRecord, getClientRecords, getEscherChild, getEscherChild, getEscherChild, getEscherChild, getEscherOptRecord, getEscherProperty, getEscherProperty, getEscherProperty, getEscherProperty, getEscherProperty, getEscherProperty, getFill, getFillStyle, getFlipHorizontal, getFlipVertical, getParent, getRotation, getShapeId, getShapeName, getShapeType, getSheet, getSpContainer, moveTo, setAnchor, setEscherProperty, setEscherProperty, setEscherProperty, setEscherProperty, setEscherProperty, setFlipHorizontal, setFlipVertical, setRotation, setShapeId, setShapeType
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
createHyperlink, getFillColor, getFillStyle, getGeometry, getHyperlink, getLineDecoration, getPlaceholder, getPlaceholderDetails, getShadow, getShapeType, getStrokeStyle, setFillColor, setPlaceholder, setShapeType, setStrokeStyle
draw, getAnchor, getParent, getShapeId, getShapeName, getSheet
getAdjustValue
getAnchor, getFlipHorizontal, getFlipVertical, getParent, getRotation, getSheet, setAnchor, setFlipHorizontal, setFlipVertical, setRotation
public static final int WrapSquare
public static final int WrapByPoints
public static final int WrapNone
public static final int WrapTopBottom
public static final int WrapThrough
protected HSLFTextShape(EscherContainerRecord escherRecord, ShapeContainer<HSLFShape,HSLFTextParagraph> parent)
escherRecord
- EscherSpContainer
container which holds information about this shapeparent
- the parent of the shapepublic HSLFTextShape(ShapeContainer<HSLFShape,HSLFTextParagraph> parent)
parent
- the parent of this Shape. For example, if this text box is a cell
in a table then the parent is Table.public HSLFTextShape()
protected void setDefaultTextProperties(HSLFTextParagraph _txtrun)
protected void afterInsert(HSLFSheet sh)
PPDrawing
about it.afterInsert
in class HSLFShape
sh
- the sheet we are adding toprotected EscherTextboxWrapper getEscherTextboxWrapper()
public java.awt.geom.Rectangle2D resizeToFitText()
TextShape
resizeToFitText
in interface TextShape<HSLFShape,HSLFTextParagraph>
Rectangle2D
that is the bounds of this shape.public java.awt.geom.Rectangle2D resizeToFitText(java.awt.Graphics2D graphics)
TextShape
resizeToFitText
in interface TextShape<HSLFShape,HSLFTextParagraph>
graphics
- a customized graphics context, e.g. which contains font mappingsRectangle2D
that is the bounds of this shape.public int getRunType()
TextHeaderAtom
public void setRunType(int type)
TextHeaderAtom
public boolean isAlignToBaseline()
public void setAlignToBaseline(boolean alignToBaseline)
alignToBaseline
- if true, vertical alignment is relative to baselinepublic boolean isHorizontalCentered()
TextShape
isHorizontalCentered
in interface TextShape<HSLFShape,HSLFTextParagraph>
public void setHorizontalCentered(java.lang.Boolean isCentered)
TextShape
setHorizontalCentered
in interface TextShape<HSLFShape,HSLFTextParagraph>
isCentered
- true, if the paragraphs are horizontal centered
A null
values unsets this property.public VerticalAlignment getVerticalAlignment()
TextShape
getVerticalAlignment
in interface TextShape<HSLFShape,HSLFTextParagraph>
public void setVerticalAlignment(VerticalAlignment vAlign)
TextShape
setVerticalAlignment
in interface TextShape<HSLFShape,HSLFTextParagraph>
vAlign
- - the type of alignment.
A null
values unsets this property.public double getBottomInset()
public void setBottomInset(double margin)
margin
- the bottom margingetBottomInset()
public double getLeftInset()
public void setLeftInset(double margin)
margin
- the left margingetLeftInset()
public double getRightInset()
public void setRightInset(double margin)
margin
- the right margingetRightInset()
public double getTopInset()
public void setTopInset(double margin)
margin
- the top margingetTopInset()
public int getWordWrapEx()
Wrap*
constants defined in this class.public void setWordWrapEx(int wrap)
wrap
- the value indicating how the text should be wrapped.
Must be one of the Wrap*
constants defined in this class.public boolean getWordWrap()
getWordWrap
in interface TextShape<HSLFShape,HSLFTextParagraph>
public void setWordWrap(boolean wrap)
setWordWrap
in interface TextShape<HSLFShape,HSLFTextParagraph>
wrap
- whether to wrap words within the bounding rectanglepublic int getTextId()
public void setTextId(int id)
id
- of the textpublic java.util.List<HSLFTextParagraph> getTextParagraphs()
getTextParagraphs
in interface TextShape<HSLFShape,HSLFTextParagraph>
public void setSheet(HSLFSheet sheet)
HSLFShape
SlideShow
this shape belongs topublic OEPlaceholderAtom getPlaceholderAtom()
OEPlaceholderAtom
, the atom that describes a placeholder.OEPlaceholderAtom
or null
if not foundpublic RoundTripHFPlaceholder12 getHFPlaceholderAtom()
RoundTripHFPlaceholder12
, the atom that describes a header/footer placeholder.
Compare the RoundTripHFPlaceholder12.getPlaceholderId()
with
Placeholder.HEADER
or Placeholder.FOOTER
, to find out
what kind of placeholder this is.RoundTripHFPlaceholder12
or null
if not foundpublic boolean isPlaceholder()
SimpleShape
isPlaceholder
in interface SimpleShape<HSLFShape,HSLFTextParagraph>
isPlaceholder
in class HSLFSimpleShape
true
if the shape is a placeholderpublic java.util.Iterator<HSLFTextParagraph> iterator()
iterator
in interface java.lang.Iterable<HSLFTextParagraph>
public java.util.Spliterator<HSLFTextParagraph> spliterator()
spliterator
in interface java.lang.Iterable<HSLFTextParagraph>
public Insets2D getInsets()
getInsets
in interface TextShape<HSLFShape,HSLFTextParagraph>
public void setInsets(Insets2D insets)
TextShape
setInsets
in interface TextShape<HSLFShape,HSLFTextParagraph>
insets
- the new shape marginspublic double getTextHeight()
TextShape
getTextHeight
in interface TextShape<HSLFShape,HSLFTextParagraph>
public double getTextHeight(java.awt.Graphics2D graphics)
TextShape
getTextHeight
in interface TextShape<HSLFShape,HSLFTextParagraph>
graphics
- a customized graphics context, e.g. which contains font mappingspublic TextShape.TextDirection getTextDirection()
getTextDirection
in interface TextShape<HSLFShape,HSLFTextParagraph>
public void setTextDirection(TextShape.TextDirection orientation)
TextShape
setTextDirection
in interface TextShape<HSLFShape,HSLFTextParagraph>
orientation
- vertical orientation of the textpublic java.lang.Double getTextRotation()
TextShape
getTextRotation
in interface TextShape<HSLFShape,HSLFTextParagraph>
public void setTextRotation(java.lang.Double rotation)
TextShape
setTextRotation
in interface TextShape<HSLFShape,HSLFTextParagraph>
rotation
- the text rotation, or null to unset the rotationpublic java.lang.String getRawText()
public java.lang.String getText()
TextShape
getText
in interface TextShape<HSLFShape,HSLFTextParagraph>
public HSLFTextRun appendText(java.lang.String text, boolean newParagraph)
TextShape
appendText
in interface TextShape<HSLFShape,HSLFTextParagraph>
text
- the text string to be appended.newParagraph
- if true, a new paragraph will be added,
which will contain the added textpublic HSLFTextRun setText(java.lang.String text)
TextShape
setText
in interface TextShape<HSLFShape,HSLFTextParagraph>
text
- the text string used by this object.protected void storeText()
public java.util.List<HSLFHyperlink> getHyperlinks()
null
if not found.public void setTextPlaceholder(TextShape.TextPlaceholder placeholder)
TextShape
setTextPlaceholder
in interface TextShape<HSLFShape,HSLFTextParagraph>
public TextShape.TextPlaceholder getTextPlaceholder()
getTextPlaceholder
in interface TextShape<HSLFShape,HSLFTextParagraph>
public <S extends Shape<S,P>,P extends TextParagraph<S,P,? extends TextRun>> Shape<S,P> getMetroShape()
Copyright 2022 The Apache Software Foundation or its licensors, as applicable.