This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
thinkgeo.mapsuite.portablecore.dotdensitystyle [2015/09/21 08:06] admin |
thinkgeo.mapsuite.portablecore.dotdensitystyle [2017/03/16 21:59] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== ThinkGeo.MapSuite.Core.DotDensityStyle ====== | ====== ThinkGeo.MapSuite.Core.DotDensityStyle ====== | ||
+ | |||
+ | {{section>upgrade_map_suite_to_10.0}} | ||
+ | |||
This class allows you to display information by drawing points on an area based on a value from the features data. | This class allows you to display information by drawing points on an area based on a value from the features data. | ||
===== Inheritance Hierarchy ===== | ===== Inheritance Hierarchy ===== | ||
Line 9: | Line 12: | ||
** {{wiki:PublicMethod.gif|}} DotDensityStyle() ** | ** {{wiki:PublicMethod.gif|}} DotDensityStyle() ** | ||
- | This is the constructor for the class. | + | * //This is the constructor for the class.// |
== Remarks == | == Remarks == | ||
- | This is the default constructor. If you use this constructor, you should set the values by the properties. | + | * //This is the default constructor. If you use this constructor, you should set the values by the properties.// |
== Parameters == | == Parameters == | ||
<div newline></div> | <div newline></div> | ||
** {{wiki:PublicMethod.gif|}} DotDensityStyle(String,Double,Int32,GeoColor) ** | ** {{wiki:PublicMethod.gif|}} DotDensityStyle(String,Double,Int32,GeoColor) ** | ||
- | This is the constructor for the class. | + | * //This is the constructor for the class.// |
== Remarks == | == Remarks == | ||
- | This constructor allows you to set everything you need to a standard scenario. | + | * //This constructor allows you to set everything you need to a standard scenario.// |
== Parameters == | == Parameters == | ||
* //columnName// | * //columnName// | ||
Line 39: | Line 42: | ||
** {{wiki:PublicMethod.gif|}} DotDensityStyle(String,Double,PointStyle) ** | ** {{wiki:PublicMethod.gif|}} DotDensityStyle(String,Double,PointStyle) ** | ||
- | This is the constructor for the class. | + | * //This is the constructor for the class.// |
== Remarks == | == Remarks == | ||
- | If you require a custom point symbol, this constructor allows you to set everything you need. Custom points can include bitmaps and points that require custom fill brushes. | + | * //If you require a custom point symbol, this constructor allows you to set everything you need. Custom points can include bitmaps and points that require custom fill brushes.// |
== Parameters == | == Parameters == | ||
* //columnName// | * //columnName// | ||
Line 60: | Line 63: | ||
** {{wiki:PublicMethod.gif|}} CloneDeep() ** | ** {{wiki:PublicMethod.gif|}} CloneDeep() ** | ||
- | N/A | + | * //N/A// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
Line 72: | Line 75: | ||
** {{wiki:PublicMethod.gif|}} Draw(IEnumerable<Feature>,GeoCanvas,Collection<SimpleCandidate>,Collection<SimpleCandidate>) ** | ** {{wiki:PublicMethod.gif|}} Draw(IEnumerable<Feature>,GeoCanvas,Collection<SimpleCandidate>,Collection<SimpleCandidate>) ** | ||
- | N/A | + | * //N/A// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
Line 100: | Line 103: | ||
** {{wiki:PublicMethod.gif|}} Draw(IEnumerable<BaseShape>,GeoCanvas,Collection<SimpleCandidate>,Collection<SimpleCandidate>) ** | ** {{wiki:PublicMethod.gif|}} Draw(IEnumerable<BaseShape>,GeoCanvas,Collection<SimpleCandidate>,Collection<SimpleCandidate>) ** | ||
- | N/A | + | * //N/A// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
Line 128: | Line 131: | ||
** {{wiki:PublicMethod.gif|}} GetRequiredColumnNames() ** | ** {{wiki:PublicMethod.gif|}} GetRequiredColumnNames() ** | ||
- | N/A | + | * //N/A// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
Line 140: | Line 143: | ||
** {{wiki:PublicMethod.gif|}} DrawSample(GeoCanvas,DrawingRectangleF) ** | ** {{wiki:PublicMethod.gif|}} DrawSample(GeoCanvas,DrawingRectangleF) ** | ||
- | N/A | + | * //N/A// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
Line 160: | Line 163: | ||
** {{wiki:PublicMethod.gif|}} DrawSample(GeoCanvas) ** | ** {{wiki:PublicMethod.gif|}} DrawSample(GeoCanvas) ** | ||
- | N/A | + | * //N/A// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
Line 171: | Line 174: | ||
* //canvas// | * //canvas// | ||
* Type:[[ThinkGeo.MapSuite.Core.GeoCanvas|GeoCanvas]] | * Type:[[ThinkGeo.MapSuite.Core.GeoCanvas|GeoCanvas]] | ||
- | * Description:N/A | ||
- | |||
- | <div newline></div> | ||
- | ** {{wiki:PublicMethod.gif|}} SaveStyle(String) ** | ||
- | |||
- | N/A | ||
- | == Remarks == | ||
- | N/A | ||
- | |||
- | == Return Value == | ||
- | * Type:Void | ||
- | * Description:N/A | ||
- | |||
- | == Parameters == | ||
- | * //filePathName// | ||
- | * Type:String | ||
- | * Description:N/A | ||
- | |||
- | <div newline></div> | ||
- | ** {{wiki:PublicMethod.gif|}} SaveStyle(Stream) ** | ||
- | |||
- | N/A | ||
- | == Remarks == | ||
- | N/A | ||
- | |||
- | == Return Value == | ||
- | * Type:Void | ||
- | * Description:N/A | ||
- | |||
- | == Parameters == | ||
- | * //stream// | ||
- | * Type:Stream | ||
* Description:N/A | * Description:N/A | ||
Line 208: | Line 179: | ||
** {{wiki:PublicMethod.gif|}} ToString() ** | ** {{wiki:PublicMethod.gif|}} ToString() ** | ||
- | N/A | + | * //N/A// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
Line 220: | Line 191: | ||
** {{wiki:PublicMethod.gif|}} Equals(Object) ** | ** {{wiki:PublicMethod.gif|}} Equals(Object) ** | ||
- | N/A | + | * //N/A// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
Line 236: | Line 207: | ||
** {{wiki:PublicMethod.gif|}} GetHashCode() ** | ** {{wiki:PublicMethod.gif|}} GetHashCode() ** | ||
- | N/A | + | * //N/A// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
Line 248: | Line 219: | ||
** {{wiki:PublicMethod.gif|}} GetType() ** | ** {{wiki:PublicMethod.gif|}} GetType() ** | ||
- | N/A | + | * //N/A// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
Line 261: | Line 232: | ||
** {{wiki:ProtectedMethod.gif|}} GetRequiredColumnNamesCore() ** | ** {{wiki:ProtectedMethod.gif|}} GetRequiredColumnNamesCore() ** | ||
- | This method returns the column data for each feature that is required for the style to properly draw. | + | * //This method returns the column data for each feature that is required for the style to properly draw.// |
== Remarks == | == Remarks == | ||
- | This abstract method is called from the concrete public method GetRequiredFieldNames. In this method, we return the column names that are required for the style to draw the feature properly. For example, if you have a style that colors areas blue when a certain column value is over 100, then you need to be sure you include that column name. This will ensure that the column data is returned to you in the feature when it is ready to draw. In many of the styles, we add properties to allow the user to specify which field they need; then, in the GetRequiredColumnNamesCore, we read that property and add it to the collection. | + | * //This abstract method is called from the concrete public method GetRequiredFieldNames. In this method, we return the column names that are required for the style to draw the feature properly. For example, if you have a style that colors areas blue when a certain column value is over 100, then you need to be sure you include that column name. This will ensure that the column data is returned to you in the feature when it is ready to draw. In many of the styles, we add properties to allow the user to specify which field they need; then, in the GetRequiredColumnNamesCore, we read that property and add it to the collection.// |
== Return Value == | == Return Value == | ||
Line 273: | Line 244: | ||
** {{wiki:ProtectedMethod.gif|}} DrawCore(IEnumerable<Feature>,GeoCanvas,Collection<SimpleCandidate>,Collection<SimpleCandidate>) ** | ** {{wiki:ProtectedMethod.gif|}} DrawCore(IEnumerable<Feature>,GeoCanvas,Collection<SimpleCandidate>,Collection<SimpleCandidate>) ** | ||
- | This method draws the features on the canvas you provided. | + | * //This method draws the features on the canvas you provided.// |
== Remarks == | == Remarks == | ||
- | This overridden method is called from the concrete public method Draw. In this method, we take the features you passed in and draw them on the canvas you provided. Each style (based on its properties) may draw each feature differently. When overriding this method, consider each feature and its column data values. You can use the full power of the GeoCanvas to do the drawing. If you need column data for a feature, be sure to override the GetRequiredColumnNamesCore and add the columns you need to the collection. In many of the styles, we add properties to allow the user to specify which field they need; then, in the GetRequiredColumnNamesCore, we read that property and add it to the collection. | + | * //This overridden method is called from the concrete public method Draw. In this method, we take the features you passed in and draw them on the canvas you provided. Each style (based on its properties) may draw each feature differently. When overriding this method, consider each feature and its column data values. You can use the full power of the GeoCanvas to do the drawing. If you need column data for a feature, be sure to override the GetRequiredColumnNamesCore and add the columns you need to the collection. In many of the styles, we add properties to allow the user to specify which field they need; then, in the GetRequiredColumnNamesCore, we read that property and add it to the collection.// |
== Return Value == | == Return Value == | ||
Line 301: | Line 272: | ||
** {{wiki:ProtectedMethod.gif|}} CloneDeepCore() ** | ** {{wiki:ProtectedMethod.gif|}} CloneDeepCore() ** | ||
- | N/A | + | * //N/A// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
Line 313: | Line 284: | ||
** {{wiki:ProtectedMethod.gif|}} DrawSampleCore(GeoCanvas,DrawingRectangleF) ** | ** {{wiki:ProtectedMethod.gif|}} DrawSampleCore(GeoCanvas,DrawingRectangleF) ** | ||
- | N/A | + | * //N/A// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
Line 333: | Line 304: | ||
** {{wiki:ProtectedMethod.gif|}} Finalize() ** | ** {{wiki:ProtectedMethod.gif|}} Finalize() ** | ||
- | N/A | + | * //N/A// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
Line 345: | Line 316: | ||
** {{wiki:ProtectedMethod.gif|}} MemberwiseClone() ** | ** {{wiki:ProtectedMethod.gif|}} MemberwiseClone() ** | ||
- | N/A | + | * //N/A// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
Line 358: | Line 329: | ||
** {{wiki:PublicProperty.gif|}} CustomPointStyle ** | ** {{wiki:PublicProperty.gif|}} CustomPointStyle ** | ||
- | This property gets and sets a custom point style. | + | * //This property gets and sets a custom point style.// |
== Remarks == | == Remarks == | ||
- | You will use this property when you want to specify a point style that is not just a simple colored dot. You may want to use a bitmap or take advantage of a custom fill brush. | + | * //You will use this property when you want to specify a point style that is not just a simple colored dot. You may want to use a bitmap or take advantage of a custom fill brush.// |
== Return Value == | == Return Value == | ||
* Type:[[ThinkGeo.MapSuite.Core.PointStyle|PointStyle]] | * Type:[[ThinkGeo.MapSuite.Core.PointStyle|PointStyle]] | ||
Line 366: | Line 337: | ||
** {{wiki:PublicProperty.gif|}} ColumnName ** | ** {{wiki:PublicProperty.gif|}} ColumnName ** | ||
- | This property gets and sets the column name that will be used for the density value. | + | * //This property gets and sets the column name that will be used for the density value.// |
== Remarks == | == Remarks == | ||
- | This value should represent a value in the FeatureSource that is numeric. It will be used in conjunction with the PointToValueRatio property to deterime how many points are drawn in the area. | + | * //This value should represent a value in the FeatureSource that is numeric. It will be used in conjunction with the PointToValueRatio property to deterime how many points are drawn in the area.// |
== Return Value == | == Return Value == | ||
* Type:String | * Type:String | ||
Line 374: | Line 345: | ||
** {{wiki:PublicProperty.gif|}} PointSize ** | ** {{wiki:PublicProperty.gif|}} PointSize ** | ||
- | This property gets and sets the point size of the density points. | + | * //This property gets and sets the point size of the density points.// |
== Remarks == | == Remarks == | ||
- | If you have sparse data, one way to better fill the area is to use larger point sizes. The opposite is also true; if you have lots of data, smaller point sizes look better. | + | * //If you have sparse data, one way to better fill the area is to use larger point sizes. The opposite is also true; if you have lots of data, smaller point sizes look better.// |
== Return Value == | == Return Value == | ||
* Type:Int32 | * Type:Int32 | ||
Line 382: | Line 353: | ||
** {{wiki:PublicProperty.gif|}} PointColor ** | ** {{wiki:PublicProperty.gif|}} PointColor ** | ||
- | This property gets and sets the color of the density points. | + | * //This property gets and sets the color of the density points.// |
== Remarks == | == Remarks == | ||
- | None | + | * //None// |
== Return Value == | == Return Value == | ||
* Type:[[ThinkGeo.MapSuite.Core.GeoColor|GeoColor]] | * Type:[[ThinkGeo.MapSuite.Core.GeoColor|GeoColor]] | ||
Line 390: | Line 361: | ||
** {{wiki:PublicProperty.gif|}} PointToValueRatio ** | ** {{wiki:PublicProperty.gif|}} PointToValueRatio ** | ||
- | This property gets and sets the ratio of points to value in the data. | + | * //This property gets and sets the ratio of points to value in the data.// |
== Remarks == | == Remarks == | ||
- | This property controls the ratio of points on the screen to numeric value in the data. For example, if you have a value of 100 in the data and you have the ratio set to 1, then you will get 100 points drawn. A ratio of higher than 1 will draw more points than the data value; in our example, a ratio of 2 will draw 200 points. Conversely, a ratio of less than 1 will draw fewer points than the data value; in our example, a ratio of 0.5 would draw 50 points. | + | * //This property controls the ratio of points on the screen to numeric value in the data. For example, if you have a value of 100 in the data and you have the ratio set to 1, then you will get 100 points drawn. A ratio of higher than 1 will draw more points than the data value; in our example, a ratio of 2 will draw 200 points. Conversely, a ratio of less than 1 will draw fewer points than the data value; in our example, a ratio of 0.5 would draw 50 points.// |
== Return Value == | == Return Value == | ||
* Type:Double | * Type:Double | ||
Line 398: | Line 369: | ||
** {{wiki:PublicProperty.gif|}} CachedPoints ** | ** {{wiki:PublicProperty.gif|}} CachedPoints ** | ||
- | The cachedPoints for the dotdensity style to speed it up. | + | * //The cachedPoints for the dotdensity style to speed it up.// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
* Type:Dictionary<String,Collection<[[ThinkGeo.MapSuite.Core.Vertex|Vertex]]>> | * Type:Dictionary<String,Collection<[[ThinkGeo.MapSuite.Core.Vertex|Vertex]]>> | ||
Line 406: | Line 377: | ||
** {{wiki:PublicProperty.gif|}} Name ** | ** {{wiki:PublicProperty.gif|}} Name ** | ||
- | N/A | + | * //N/A// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
* Type:String | * Type:String | ||
Line 414: | Line 385: | ||
** {{wiki:PublicProperty.gif|}} IsActive ** | ** {{wiki:PublicProperty.gif|}} IsActive ** | ||
- | N/A | + | * //N/A// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
* Type:Boolean | * Type:Boolean | ||
Line 422: | Line 393: | ||
** {{wiki:PublicProperty.gif|}} RequiredColumnNames ** | ** {{wiki:PublicProperty.gif|}} RequiredColumnNames ** | ||
- | N/A | + | * //N/A// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
* Type:Collection<String> | * Type:Collection<String> | ||
Line 430: | Line 401: | ||
** {{wiki:PublicProperty.gif|}} Filters ** | ** {{wiki:PublicProperty.gif|}} Filters ** | ||
- | N/A | + | * //N/A// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
* Type:Collection<String> | * Type:Collection<String> | ||
Line 439: | Line 410: | ||
** {{wiki:ProtectedProperty.gif|}} FiltersCore ** | ** {{wiki:ProtectedProperty.gif|}} FiltersCore ** | ||
- | N/A | + | * //N/A// |
== Remarks == | == Remarks == | ||
- | N/A | + | * //N/A// |
== Return Value == | == Return Value == | ||
* Type:Collection<String> | * Type:Collection<String> |