com.supermap.data
类 TextStyle
- java.lang.Object
-
- com.supermap.data.TextStyle
-
public class TextStyle extends java.lang.Object- Example:
- 以下代码示范如何将自定义的文本风格应用于文本对象,并将文本对象输出为 PNG 图片。
public void textStyleTest() { // 假设打开一个工作空间 <a href="Workspace.html">workspace</a> 对象,并有相应MapControl对象 // 设置文本风格 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 = mapControl.getMap(); // 将文本对象添加到地图的跟踪图层,出图显示 map.getTrackingLayer().add(geotext, ""); map.setViewBounds(new Rectangle2D(new Point2D(0, 0), new Point2D(300,300))); Bitmap bitmap = Bitmap.createBitmap(256, 256, Config.ARGB_8888); mapControl.outputMap(bitmap); String rootPath = android.os.Environment.getExternalStorageDirectory().getAbsolutePath(); String path = rootPath + "/textstyle"; try{ FileOutputStream out = new FileOutputStream(path); bitmap.compress(Bitmap.CompressFormat.PNG, 100, out); } catch(Exception e){ e.printStackTrace(); } // 释放资源 part.dispose(); geotext.dispose(); textStyle.dispose(); mapControl.dispose(); workspace.dispose(); }
-
-
构造器概要
构造器 构造器和说明 TextStyle()构造一个新的 TextStyle 对象。TextStyle(TextStyle textStyle)根据给定的 TextStyle 对象构造一个与其完全相同的新对象。
-
方法概要
所有方法 静态方法 实例方法 具体方法 已过时的方法 限定符和类型 方法和说明 TextStyleclone()返回当前 TextStyle 对象的一个拷贝。voiddispose()释放该对象所占用的资源。static booleandrawToPNG(Geometry geometry, Resources resources, java.lang.String fileName, int width, int height)将指定的几何对象绘制成图片。TextAlignmentgetAlignment()返回文本的对齐方式。ColorgetBackColor()返回文本的背景色。intgetBackTransparency()获取背景半透明度。doublegetFontHeight()返回文本字体的高度。java.lang.StringgetFontName()返回文本字体的名称。doublegetFontScale()获取注记字体的缩放比例。doublegetFontWidth()返回文本的宽度。ColorgetForeColor()返回文本的前景色。booleangetItalic()返回文本是否采用斜体,true 表示采用斜体。doublegetItalicAngle()返回字体倾斜角度,正负度之间,以度为单位,精确到0.1度。booleangetOutline()返回是否以轮廓的方式来显示文本的背景。voidgetOutlineWidth()获取轮廓线宽度doublegetRotation()返回文本旋转的角度。booleangetShadow()返回文本是否有阴影。booleangetStrikeout()返回文本字体是否加删除线。booleangetUnderline()返回文本字体是否加下划线。intgetWeight()已过时。booleanisBackOpaque()返回注记背景是否透明。booleanisBold()返回注记是否为粗体字。booleanisSizeFixed()返回文本大小是否固定。voidsetAlignment(TextAlignment textAlignment)设置文本的对齐方式。voidsetBackColor(Color value)设置文本的背景色。voidsetBackOpaque(boolean value)设置文本背景是否不透明,true 表示文本背景透明。voidsetBackTransparency(int value)设置背景透明度。voidsetBold(boolean value)设置文本是否为粗体字,true 表示为粗体。voidsetFontHeight(double value)设置文本字体的高度。voidsetFontName(java.lang.String value)设置文本字体的名称。voidsetFontScale(double value)设置注记字体的缩放比例。voidsetFontWidth(double value)设置文本的宽度。voidsetForeColor(Color value)设置文本的前景色。voidsetItalic(boolean value)设置文本是否采用斜体,true 表示采用斜体。voidsetItalicAngle(double value)设置字体倾斜角度,正负度之间,以度为单位,精确到0.1度。voidsetOutline(boolean value)设置是否以轮廓的方式来显示文本的背景。voidsetOutlineWidth(int value)设置轮廓线宽度。voidsetRotation(double value)设置专题图文本旋转角度。voidsetShadow(boolean value)设置文本是否有阴影。voidsetSizeFixed(boolean value)设置文本大小是否固定。voidsetStrikeout(boolean value)设置文本字体是否加删除线。voidsetUnderline(boolean value)设置文本字体是否加下划线。voidsetWeight(int value)已过时。java.lang.StringtoString()返回一个表示此文本风格类对象的格式化字符串。
-
-
-
方法详细资料
-
dispose
public void dispose()
释放该对象所占用的资源。调用该方法之后,此对象不再可用。
-
getAlignment
public TextAlignment getAlignment()
返回文本的对齐方式。- 返回:
- 一个
TextAlignment对象。 - 抛出:
java.lang.EnumConstantNotPresentException- 如果返回的文本对齐方式不是TextAlignment类中的常量。- Default:
- 默认是文本左上角对齐(
TextAlignment.TOPLEFT)。
-
setAlignment
public void setAlignment(TextAlignment textAlignment)
设置文本的对齐方式。当
setAlignment()的参数不是TextAlignment类中的常量时,则抛出 EnumConstantNotPresentException 异常。- 参数:
textAlignment- 指定文本的对齐方式。- 抛出:
java.lang.EnumConstantNotPresentException- 如果设置的文本对齐方式不是TextAlignment类中的常量。
-
getBackColor
public Color getBackColor()
返回文本的背景色。- 返回:
- 文本的背景色。
- Default:
- 默认颜色为黑色。
-
isBackOpaque
public boolean isBackOpaque()
返回注记背景是否透明。- 返回:
- 背景透明返回true;否则返回false。
-
isBold
public boolean isBold()
返回注记是否为粗体字。- 返回:
- 若为粗体则返回true;否则返回false。
-
setBackColor
public void setBackColor(Color value)
设置文本的背景色。- 参数:
value- 文本的背景色。
-
setBold
public void setBold(boolean value)
设置文本是否为粗体字,true 表示为粗体。- 参数:
value- 指定文本是否为粗体字。
-
getForeColor
public Color getForeColor()
返回文本的前景色。- 返回:
- 文本的前景色。
- Default:
- 默认色为黑色。
-
setForeColor
public void setForeColor(Color value)
设置文本的前景色。- 参数:
value- 文本的前景色。
-
isSizeFixed
public boolean isSizeFixed()
返回文本大小是否固定。false,表示文本为非固定尺寸的文本。- 返回:
- 如果文本为固定尺寸,返回 true;否则返回 false。
- Default:
- 默认为 true,表示固定尺寸。
-
setSizeFixed
public void setSizeFixed(boolean value)
设置文本大小是否固定。false,表示文本为非固定尺寸的文本。- 参数:
value- 指定文本大小是否固定。
-
getFontHeight
public double getFontHeight()
返回文本字体的高度。在固定大小时单位为0.1毫米,否则使用地理坐标单位。- 返回:
- 文本字体的高度。
- Default:
- 默认值为 6。
-
setFontHeight
public void setFontHeight(double value)
设置文本字体的高度。在固定大小时单位为0.1毫米,否则使用地理坐标单位。- 参数:
value- 文本字体的高度。
-
getFontWidth
public double getFontWidth()
返回文本的宽度。字体的宽度以英文字符为标准,一个中文字符相当于两个英文字符。在固定大小时单位为0.1毫米,否则使用地理坐标单位。- 返回:
- 文本的宽度。
- Default:
- 默认值为 0。
-
setFontWidth
public void setFontWidth(double value)
设置文本的宽度。字体的宽度以英文字符为标准,一个中文字符相当于两个英文字符。在固定大小时单位为0.1毫米,否则使用地理坐标单位。- 参数:
value- 文本的宽度。
-
getFontName
public java.lang.String getFontName()
返回文本字体的名称。- 返回:
- 文本字体的名称。
- Default:
- 文本字体的名称的默认值为 "Times New Roman"。
-
setFontName
public void setFontName(java.lang.String value)
设置文本字体的名称。- 参数:
value- 文本字体的名称。
-
getItalic
public boolean getItalic()
返回文本是否采用斜体,true 表示采用斜体。- 返回:
- 如果文本采用斜体,返回 true;否则返回 false。
- Default:
- 默认值为 false,即不采用斜体。
-
setItalic
public void setItalic(boolean value)
设置文本是否采用斜体,true 表示采用斜体。- 参数:
value- 指定注记是否采用斜体。
-
getItalicAngle
public double getItalicAngle()
返回字体倾斜角度,正负度之间,以度为单位,精确到0.1度。当倾斜角度为0度,为系统默认的字体倾斜样式。正负度是指以纵轴为起始零度线,其纵轴左侧为正,右侧为负。允许的最大角度为60,最小-60。大于60按照60处理,小于-60按照-60处理。如图所示 ,字体倾斜角度在正负30度时的效果。
目前只对标签专题图有效。
- 返回:
- 字体倾斜角度。
- Default:
- 默认值为 0。
-
setItalicAngle
public void setItalicAngle(double value)
设置字体倾斜角度,正负度之间,以度为单位,精确到0.1度。当倾斜角度为0度,为系统默认的字体倾斜样式。正负度是指以纵轴为起始零度线,其纵轴左侧为正,右侧为负。允许的最大角度为60,最小-60。大于60按照60处理,小于-60按照-60处理。如图所示 ,字体倾斜角度在正负30度时的效果。
目前只对标签专题图有效。
- 参数:
value- 字体倾斜角度。
-
getOutline
public boolean getOutline()
返回是否以轮廓的方式来显示文本的背景。false,表示不以轮廓的方式来显示文本的背景。- 返回:
- 如果是以轮廓的方式来显示文本,则返回 true;否则返回 false。
- Default:
- 默认值为 false,表示不以轮廓的方式来显示文本的背景。
-
setOutline
public void setOutline(boolean value)
设置是否以轮廓的方式来显示文本的背景。false,表示不以轮廓的方式来显示文本的背景。- 参数:
value- 指定是否以轮廓的方式来显示文本的背景。
-
getRotation
public double getRotation()
返回文本旋转的角度。逆时针方向为正方向,单位为度。文本对象通过数据引擎存储后返回的旋转角度,精度为 0.1 度;通过构造函数直接构造的文本对象,返回的旋转角度精度不变。
- 返回:
- 文本旋转的角度。
- Default:
- 默认值为 0.0。
-
setRotation
public void setRotation(double value)
设置专题图文本旋转角度。逆时针方向为正方向,单位为度。 若要对普通文本对象进行旋转角度,可以设置文本对象每个文本子对象的角度,使用TextPart.setRotation()接口- 参数:
value- 文本旋转的角度。
-
getShadow
public boolean getShadow()
返回文本是否有阴影。true 表示给文本增加阴影。- 返回:
- 如果文本有阴影,则返回 true;否则返回 false。
- Default:
- 默认值为 false, 即文本没有阴影。
-
setShadow
public void setShadow(boolean value)
设置文本是否有阴影。true 表示给文本增加阴影。- 参数:
value- 指定文本是否有阴影。
-
getStrikeout
public boolean getStrikeout()
返回文本字体是否加删除线。true 表示加删除线。- 返回:
- 如果文本字体加删除线,则返回 true;否则返回 false。
- Default:
- 默认值为 false,即文本字体不加删除线。
-
setStrikeout
public void setStrikeout(boolean value)
设置文本字体是否加删除线。true 表示加删除线。- 参数:
value- 文本字体是否加删除线。
-
setBackOpaque
public void setBackOpaque(boolean value)
设置文本背景是否不透明,true 表示文本背景透明。- 参数:
value- 指定文本背景是否透明。
-
getUnderline
public boolean getUnderline()
返回文本字体是否加下划线。true 表示加下划线。- 返回:
- 如果文本字体加下划线,则返回 true;否则返回 false。
- Default:
- 默认值为 false,即文本字体不加下划线。
-
setUnderline
public void setUnderline(boolean value)
设置文本字体是否加下划线。true 表示加下划线。- 参数:
value- 指定文本字体是否加下划线。
-
getWeight
@Deprecated public int getWeight()
已过时。返回文本字体的磅数,表示粗体的具体数值。取值范围为从0-900之间的整百数,如400表示正常显示,700表示为粗体,可参见微软 MSDN帮助中关于 LOGFONT 类的介绍。- 返回:
- 文本字体的磅数。
- Default:
- 文本字体的磅数,默认值为400,表示正常显示。
-
setWeight
@Deprecated public void setWeight(int value)
已过时。设置文本字体的磅数,表示粗体的具体数值。取值范围为从0-900之间的整百数,如400表示正常显示,700表示为粗体,可参见微软 MSDN帮助中关于 LOGFONT 类的介绍。- 参数:
value- 文本字体的磅数。
-
clone
public TextStyle clone()
返回当前 TextStyle 对象的一个拷贝。 该对象是此文本风格实例的一个副本。这里的副本是一个深拷贝。- 覆盖:
clone在类中java.lang.Object- 返回:
- 通过克隆操作得到的 TextStyle 对象。
-
toString
public java.lang.String toString()
返回一个表示此文本风格类对象的格式化字符串。- 覆盖:
toString在类中java.lang.Object- 返回:
- 表示此文本风格类对象的字符串。
-
getBackTransparency
public int getBackTransparency()
获取背景半透明度。- 返回:
- 背景半透明度。
-
setBackTransparency
public void setBackTransparency(int value)
设置背景透明度。- 参数:
value- 0~255;0为透明,255为不透明。
-
drawToPNG
public static boolean drawToPNG(Geometry geometry, Resources resources, java.lang.String fileName, int width, int height)
将指定的几何对象绘制成图片。- 参数:
geometry- 几何对象。resources- 关联的资源库。fileName- 出图文件的路径。width- 宽。height- 高。- 返回:
- 绘制成功返回true,否则返回false。
-
getFontScale
public double getFontScale()
获取注记字体的缩放比例。- 返回:
- 缩放比例数值。
-
setFontScale
public void setFontScale(double value)
设置注记字体的缩放比例。- 参数:
value- 指定缩放比例数值。
-
setOutlineWidth
public void setOutlineWidth(int value)
设置轮廓线宽度。- 参数:
value-
-
getOutlineWidth
public void getOutlineWidth()
获取轮廓线宽度
-
-