ThemeUnique类参考

单值专题图类。 更多...

继承自Theme。

所有成员的列表。

公有成员
(int)	- addItem:
	添加一个单值专题图子项到单值专题图子项列表中。
(NSString *)	- toString
	返回单值专题图格式化字符串。
(int)	- getCount
	返回单值专题图子项个数。
(ThemeUniqueItem *)	- getItem:
	返回指定序号的单值专题图子项。
(int)	- indexOf:
	返回单值专题图中指定子项单值在当前序列中的序号。
(NSMutableArray *)	- getUniqueItemsList
	获取单值专题图子项列表。
(void)	- clear
	删除所有单值专题图子项。执行该方法后，所有的单值专题图子项都被释放，不可再用。
(void)	- dispose
	释放对象所占用的资源。调用该方法之后，此对象不再可用。
(BOOL)	- fromXML:
	根据传入的XML字符串重新构造对象。
(NSString *)	- getUniqueExpression
	返回单值专题图字段表达式。
(void)	- setUniqueExpression:
	设置单值专题图字段表达式。
(BOOL)	- insert:Item:
	将给定的单值专题图子项插入到指定序号的位置。
(BOOL)	- isDefaultStyleVisible
	返回单值专题图默认风格是否可见。
(BOOL)	- remove:
	删除一个指定序号的单值专题图子项。
(void)	- setDefaultStyleVisible:
	设置单值专题图默认风格是否可见。
(void)	- reverseStyle
	对单值专题图中子项的风格进行反序显示。
静态公有成员
(ThemeUnique *)	+ makeDefault:uniqueExpression:
	根据给定的矢量数据集和单值专题图字段表达式生成默认的单值专题图。
(ThemeUnique *)	+ makeDefault:uniqueExpression:colorType:
	根据给定的矢量数据集、单值专题图字段表达式和颜色渐变模式生成默认的单值专题图。
(ThemeUnique *)	+ makeDefault:uniqueExpression:colorType:JoinItem:
	根据给定的矢量数据集、单值专题图字段表达式、颜色渐变模式和外部表连接项生成默认的单值专题图。
(ThemeUnique *)	+ makeDefault:colorField:colors:
	根据指定的面数据集、颜色字段名称、颜色生成默认的四色单值专题图。
保护属性
NSMutableArray *	_mUniqueItems
GeoStyle *	_mDefaultStyle
属性
GeoStyle *	mDefaultStyle
	获取或设置单值专题图的默认风格。对于那些未在单值专题图之列的对象使用该风格显示。如未设置，则使用图层默认风格显示。
NSString *	offsetX
	获取或设置点、线、面图层制作的单值专题图中的对象相对于原来位置的水平偏移量。
NSString *	offsetY
	设置点、线、面图层制作的单值专题图中的对象相对于原来位置的垂直偏移量。
BOOL	isOffsetFixed
	获取或设置是否采用设备单位
GeoStyle *	defaultGeoStyle
	默认风格,如果某个对象不在单值列表内,就使用这个风格进行显示

---

详细描述

单值专题图类。

将字段或表达式的值相同的要素采用相同的风格来显示，从而用来区分不同的类别。例如，在表示土地的面数据中表示土地利用类型的字段中有草地，林地，居民地，耕地等值，使用单值专题图进行渲染时，每种类型的土地利用类型被赋予一种颜色或填充风格，从而可以看出每种类型的土地利用的分布区域和范围。可用于地质图、地貌图、植被图、土地利用图、政治行政区划图、自然区划图、经济区划图等。单值专题图着重表示现象质的差别，一般不表示数量的特征。尤其是有交叉或重叠现象时，此类不推荐使用，例如：民族分布区等。

---

成员函数文档

- (int) addItem:

(ThemeUniqueItem *)

item

添加一个单值专题图子项到单值专题图子项列表中。

参数:

item

将被添加的单值专题图子项。

返回:

如果添加成功，返回被添加子项在序列中的序号，否则返回-1。

- (void) clear

删除所有单值专题图子项。执行该方法后，所有的单值专题图子项都被释放，不可再用。

- (void) dispose

释放对象所占用的资源。调用该方法之后，此对象不再可用。

- (BOOL) fromXML:

(NSString *)

xml

根据传入的XML字符串重新构造对象。

参数:

xml

传入的XML字符串。

返回:

一个布尔值，构造成功返回true,否则返回false。

实现了Theme。

- (int) getCount

返回单值专题图子项个数。

默认值为0。

返回:

单值专题图子项个数。

- (ThemeUniqueItem *) getItem:

(int)

index

返回指定序号的单值专题图子项。

参数:

index

指定的单值专题图子项的序号。

返回:

指定序号的单值专题图子项。

- (NSString *) getUniqueExpression

返回单值专题图字段表达式。

用于制作单值专题图的字段或字段表达式。该字段可以为要素的某一属性（如地质图中的年代或成份），其值的数据类型可以为数值型或字符型。

默认值为一个空字符串。

返回:

单值专题图字段表达式。

- (NSMutableArray *) getUniqueItemsList

获取单值专题图子项列表。

返回:

单值专题图子项列表。

- (int) indexOf:

(NSString *)

unique

返回单值专题图中指定子项单值在当前序列中的序号。

参数:

unique

给定的单值专题图子项单值。

返回:

专题图子项在序列中的序号值。如果该值不存在，就返回-1。

- (BOOL) insert:		(int)	index
Item:		(ThemeUniqueItem *)	item

将给定的单值专题图子项插入到指定序号的位置。

参数:

	index	指定的单值专题图子项序列的序号。
	item	将被插入的单值专题图子项。

- (BOOL) isDefaultStyleVisible

返回单值专题图默认风格是否可见。

返回:

