public class TextStyle
extends com.supermap.data.InternalHandleDisposable
public void textStyleTest(){ // 假设打开一个工作空间 workspace 对象 // 设置文本风格 TextStyle textStyle = new TextStyle(); textStyle.setRotation(30.0); textStyle.setShadow(true); textStyle.setAlignment(TextAlignment.TOPCENTER); textStyle.setBackColor(java.awt.Color.BLUE); textStyle.setForeColor(java.awt.Color.BLACK); textStyle.setBackOpaque(true); textStyle.setBold(true); textStyle.setFontName("宋体"); textStyle.setFontHeight(100.0); textStyle.setFontWidth(100.0); textStyle.setSizeFixed(true); textStyle.setItalic(true); textStyle.setOutline(true); textStyle.setStrikeout(true); textStyle.setUnderline(true); textStyle.setWeight(500); System.out.println("文本风格为:"+ textStyle.toString()); // 将文本风格应用于文本对象 GeoText geotext = new GeoText(); TextPart part = new TextPart("SuperMap", new Point2D(150, 150), 10.0); geotext.addPart(part); geotext.setTextStyle(textStyle); // 实例化 Map 对象 Map map = new Map(workspace); // 将文本对象添加到地图的跟踪图层,出图显示 map.getTrackingLayer().add(geotext, ""); map.setViewBounds(new Rectangle2D(new Point2D(0, 0), new Point2D(300, 300))); map.outputMapToJPG("G:/world/textstyle"); // 释放资源 part.dispose(); geotext.dispose(); textStyle.dispose(); workspace.dispose(); }
构造器和说明 |
---|
TextStyle()
构造一个新的 TextStyle 对象。
|
TextStyle(TextStyle textStyle)
根据给定的 TextStyle 对象构造一个与其完全相同的新对象。
|
限定符和类型 | 方法和说明 |
---|---|
TextStyle |
clone()
返回当前 GeoBox 对象的一个拷贝。
|
void |
dispose()
释放该对象所占用的资源。
|
boolean |
fromXML(String xml)
根据传入的 XML 字符串重新构造该
TextStyle 对象。 |
TextAlignment |
getAlignment()
返回文本的对齐方式。
|
Color |
getBackColor()
返回文本的背景色。
|
boolean |
getBackOpaque()
返回文本背景是否不透明,true 表示文本背景不透明。
|
boolean |
getBold()
返回文本是否为粗体字,true 表示为粗体。
|
int |
getBorderSpacingWidth()
返回文字背景矩形框边缘与文字边缘的间隔,单位为:像素。
|
double |
getFontHeight()
返回文本字体的高度。
|
String |
getFontName()
返回文本字体的名称。
|
double |
getFontScale()
返回注记字体的缩放比例。
|
double |
getFontWidth()
返回文本的宽度。
|
Color |
getForeColor()
返回文本的前景色。
|
boolean |
getItalic()
返回文本是否采用斜体,true 表示采用斜体。
|
double |
getItalicAngle()
返回字体倾斜角度,正负度之间,以度为单位,精确到0.1度。
|
double |
getLineSpacingParameter()
返回行距参数值。
|
TextLineSpacingType |
getLineSpacingType()
返回文本行距类型。
|
int |
getOpaqueRate()
返回注记文字的不透明度。
|
boolean |
getOutline()
返回是否以轮廓的方式来显示文本的背景。
|
int |
getOutlineWidth()
返回文本轮廓的宽度,数值的单位为:像素,数值范围是从0到5之间的任意整数。
|
double |
getRotation()
返回文本旋转的角度。
|
boolean |
getShadow()
返回文本是否有阴影。
|
Color |
getShadowColor()
返回阴影色
|
double |
getShadowOffsetX() |
double |
getShadowOffsetY() |
boolean |
getStrikeout()
返回文本字体是否加删除线。
|
StringAlignment |
getStringAlignment()
返回文本的排版方式,可以对多行文本设置左对齐、右对齐、居中对齐、两端对齐。
|
boolean |
getUnderline()
返回文本字体是否加下划线。
|
int |
getWeight()
返回文本字体的磅数,表示粗体的具体数值。
|
boolean |
isIgnoreSpacesBothEnds() |
boolean |
isSizeFixed()
返回文本大小是否固定。
|
void |
setAlignment(TextAlignment textAlignment)
设置文本的对齐方式。
|
void |
setBackColor(Color value)
设置文本的背景色。
|
void |
setBackOpaque(boolean value)
设置文本背景是否不透明,true 表示文本背景不透明。
|
void |
setBold(boolean value)
设置文本是否为粗体字,true 表示为粗体。
|
void |
setBorderSpacingWidth(int value)
设置文字背景矩形框边缘与文字边缘的间隔,单位为:像素。
|
void |
setFontHeight(double value)
设置文本字体的高度。
|
void |
setFontName(String value)
设置文本字体的名称。
|
void |
setFontScale(double value)
设置注记字体的缩放比例。
|
void |
setFontWidth(double value)
设置文本的宽度。
|
void |
setForeColor(Color value)
设置文本的前景色。
|
void |
setIgnoreSpacesBothEnds(boolean value) |
void |
setItalic(boolean value)
设置文本是否采用斜体,true 表示采用斜体。
|
void |
setItalicAngle(double value)
设置字体倾斜角度,正负度之间,以度为单位,精确到0.1度。
|
void |
setLineSpacingParameter(double value)
设置行距参数值。
|
void |
setLineSpacingType(TextLineSpacingType type)
设置文本行距类型。
|
void |
setOpaqueRate(int value)
设置注记文字的不透明度。
|
void |
setOutline(boolean value)
设置是否以轮廓的方式来显示文本的背景。
|
void |
setOutlineWidth(int value)
设置文本轮廓的宽度,数值的单位为:像素,数值范围是从0到5之间的任意整数,其中设置为0值时表示没有轮廓。
|
void |
setRotation(double value)
设置文本旋转的角度。
|
void |
setShadow(boolean value)
设置文本是否有阴影。
|
void |
setShadowColor(Color value)
设置阴影色
|
void |
setShadowOffsetX(double value) |
void |
setShadowOffsetY(double value) |
void |
setSizeFixed(boolean value)
设置文本大小是否固定。
|
void |
setStrikeout(boolean value)
设置文本字体是否加删除线。
|
void |
setStringAlignment(StringAlignment stringAlignment)
设置文本的排版方式,可以对多行文本设置左对齐、右对齐、居中对齐、两端对齐。
|
void |
setUnderline(boolean value)
设置文本字体是否加下划线。
|
void |
setWeight(int value)
设置文本字体的磅数,表示粗体的具体数值。
|
String |
toString()
返回一个表示此文本风格类对象的格式化字符串。
|
String |
toXML()
返回表示
TextStyle 对象的 XML 字符串。 |
public void dispose()
public TextAlignment getAlignment()
TextAlignment
对象。EnumConstantNotPresentException
- 如果返回的文本对齐方式不是 TextAlignment
类中的常量。TextAlignment.TOPLEFT
)。public void setAlignment(TextAlignment textAlignment)
当 setAlignment()
的参数不是 TextAlignment
类中的常量时,则抛出 EnumConstantNotPresentException 异常。
value
- 指定文本的对齐方式。EnumConstantNotPresentException
- 如果设置的文本对齐方式不是 TextAlignment
类中的常量。public StringAlignment getStringAlignment()
public void setStringAlignment(StringAlignment stringAlignment)
stringAlignment
- IllegalStateException
- 当前对象已被释放IllegalArgumentException
- 非法参数public Color getBackColor()
public void setBackColor(Color value)
value
- 文本的背景色。public boolean getBold()
public void setBold(boolean value)
value
- 指定文本是否为粗体字。public Color getForeColor()
public void setForeColor(Color value)
value
- 文本的前景色。public boolean isSizeFixed()
public void setSizeFixed(boolean value)
value
- 指定文本大小是否固定。public double getFontHeight()
public void setFontHeight(double value)
value
- 文本字体的高度。public double getFontWidth()
public void setFontWidth(double value)
value
- 文本的宽度。public String getFontName()
如果在Windows平台下对地图中的文本图层指定了某种字体,并且该地图数据需要在Linux平台下进行应用,那么请确保您的Linux平台下也存在同样的字体,否则,文本图层的字体显示效果会有问题。
public void setFontName(String value)
如果在Windows平台下对地图中的文本图层指定了某种字体,并且该地图数据需要在Linux平台下进行应用,那么请确保您的Linux平台下也存在同样的字体,否则,文本图层的字体显示效果会有问题。
value
- 文本字体的名称。public boolean getItalic()
public void setItalic(boolean value)
value
- 指定注记是否采用斜体。public double getItalicAngle()
正负度是指以纵轴为起始零度线,其纵轴左侧为正,右侧为负。允许的最大角度为60,最小-60。大于60按照60处理,小于-60按照-60处理。如图所示,字体倾斜角度在正负30度时的效果。
目前只对标签专题图有效。
public void setItalicAngle(double value)
正负度是指以纵轴为起始零度线,其纵轴左侧为正,右侧为负。允许的最大角度为60,最小-60。大于60按照60处理,小于-60按照-60处理。如图所示,字体倾斜角度在正负30度时的效果。
目前只对标签专题图有效。
value
- 字体倾斜角度。public boolean getOutline()
public void setOutline(boolean value)
value
- 指定是否以轮廓的方式来显示文本的背景。public double getRotation()
文本对象通过数据引擎存储后返回的旋转角度,精度为 0.1 度;通过构造函数直接构造的文本对象,返回的旋转角度精度不变。
public void setRotation(double value)
value
- 文本旋转的角度。public boolean getShadow()
public void setShadow(boolean value)
value
- 指定文本是否有阴影。public boolean getStrikeout()
public void setStrikeout(boolean value)
value
- 文本字体是否加删除线。public boolean isIgnoreSpacesBothEnds()
IllegalStateException
public void setIgnoreSpacesBothEnds(boolean value)
value
- boolean 是否忽略两端空白字符,True 表示忽略两端空白字符,False表示不忽略两端空白字符。IllegalStateException
public boolean getBackOpaque()
public void setBackOpaque(boolean value)
value
- 指定文本背景是否不透明。public boolean getUnderline()
public void setUnderline(boolean value)
value
- 指定文本字体是否加下划线。public int getWeight()
public void setWeight(int value)
value
- 文本字体的磅数。public double getFontScale()
public void setFontScale(double value)
value
- 注记字体的缩放比例。public int getOpaqueRate()
public void setOpaqueRate(int value)
value
- 注记文字的不透明度。public int getOutlineWidth()
public void setOutlineWidth(int value)
必须通过方法 TextStyle.setOutline(true) 传入true值,文本轮廓的宽度设置才有效。
value
- 文本轮廓的宽度,数值的单位为:像素,数值范围是从0到5之间的任意整数,其中设置为0值时表示没有轮廓。public int getBorderSpacingWidth()
public void setBorderSpacingWidth(int value)
value
- 文字背景矩形框边缘与文字边缘的间隔,单位为:像素。public double getShadowOffsetX()
public void setShadowOffsetX(double value)
public double getShadowOffsetY()
public void setShadowOffsetY(double value)
public TextLineSpacingType getLineSpacingType()
TextStyle.setLineSpacingParameter
共同决定行间距离。
TextLineSpacingType.MULTIPLE
),默认行距参数值为1.0。IllegalStateException
- 当前对象已被释放public void setLineSpacingType(TextLineSpacingType type)
TextStyle.setLineSpacingParameter
共同决定行间距离。
TextLineSpacingType.MULTIPLE
),默认行距参数值为1.0。type
- 文本行距类型。IllegalStateException
- 当前对象已被释放public double getLineSpacingParameter()
TextStyle.setLineSpacingParameter
共同决定行间距离。
TextLineSpacingType.MULTIPLE
),默认行距参数值为1.0。
TextLineSpacingType.MULTIPLE
,多倍行距,行距参数值单位:倍,表示系统默认行距的倍数。
TextLineSpacingType.ADD
,附加行距,行距参数值表示系统默认行距额外增加的行间距离,数值单位与文本是否开启固定大小设置有关,如果开启(TextStyle.isSizeFixed()
返回值为true),数值单位为毫米;未开启(TextStyle.isSizeFixed()
返回值为false),数值单位与地图坐标系单位一致。
TextLineSpacingType.FIXED
,固定行距,行距参数值表示行间距离值,数值单位与文本是否开启固定大小设置有关,如果开启(TextStyle.isSizeFixed()
返回值为true),数值单位为毫米;未开启(TextStyle.isSizeFixed()
返回值为false),数值单位与地图坐标系单位一致。IllegalStateException
- 当前对象已被释放public void setLineSpacingParameter(double value)
TextStyle.setLineSpacingParameter
共同决定行间距离。
TextLineSpacingType.MULTIPLE
),默认行距参数值为1.0。
TextLineSpacingType.MULTIPLE
,多倍行距,行距参数值单位:倍,表示系统默认行距的倍数。
TextLineSpacingType.ADD
,附加行距,行距参数值表示系统默认行距额外增加的行间距离,数值单位与文本是否开启固定大小设置有关,如果开启(TextStyle.isSizeFixed()
返回值为true),数值单位为毫米;未开启(TextStyle.isSizeFixed()
返回值为false),数值单位与地图坐标系单位一致。
TextLineSpacingType.FIXED
,固定行距,行距参数值表示行间距离值,数值单位与文本是否开启固定大小设置有关,如果开启(TextStyle.isSizeFixed()
返回值为true),数值单位为毫米;未开启(TextStyle.isSizeFixed()
返回值为false),数值单位与地图坐标系单位一致。value
- 行距参数值。IllegalArgumentException
- 输入的行距参数值为负数时抛出的异常。IllegalStateException
- 当前对象已被释放public Color getShadowColor()
IllegalStateException
- 当前对象已被释放public void setShadowColor(Color value)
value
- 文本阴影颜色IllegalStateException
- 当前对象已被释放public TextStyle clone()
public boolean fromXML(String xml)
TextStyle
对象。xml
- 指定的 XML 字符串。Copyright © 2021–2024 SuperMap. All rights reserved.