GeoPlacemark (iObjects Java Help)

java.lang.Object
- com.supermap.data.InternalHandle
- - com.supermap.data.InternalHandleDisposable
  - - com.supermap.data.Geometry
    - - com.supermap.data.Geometry3D
      - com.supermap.data.GeoPlacemark

所有已实现的接口:

IDisposable
```
public class GeoPlacemark
extends Geometry3D
```
三维地标几何对象类。
该类继承于 Geometry3D 类，主要用来在三维场景窗口中指定位置处放置几何对象并标注相应的名称。
该类仅在 Windows、Linux 平台版本中支持。
注意：该类的对象调用 getGeoModel() 方法无效，即返回值为null。

对于三维地标几何对象可设置其名称、名称显示的风格以及所关联的几何对象。根据三维地标几何对象所关联的几何对象的不同，三维地标几何对象在三维场景窗口中的显示有所差异，主要分为两种形式：
- 当三维地标几何对象所关联的几何对象是点对象时，那么在三维场景窗口中的指定位置处将显示该点对象，同时，根据指定的风格显示三维地标几何对象的名称，其中，指定的位置即为该点对象的坐标。
- 当三维地标几何对象所关联的几何对象是点对象以外的其他几何对象时，那么在三维场景窗口中的指定位置处将只显示该几何对象，而不显示三维地标几何对象的名称。
示范代码:
以下代码示范如何构造一个三维几何地标对象，并将其添加到三维几何要素集合中。
```
 public void geoPlacemarkTest() {
        // 实例化圆锥体几何对象，并对其进行设置
        GeoCone geoCone=new GeoCone();
        geoCone.setPosition(new Point3D(100, 100, 100));
        geoCone.setBottomRadius(50);
        geoCone.setHeight(150);

        // 构造一个三维几何地标对象并进行相应设置
        GeoPlacemark geoPlacemark = new GeoPlacemark();
        geoPlacemark.setName("Mark");
        geoPlacemark.setGeometry(geoCone);
        geoPlacemark.setNameStyle(new TextStyle());

        // 将三维地标几何对象添加到三维几何要素集合中，假设返回的三维图层为 KML 图层
        SceneControl sceneControl = new SceneControl();
        Layer3D layer3D = sceneControl.getScene().getLayers().get(0);
        Feature3Ds feature3Ds = layer3D.getFeatures();
        feature3Ds.add(geoPlacemark);

        // 释放三维地标对象、三维要素对象
        geoPlacemark.dispose();
        feature3Ds.dispose();
        geoCone.dispose();
    }
 
```

构造器概要

构造器
构造器和说明
`GeoPlacemark()` 构造一个新的 GeoPlacemark 对象。
`GeoPlacemark(GeoPlacemark geoPlacemark)` 根据给定的 GeoPlacemark 对象构造一个与其完全相同的新对象。
`GeoPlacemark(String name, Geometry geometry)` 根据指定的参数来构造一个 GeoPlacemark 的新对象。

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`GeoPlacemark`	`clone()` 克隆一个Geometry对象。
`void`	`dispose()` 释放该对象所占用的资源。
`Geometry`	`getGeometry()` 返回三维地标几何对象所对应的几何对象。
`String`	`getName()` 返回三维地标几何对象的名称，该名称将显示在三维场景窗口中的指定位置。
`TextStyle`	`getNameStyle()` 返回三维地标几何对象的名称在显示时的文本风格。
`void`	`setGeometry(Geometry value)` 设置三维地标几何对象所对应的几何对象。
`void`	`setName(String value)` 设置三维地标几何对象的名称，该名称将显示在三维场景窗口中的指定位置。
`void`	`setNameStyle(TextStyle textStyle)` 设置三维地标几何对象的名称在显示时的文本风格。

从类继承的方法 com.supermap.data.Geometry3D
convertToGeoModel3D, convertToGeoModel3D, convertToGeoModel3D, getBoundingBox, getGeoModel, getInnerPoint3D, getPosition, getRotationX, getRotationY, getRotationZ, getScaleX, getScaleY, getScaleZ, getStyle3D, getVolume, offset, setPosition, setRotationX, setRotationY, setRotationZ, setScaleX, setScaleY, setScaleZ, setStyle3D