一个布尔值，单值专题图默认风格可见返回true,否则返回false。

+ (ThemeUnique *) makeDefault:		(DatasetVector *)	dataset
colorField:		(NSString *)	colorField
colors:		(Colors *)	colors

根据指定的面数据集、颜色字段名称、颜色生成默认的四色单值专题图。

四色单值专题图是指在一幅地图上，只用四种颜色就能使具有公共边的面对象着上不同的颜色。

注意：对于面数据集复杂度低的情形下，采用四种颜色即可生成四色单值专题图；若面数据集复杂度高，则着色结果可能为五色。

参数:

	dataset	指定的面数据集。由于该构造函数将修改面数据集的属性信息，因此需保证dataset为非只读。
	colorField	着色字段的名称。着色字段必须为整型字段。它可以为面数据集中已有属性字段，也可以是自定义的其它字段。若为已存在属性字段，需保证该字段类型为整型，系统将修改该字段的属性值，并分别赋值为1、2、3、4；若为自定义的其它字段，需保证字段名合法，则系统首先在面数据集中创建该字段，并分别赋值为1、2、3、4。由此，着色字段已分别赋值为1、2、3、4，代表着四种不同的颜色，根据该字段的值即可生成四色专题图。
	colors	用户传入的用来制作专题图的颜色。系统对传入颜色的数目不做规定，比如，用户只传入了一种颜色，则在生成专题图时，系统会自动补齐出图所需的颜色。

返回:

生成的四色单值专题图。

+ (ThemeUnique *) makeDefault:		(DatasetVector *)	dataset
uniqueExpression:		(NSString *)	uniqueExpression

根据给定的矢量数据集和单值专题图字段表达式生成默认的单值专题图。

参数:

	dataset	给定的矢量数据集。
	uniqueExpression	单值专题图字段表达式。

返回:

根据参数构造得到一个新的单值专题图类的对象实例。

+ (ThemeUnique *) makeDefault:		(DatasetVector *)	dataset
uniqueExpression:		(NSString *)	uniqueExpression
colorType:		(ColorGradientType)	colorGradientType

根据给定的矢量数据集、单值专题图字段表达式和颜色渐变模式生成默认的单值专题图。

参数:

	dataset	给定的矢量数据集。
	uniqueExpression	单值专题图字段表达式。
	colorGradientType	颜色渐变模式。

返回:

根据参数构造得到一个新的单值专题图类的对象实例。

+ (ThemeUnique *) makeDefault:		(DatasetVector *)	dataset
uniqueExpression:		(NSString *)	uniqueExpression
colorType:		(ColorGradientType)	colorGradientType
JoinItem:		(JoinItems *)	joinItems

根据给定的矢量数据集、单值专题图字段表达式、颜色渐变模式和外部表连接项生成默认的单值专题图。

参数:

	dataset	给定的矢量数据集。
	uniqueExpression	单值专题图字段表达式。
	colorGradientType	颜色渐变模式。
	joinItems	外部表连接项。

返回:

根据参数构造得到一个新的单值专题图类的对象实例。

- (BOOL) remove:

(int)

index

删除一个指定序号的单值专题图子项。

参数:

index

指定的将被删除单值专题图子项序列的序号。

返回:

一个布尔值，删除成功返回true,否则返回false。

- (void) reverseStyle

对单值专题图中子项的风格进行反序显示。

- (void) setDefaultStyleVisible:

(Boolean)

value

设置单值专题图默认风格是否可见。

参数:

value

胆汁专题图风格是否可见。

- (void) setUniqueExpression:

(NSString *)

value

设置单值专题图字段表达式。

用于制作单值专题图的字段或字段表达式。该字段可以为要素的某一属性（如地质图中的年代或成份），其值的数据类型可以为数值型或字符型。

参数:

value

指定胆汁专题图字段表达式。

- (NSString *) toString

返回单值专题图格式化字符串。

返回:

单值专题图格式化字符串。

---

成员数据文档

- (GeoStyle*) _mDefaultStyle [protected]

- (NSMutableArray*) _mUniqueItems [protected]

---

属性文档

- (GeoStyle*) defaultGeoStyle [read, write, assign]

默认风格,如果某个对象不在单值列表内,就使用这个风格进行显示

- (BOOL) isOffsetFixed [read, write, assign]

获取或设置是否采用设备单位

- (GeoStyle*) mDefaultStyle [read, write, assign]

获取或设置单值专题图的默认风格。对于那些未在单值专题图之列的对象使用该风格显示。如未设置，则使用图层默认风格显示。

默认值为{FillBackColor=Color [A=255, R=255, G=255, B=255],FillForeColor=Color [A=255, R=189, G=235, B=255],FillGradientAngle=0,FillGradientMode=None,FillGradientOffsetRatioX=0,FillGradientOffsetRatioY=0,FillOpaqueRate=100,FillSymbolID=0,LineColor=Color [A=255, R=0, G=0, B=0],LineSymbolID=0,LineWidth=0.1,MarkerAngle=0,MarkerSize={Width=2.4,Height=-1},MarkerSymbolID=0}。

返回:

单值专题图的默认风格。

- (NSString*) offsetX [read, write, assign]

获取或设置点、线、面图层制作的单值专题图中的对象相对于原来位置的水平偏移量。

偏移量的单位由 isOffsetFixed()的设置决定,参数为True表示采用设备单位,否则采用地理坐标单位。

- (NSString*) offsetY [read, write, assign]

设置点、线、面图层制作的单值专题图中的对象相对于原来位置的垂直偏移量。

偏移量的单位由 isOffsetFixed()的设置决定,参数为True表示采用设备单位,否则采用地理坐标单位。

---

该类的文档由以下文件生成：

• ThemeUnique.h