public class TextFrameFormat extends PVIObject implements ITextFrameFormat, IChartTextBlockFormat
Contains the TextFrame's formatTextFrameFormatting properties.
Constructor and Description |
---|
TextFrameFormat()
Initializes a new instance of
TextFrameFormat class. |
Modifier and Type | Method and Description |
---|---|
byte |
getAnchoringType()
Returns or sets vertical anchor text in a TextFrameEx.
|
byte |
getAutofitType()
Returns or sets text's autofit mode.
|
byte |
getCenterText()
If NullableBool.True then text should be centered in box horizontally.
|
int |
getColumnCount()
Returns or sets number of columns in the text area.
|
double |
getColumnSpacing()
Returns or sets the space between text columns in the text area (in points).
|
ITextFrameFormatEffectiveData |
getEffective()
Gets effective text frame formatting data with the inheritance applied.
|
double |
getMarginBottom()
Returns or sets the bottom margin (points) in a TextFrame.
|
double |
getMarginLeft()
Returns or sets the left margin (points) in a TextFrame.
|
double |
getMarginRight()
Returns or sets the right margin (points) in a TextFrame.
|
double |
getMarginTop()
Returns or sets the top margin (points) in a TextFrame.
|
float |
getRotationAngle()
Specifies custom the rotation that is being applied to the text within the bounding box.
|
ITextStyle |
getTextStyle()
Returns text's style.
|
byte |
getTextVerticalType()
Determines text orientation.
|
byte |
getWrapText()
<b>True</b> if text is wrapped at TextFrame's margins. |
void |
setAnchoringType(byte value)
Returns or sets vertical anchor text in a TextFrameEx.
|
void |
setAutofitType(byte value)
Returns or sets text's autofit mode.
|
void |
setCenterText(byte value)
If NullableBool.True then text should be centered in box horizontally.
|
void |
setColumnCount(int value)
Returns or sets number of columns in the text area.
|
void |
setColumnSpacing(double value)
Returns or sets the space between text columns in the text area (in points).
|
void |
setMarginBottom(double value)
Returns or sets the bottom margin (points) in a TextFrame.
|
void |
setMarginLeft(double value)
Returns or sets the left margin (points) in a TextFrame.
|
void |
setMarginRight(double value)
Returns or sets the right margin (points) in a TextFrame.
|
void |
setMarginTop(double value)
Returns or sets the top margin (points) in a TextFrame.
|
void |
setRotationAngle(float value)
Specifies custom the rotation that is being applied to the text within the bounding box.
|
void |
setTextVerticalType(byte value)
Determines text orientation.
|
void |
setWrapText(byte value)
<b>True</b> if text is wrapped at TextFrame's margins. |
equals, getParent_Immediate, getParent_IPresentationComponent, getParent_ISlideComponent, getPresentation, getSlide, getVersion, hashCode, reset_Parent_IPresentationComponent
public TextFrameFormat()
Initializes a new instance of TextFrameFormat
class.
public final ITextStyle getTextStyle()
Returns text's style.
Read-only ITextStyle
.
getTextStyle
in interface ITextFrameFormat
public final double getMarginLeft()
Returns or sets the left margin (points) in a TextFrame.
Read/write double
.
getMarginLeft
in interface IChartTextBlockFormat
getMarginLeft
in interface ITextFrameFormat
public final void setMarginLeft(double value)
Returns or sets the left margin (points) in a TextFrame.
Read/write double
.
setMarginLeft
in interface IChartTextBlockFormat
setMarginLeft
in interface ITextFrameFormat
public final double getMarginRight()
Returns or sets the right margin (points) in a TextFrame.
Read/write double
.
getMarginRight
in interface IChartTextBlockFormat
getMarginRight
in interface ITextFrameFormat
public final void setMarginRight(double value)
Returns or sets the right margin (points) in a TextFrame.
Read/write double
.
setMarginRight
in interface IChartTextBlockFormat
setMarginRight
in interface ITextFrameFormat
public final double getMarginTop()
Returns or sets the top margin (points) in a TextFrame.
Read/write double
.
getMarginTop
in interface IChartTextBlockFormat
getMarginTop
in interface ITextFrameFormat
public final void setMarginTop(double value)
Returns or sets the top margin (points) in a TextFrame.
Read/write double
.
setMarginTop
in interface IChartTextBlockFormat
setMarginTop
in interface ITextFrameFormat
public final double getMarginBottom()
Returns or sets the bottom margin (points) in a TextFrame.
Read/write double
.
getMarginBottom
in interface IChartTextBlockFormat
getMarginBottom
in interface ITextFrameFormat
public final void setMarginBottom(double value)
Returns or sets the bottom margin (points) in a TextFrame.
Read/write double
.
setMarginBottom
in interface IChartTextBlockFormat
setMarginBottom
in interface ITextFrameFormat
public final byte getWrapText()
<b>True</b>
if text is wrapped at TextFrame's margins.
Read/write NullableBool
.
getWrapText
in interface IChartTextBlockFormat
getWrapText
in interface ITextFrameFormat
public final void setWrapText(byte value)
<b>True</b>
if text is wrapped at TextFrame's margins.
Read/write NullableBool
.
setWrapText
in interface IChartTextBlockFormat
setWrapText
in interface ITextFrameFormat
public final byte getAnchoringType()
Returns or sets vertical anchor text in a TextFrameEx.
Read/write TextAnchorType
.
getAnchoringType
in interface IChartTextBlockFormat
getAnchoringType
in interface ITextFrameFormat
public final void setAnchoringType(byte value)
Returns or sets vertical anchor text in a TextFrameEx.
Read/write TextAnchorType
.
setAnchoringType
in interface IChartTextBlockFormat
setAnchoringType
in interface ITextFrameFormat
public final byte getCenterText()
If NullableBool.True then text should be centered in box horizontally.
Read/write NullableBool
.
getCenterText
in interface IChartTextBlockFormat
getCenterText
in interface ITextFrameFormat
public final void setCenterText(byte value)
If NullableBool.True then text should be centered in box horizontally.
Read/write NullableBool
.
setCenterText
in interface IChartTextBlockFormat
setCenterText
in interface ITextFrameFormat
public final byte getTextVerticalType()
Determines text orientation.
The resulted value of visual text rotation summarized from this property and custom angle
in property RotationAngle.
Read/write TextVerticalType
.
getTextVerticalType
in interface IChartTextBlockFormat
getTextVerticalType
in interface ITextFrameFormat
public final void setTextVerticalType(byte value)
Determines text orientation.
The resulted value of visual text rotation summarized from this property and custom angle
in property RotationAngle.
Read/write TextVerticalType
.
setTextVerticalType
in interface IChartTextBlockFormat
setTextVerticalType
in interface ITextFrameFormat
public final byte getAutofitType()
Returns or sets text's autofit mode.
Read/write TextAutofitType
.
getAutofitType
in interface IChartTextBlockFormat
getAutofitType
in interface ITextFrameFormat
public final void setAutofitType(byte value)
Returns or sets text's autofit mode.
Read/write TextAutofitType
.
setAutofitType
in interface IChartTextBlockFormat
setAutofitType
in interface ITextFrameFormat
public final int getColumnCount()
Returns or sets number of columns in the text area.
This value must be a positive number. Otherwise, the value will be set to zero.
Value 0 means undefined value.
Read/write int
.
getColumnCount
in interface ITextFrameFormat
public final void setColumnCount(int value)
Returns or sets number of columns in the text area.
This value must be a positive number. Otherwise, the value will be set to zero.
Value 0 means undefined value.
Read/write int
.
setColumnCount
in interface ITextFrameFormat
public final double getColumnSpacing()
Returns or sets the space between text columns in the text area (in points). This should only apply
when there is more than 1 column present.
This value must be a positive number. Otherwise, the value will be set to zero.
Read/write double
.
getColumnSpacing
in interface ITextFrameFormat
public final void setColumnSpacing(double value)
Returns or sets the space between text columns in the text area (in points). This should only apply
when there is more than 1 column present.
This value must be a positive number. Otherwise, the value will be set to zero.
Read/write double
.
setColumnSpacing
in interface ITextFrameFormat
public final float getRotationAngle()
Specifies custom the rotation that is being applied to the text within the bounding box. If it not
specified, the rotation of the accompanying shape is used. If it is specified, then this is
applied independently from the shape. That is the shape can have a rotation applied in
addition to the text itself having a rotation applied to it.
The resulted value of visual text rotation summarized from this property and predefined
vertical type in property TextVerticalType.
Read/write float
.
Consider the case where a shape has a rotation of 90 degrees clockwise applied to it. In addition to this, the text body itself has a rotation of -90 degrees counter-clockwise applied to it. Then the resulting shape would appear to be rotated but the text within it would appear as though it had not been rotated at all.
getRotationAngle
in interface IChartTextBlockFormat
getRotationAngle
in interface ITextFrameFormat
public final void setRotationAngle(float value)
Specifies custom the rotation that is being applied to the text within the bounding box. If it not
specified, the rotation of the accompanying shape is used. If it is specified, then this is
applied independently from the shape. That is the shape can have a rotation applied in
addition to the text itself having a rotation applied to it.
The resulted value of visual text rotation summarized from this property and predefined
vertical type in property TextVerticalType.
Read/write float
.
Consider the case where a shape has a rotation of 90 degrees clockwise applied to it. In addition to this, the text body itself has a rotation of -90 degrees counter-clockwise applied to it. Then the resulting shape would appear to be rotated but the text within it would appear as though it had not been rotated at all.
setRotationAngle
in interface IChartTextBlockFormat
setRotationAngle
in interface ITextFrameFormat
public final ITextFrameFormatEffectiveData getEffective()
Gets effective text frame formatting data with the inheritance applied.
This example demonstrates getting some of effective text frame formatting properties.Presentation pres = new Presentation("MyPresentation.pptx"); try { IAutoShape shape = (IAutoShape)pres.getSlides().get_Item(0).getShapes().get_Item(0); ITextFrameFormatEffectiveData effectiveTextFrameFormat = shape.getTextFrame().getTextFrameFormat().getEffective(); System.out.println("Anchoring type: " + effectiveTextFrameFormat.getAnchoringType()); System.out.println("Autofit type: " + effectiveTextFrameFormat.getAutofitType()); System.out.println("Text vertical type: " + effectiveTextFrameFormat.getTextVerticalType()); System.out.println("Margins"); System.out.println(" Left: " + effectiveTextFrameFormat.getMarginLeft()); System.out.println(" Top: " + effectiveTextFrameFormat.getMarginTop()); System.out.println(" Right: " + effectiveTextFrameFormat.getMarginRight()); System.out.println(" Bottom: " + effectiveTextFrameFormat.getMarginBottom()); } finally { if (pres != null) pres.dispose(); }
getEffective
in interface ITextFrameFormat
ITextFrameFormatEffectiveData
.