从类继承的方法 com.supermap.data.Geometry
addCustomGeometryCreatedListener, fromXML, getBounds, getID, getInnerPoint, getStyle, getType, getVariantID, hitTest, isEmpty, mirror, offset, removeCustomGeometryCreatedListener, resize, rotate, setBounds, setEmpty, setID, setStyle, toXML

从类继承的方法 com.supermap.data.InternalHandleDisposable
makeSureNativeObjectLive

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - GeoPlacemark
```
public GeoPlacemark()
```
    构造一个新的 GeoPlacemark 对象。
  - GeoPlacemark
```
public GeoPlacemark(GeoPlacemark geoPlacemark)
```
    根据给定的 GeoPlacemark 对象构造一个与其完全相同的新对象。
    
    参数:
    
    geoPlacemark - 给定的 GeoPlacemark 对象。
  - GeoPlacemark
```
public GeoPlacemark(String name,
                    Geometry geometry)
```
    根据指定的参数来构造一个 GeoPlacemark 的新对象。
    
    参数:
    
    name - 指定的三维地标几何对象的名称。
    
    geometry - 三维地标几何对象所对应的几何对象。
- 方法详细资料
  - getName
```
public String getName()
```
    返回三维地标几何对象的名称，该名称将显示在三维场景窗口中的指定位置。
    对于三维地标几何对象可设置其名称、名称显示的风格以及所关联的几何对象。根据三维地标几何对象所关联的几何对象的不同，三维地标几何对象在三维场景窗口中的显示有所差异，主要分为两种形式：
    - 当三维地标几何对象所关联的几何对象是点对象时，那么在三维场景窗口中的指定位置处将显示该点对象，同时，根据指定的风格显示三维地标几何对象的名称，其中，指定的位置即为该点对象的坐标。
    - 当三维地标几何对象所关联的几何对象是点对象以外的其他几何对象时，那么在三维场景窗口中的指定位置处将只显示该几何对象，而不显示三维地标几何对象的名称。
    返回:
    
    三维地标几何对象的名称。
    
    默认值:
    
    默认值为 "UntitledPlacemark"。
  - setName
```
public void setName(String value)
```
    设置三维地标几何对象的名称，该名称将显示在三维场景窗口中的指定位置。
    对于三维地标几何对象可设置其名称、名称显示的风格以及所关联的几何对象。根据三维地标几何对象所关联的几何对象的不同，三维地标几何对象在三维场景窗口中的显示有所差异，主要分为两种形式：
    - 当三维地标几何对象所关联的几何对象是点对象时，那么在三维场景窗口中的指定位置处将显示该点对象，同时，根据指定的风格显示三维地标几何对象的名称，其中，指定的位置即为该点对象的坐标。
    - 当三维地标几何对象所关联的几何对象是点对象以外的其他几何对象时，那么在三维场景窗口中的指定位置处将只显示该几何对象，而不显示三维地标几何对象的名称。
    参数:
    
    value - 三维地标几何对象的名称。
  - getGeometry
```
public Geometry getGeometry()
```
    返回三维地标几何对象所对应的几何对象。该几何对象可以作为三维要素对象显示在三维场景窗口中，同时，该几何对象还用来确定三维地标几何对象名称所显示的位置。
    对于三维地标几何对象可设置其名称、名称显示的风格以及所关联的几何对象。根据三维地标几何对象所关联的几何对象的不同，三维地标几何对象在三维场景窗口中的显示有所差异，主要分为两种形式：
    - 当三维地标几何对象所关联的几何对象是点对象时，那么在三维场景窗口中的指定位置处将显示该点对象，同时，根据指定的风格显示三维地标几何对象的名称，其中，指定的位置即为该点对象的坐标。
    - 当三维地标几何对象所关联的几何对象是点对象以外的其他几何对象时，那么在三维场景窗口中的指定位置处将只显示该几何对象，而不显示三维地标几何对象的名称。
    返回:
    
    三维地标几何对象所对应的几何对象。
    
    默认值:
    
    默认值为空。
  - setGeometry
