一个
Property
,它透明地链接到所提供对象上的另一个属性。
Name | Type | Description |
---|---|---|
targetCollection
|
EntityCollection | 将用于解析引用的实体集合。 |
targetId
|
String | 被引用的实体的 id。 |
targetPropertyNames
|
Array.<String> | 我们将使用的目标实体上的属性名称。 |
Example:
const collection = new Cesium.EntityCollection();
//Create a new entity and assign a billboard scale.
const object1 = new Cesium.Entity({id:'object1'});
object1.billboard = new Cesium.BillboardGraphics();
object1.billboard.scale = new Cesium.ConstantProperty(2.0);
collection.add(object1);
//Create a second entity and reference the scale from the first one.
const object2 = new Cesium.Entity({id:'object2'});
object2.model = new Cesium.ModelGraphics();
object2.model.scale = new Cesium.ReferenceProperty(collection, 'object1', ['billboard', 'scale']);
collection.add(object2);
//Create a third object, but use the fromString helper function.
const object3 = new Cesium.Entity({id:'object3'});
object3.billboard = new Cesium.BillboardGraphics();
object3.billboard.scale = Cesium.ReferenceProperty.fromString(collection, 'object1#billboard.scale');
collection.add(object3);
//You can refer to an entity with a # or . in id and property names by escaping them.
const object4 = new Cesium.Entity({id:'#object.4'});
object4.billboard = new Cesium.BillboardGraphics();
object4.billboard.scale = new Cesium.ConstantProperty(2.0);
collection.add(object4);
const object5 = new Cesium.Entity({id:'object5'});
object5.billboard = new Cesium.BillboardGraphics();
object5.billboard.scale = Cesium.ReferenceProperty.fromString(collection, '\\#object\\.4#billboard.scale');
collection.add(object5);
Members
readonly definitionChanged : Event
获取每当此属性的定义更改时引发的事件。每当引用属性的定义发生更改时,定义就会更改。
获取一个值,该值指示此属性是否为常量。
readonly referenceFrame : ReferenceFrame
获取定义位置的参考框架。仅当引用的属性是
PositionProperty
时,此属性才有效。
readonly resolvedProperty : Property |undefined
获取基础引用属性的已解析实例。
readonly targetCollection : EntityCollection
获取包含被引用实体的集合。
获取被引用实体的 id。
获取用于检索引用属性的属性名称数组。
Methods
static Cesium.ReferenceProperty.fromString (targetCollection, referenceString) → ReferenceProperty
给定将用于解析它的实体集合和一个指示目标实体 ID 和属性的字符串,创建一个新实例。字符串的格式是'objectId#foo.bar',其中 # 将 id 与属性路径分开, .分隔子属性。如果引用标识符或任何子属性包含 # 。或\它们必须被转义。
Name | Type | Description |
---|---|---|
targetCollection
|
EntityCollection | |
referenceString
|
String |
Returns:
ReferenceProperty 的新实例。
Throws:
-
DeveloperError :无效的引用字符串。
将此属性与提供的属性进行比较,如果相等则返回
true
,否则返回
false
。
Name | Type | Description |
---|---|---|
other
|
Property | 可选 其他属性。 |
Returns:
如果左右相等,则为
true
,否则为
false
。
在提供的时间获取
Material
类型。此方法仅在被引用的属性是
MaterialProperty
时才有效。
Name | Type | Description |
---|---|---|
time
|
JulianDate | 检索类型的时间。 |
Returns:
材料的类型。
在提供的时间获取属性的值。
Name | Type | Description |
---|---|---|
time
|
JulianDate | 检索值的时间。 |
result
|
Object | 可选 将值存储到其中的对象,如果省略,则创建并返回一个新实例。 |
Returns:
如果未提供结果参数,则修改结果参数或新实例。
getValueInReferenceFrame (time, referenceFrame, result ) → Cartesian3
在提供的时间和提供的参考框架中获取属性的值。此方法仅在被引用的属性是
PositionProperty
时才有效。
Name | Type | Description |
---|---|---|
time
|
JulianDate | 检索值的时间。 |
referenceFrame
|
ReferenceFrame | 结果的所需参考帧。 |
result
|
Cartesian3 | 可选 将值存储到其中的对象,如果省略,则创建并返回一个新实例。 |
Returns:
如果未提供结果参数,则修改结果参数或新实例。