```
public void setGeometry(Geometry value)
```
    设置三维地标几何对象所对应的几何对象。该几何对象可以作为三维要素对象显示在三维场景窗口中，同时，该几何对象还用来确定三维地标几何对象名称所显示的位置。
    对于三维地标几何对象可设置其名称、名称显示的风格以及所关联的几何对象。根据三维地标几何对象所关联的几何对象的不同，三维地标几何对象在三维场景窗口中的显示有所差异，主要分为两种形式：
    - 当三维地标几何对象所关联的几何对象是点对象时，那么在三维场景窗口中的指定位置处将显示该点对象，同时，根据指定的风格显示三维地标几何对象的名称，其中，指定的位置即为该点对象的坐标。
    - 当三维地标几何对象所关联的几何对象是点对象以外的其他几何对象时，那么在三维场景窗口中的指定位置处将只显示该几何对象，而不显示三维地标几何对象的名称。
    注意：如果要设置的几何对象的类型与原几何对象的类型不相同，那么原几何对象会被释放。
    参数:
    
    geometry - 三维地标几何对象所对应的几何对象。
  - getNameStyle
```
public TextStyle getNameStyle()
```
    返回三维地标几何对象的名称在显示时的文本风格。
    对于三维地标几何对象可设置其名称、名称显示的风格以及所关联的几何对象。根据三维地标几何对象所关联的几何对象的不同，三维地标几何对象在三维场景窗口中的显示有所差异，主要分为两种形式：
    - 当三维地标几何对象所关联的几何对象是点对象时，那么在三维场景窗口中的指定位置处将显示该点对象，同时，根据指定的风格显示三维地标几何对象的名称，其中，指定的位置即为该点对象的坐标。
    - 当三维地标几何对象所关联的几何对象是点对象以外的其他几何对象时，那么在三维场景窗口中的指定位置处将只显示该几何对象，而不显示三维地标几何对象的名称。
    返回:
    
    三维地标几何对象的名称在显示时的文本风格。
    
    默认值:
    
    默认值为{Alignment=TopLeft,BackColor=Color [A=255, R=0, G=0, B=0],BackOpaque=False,Bold=False,FontHeight=6,FontWidth=0,ForeColor=Color [A=255, R=255, G=255, B=255],IsSizeFixed=False,Italic=False,Outline=False,Rotation=0,Shadow=False,Strikeout=False,Underline=False,Weight=0}
  - setNameStyle
```
public void setNameStyle(TextStyle textStyle)
```
    设置三维地标几何对象的名称在显示时的文本风格。
    对于三维地标几何对象可设置其名称、名称显示的风格以及所关联的几何对象。根据三维地标几何对象所关联的几何对象的不同，三维地标几何对象在三维场景窗口中的显示有所差异，主要分为两种形式：
    - 当三维地标几何对象所关联的几何对象是点对象时，那么在三维场景窗口中的指定位置处将显示该点对象，同时，根据指定的风格显示三维地标几何对象的名称，其中，指定的位置即为该点对象的坐标。
    - 当三维地标几何对象所关联的几何对象是点对象以外的其他几何对象时，那么在三维场景窗口中的指定位置处将只显示该几何对象，而不显示三维地标几何对象的名称。
    注意：该方法参数为 TextStyle 类对象，针对三维地标几何对象名称的文本风格字段设置来说，只有 TextStyle 类对象的setForeColor()、setFontScale()、setOpaqueRate() 方法有效。
    参数:
    
    textStyle - 三维地标几何对象的名称在显示时的文本风格。
  - clone
```
public GeoPlacemark clone()
```
    从类复制的说明: Geometry
    
    克隆一个Geometry对象。
    
    指定者:
    
    clone 在类中 Geometry
    
    返回:
    
    克隆的Geometry对象。
  - dispose
```
public void dispose()
```
    从类复制的说明: Geometry
    
    释放该对象所占用的资源。当调用该方法之后，此对象不再可用。
    
    指定者:
    
    dispose 在接口中 IDisposable
    
    指定者:
    
    dispose 在类中 Geometry

类 GeoPlacemark

构造器概要

方法概要

从类继承的方法 com.supermap.data.Geometry3D

从类继承的方法 com.supermap.data.Geometry

从类继承的方法 com.supermap.data.InternalHandleDisposable

从类继承的方法 java.lang.Object

构造器详细资料

GeoPlacemark

GeoPlacemark

GeoPlacemark

方法详细资料

getName

setName

getGeometry

setGeometry

getNameStyle

setNameStyle

clone

dispose