====== ThinkGeo.MapSuite.WindowsPhoneCore.ZoomLevel ======

{{section>upgrade_map_suite_to_10.0}}




<!-- Class -->
This class defines how InternalFeatures will be drawn based on their scale.
=== Remarks ===
This class defines how InternalFeatures will be drawn based on their scale. Inside of the ZoomLevelSet there are a number of zoom levels. We will determine which ZoomLevel to use based on which one has the Scale property closest to the current scale. The matching one will define the styles that will be used to draw the InternalFeatures on the map.
===== Inheritance Hierarchy =====
*System.Object
**[[ThinkGeo.MapSuite.WindowsPhoneCore.ZoomLevel]]
===== Members Summary =====
==== Public Constructors ====
^ Name ^ Parameters ^ DeclaringType ^ Summary ^
| {{wiki:PublicMethod.gif|Public Method}}[[#ZoomLevel()|ZoomLevel]]   |    |    | This is a constructor for the class.   |
| {{wiki:PublicMethod.gif|Public Method}}[[#ZoomLevel(Double)|ZoomLevel]]   | Double   |    | This is a constructor for the class.   |

==== Protected Constructors ====
^ Name ^ Parameters ^ DeclaringType ^ Summary ^

==== Public Methods ====
^ Name ^ Parameters ^ DeclaringType ^ Summary ^
| {{wiki:PublicMethod.gif|Public Method}}[[#Draw(GeoCanvas, IEnumerable<Feature>, Collection<SimpleCandidate>, Collection<SimpleCandidate>)|Draw]]   | [[ThinkGeo.MapSuite.WindowsPhoneCore.GeoCanvas|GeoCanvas]], IEnumerable<[[ThinkGeo.MapSuite.WindowsPhoneCore.Feature|Feature]]>, Collection<[[ThinkGeo.MapSuite.WindowsPhoneCore.SimpleCandidate|SimpleCandidate]]>, Collection<[[ThinkGeo.MapSuite.WindowsPhoneCore.SimpleCandidate|SimpleCandidate]]>   |    | This method draws the ZoomLevel.   |
| {{wiki:PublicMethod.gif|Public Method}}[[#Draw(GeoCanvas, IEnumerable<BaseShape>, Collection<SimpleCandidate>, Collection<SimpleCandidate>)|Draw]]   | [[ThinkGeo.MapSuite.WindowsPhoneCore.GeoCanvas|GeoCanvas]], IEnumerable<[[ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape|BaseShape]]>, Collection<[[ThinkGeo.MapSuite.WindowsPhoneCore.SimpleCandidate|SimpleCandidate]]>, Collection<[[ThinkGeo.MapSuite.WindowsPhoneCore.SimpleCandidate|SimpleCandidate]]>   |    | This method draws the ZoomLevel.   |
| {{wiki:PublicMethod.gif|Public Method}}[[#Equals(Object)|Equals]]   | Object   | Object   |    |
| {{wiki:PublicMethod.gif|Public Method}}[[#GetHashCode()|GetHashCode]]   |    | Object   |    |
| {{wiki:PublicMethod.gif|Public Method}}[[#GetRequiredColumnNames()|GetRequiredColumnNames]]   |    |    | This method returns the column data for each feature that is required for the styles to properly draw.   |
| {{wiki:PublicMethod.gif|Public Method}}[[#GetType()|GetType]]   |    | Object   |    |
| {{wiki:PublicMethod.gif|Public Method}}[[#ToString()|ToString]]   |    | Object   |    |

==== Protected Methods ====
^ Name ^ Parameters ^ DeclaringType ^ Summary ^
| {{wiki:ProtectedMethod.gif|Protected Method}}[[#DrawCore(GeoCanvas, IEnumerable<Feature>, Collection<SimpleCandidate>, Collection<SimpleCandidate>)|DrawCore]]   | [[ThinkGeo.MapSuite.WindowsPhoneCore.GeoCanvas|GeoCanvas]], IEnumerable<[[ThinkGeo.MapSuite.WindowsPhoneCore.Feature|Feature]]>, Collection<[[ThinkGeo.MapSuite.WindowsPhoneCore.SimpleCandidate|SimpleCandidate]]>, Collection<[[ThinkGeo.MapSuite.WindowsPhoneCore.SimpleCandidate|SimpleCandidate]]>   |    | This method draws the ZoomLevel.   |
| {{wiki:ProtectedMethod.gif|Protected Method}}[[#Finalize()|Finalize]]   |    | Object   |    |
| {{wiki:ProtectedMethod.gif|Protected Method}}[[#MemberwiseClone()|MemberwiseClone]]   |    | Object   |    |

==== Public Properties ====
^ Name ^ Return ^ DeclaringType ^ Summary ^
| {{wiki:PublicProperty.gif|Public Property}}[[#ApplyUntilZoomLevel|ApplyUntilZoomLevel]]   | [[ThinkGeo.MapSuite.WindowsPhoneCore.ApplyUntilZoomLevel|ApplyUntilZoomLevel]]   |    | This property gets and sets the zoom to which we will use this zoom level's styles.   |
| {{wiki:PublicProperty.gif|Public Property}}[[#CustomStyles|CustomStyles]]   | Collection<[[ThinkGeo.MapSuite.WindowsPhoneCore.Style|Style]]>   |    | This property gets a collection of custom styles used to draw.   |
| {{wiki:PublicProperty.gif|Public Property}}[[#DefaultAreaStyle|DefaultAreaStyle]]   | [[ThinkGeo.MapSuite.WindowsPhoneCore.AreaStyle|AreaStyle]]   |    | This property gets and sets the default AreaStyle used to draw.   |
| {{wiki:PublicProperty.gif|Public Property}}[[#DefaultLineStyle|DefaultLineStyle]]   | [[ThinkGeo.MapSuite.WindowsPhoneCore.LineStyle|LineStyle]]   |    | This property gets and sets the default LineStyle used to draw.   |
| {{wiki:PublicProperty.gif|Public Property}}[[#DefaultPointStyle|DefaultPointStyle]]   | [[ThinkGeo.MapSuite.WindowsPhoneCore.PointStyle|PointStyle]]   |    | This property gets and sets the default PointStyle used to draw.   |
| {{wiki:PublicProperty.gif|Public Property}}[[#DefaultTextStyle|DefaultTextStyle]]   | [[ThinkGeo.MapSuite.WindowsPhoneCore.TextStyle|TextStyle]]   |    | This property gets and sets the default TextStyle used to draw.   |
| {{wiki:PublicProperty.gif|Public Property}}[[#IsActive|IsActive]]   | Boolean   |    | This property gets and sets whether the ZoomLevel is active and should draw.   |
| {{wiki:PublicProperty.gif|Public Property}}[[#Name|Name]]   | String   |    | This property gets and sets the name for the ZoomLevel.   |
| {{wiki:PublicProperty.gif|Public Property}}[[#Scale|Scale]]   | Double   |    | This property gets and sets the scale for the ZoomLevel.   |

==== Protected Properties ====
^ Name ^ Return ^ DeclaringType ^ Summary ^

==== Public Events ====
^ Name ^ Event Arguments ^ DeclaringType ^ Summary ^

===== Public Constructors =====
==== ZoomLevel() ====
This is a constructor for the class.
=== Overloads ===
This is the default constructor. If you use this constructor, you should set the require properties on the class manually.
=== Remarks ===
This is the default constructor. If you use this constructor, you should set the require properties on the class manually.
=== Parameters ===
^  Name ^  Type ^  Description ^

[[#Public Constructors|Go Back]]
==== ZoomLevel(Double) ====
This is a constructor for the class.
=== Overloads ===
This constructor allows you to provide the scale for this ZoomLevel.
=== Remarks ===
This constructor allows you to provide the scale for this ZoomLevel.
=== Parameters ===
^  Name ^  Type ^  Description ^
| scale   | Double<!-- System.Double -->   | This paramter is the scale for the ZoomLevel.   |

[[#Public Constructors|Go Back]]
===== Protected Constructors =====
===== Public Methods =====
==== Draw(GeoCanvas, IEnumerable<Feature>, Collection<SimpleCandidate>, Collection<SimpleCandidate>) ====
This method draws the ZoomLevel.
=== Remarks ===
This method is the concrete wrapper for the abstract method DrawCore. This method draws the representation of the Layer based on the extent you provided.

As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.
=== Return Value ===
^ Return Type ^ Description ^
| Void<!-- System.Void -->   |    |

=== Parameters ===
^  Name ^  Type ^  Description ^
| canvas   | [[ThinkGeo.MapSuite.WindowsPhoneCore.GeoCanvas|GeoCanvas]]<!-- ThinkGeo.MapSuite.WindowsPhoneCore.GeoCanvas -->   | This parameter is the Canvas used to draw the InternalFeatures.   |
| features   | IEnumerable<[[ThinkGeo.MapSuite.WindowsPhoneCore.Feature|Feature]]><!-- System.Collections.Generic.IEnumerable{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} -->   | This parameter is the collection of features that we will draw.   |
| currentLayerLabels   | Collection<[[ThinkGeo.MapSuite.WindowsPhoneCore.SimpleCandidate|SimpleCandidate]]><!-- System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.SimpleCandidate} -->   | This parameter is the collection of labels in the current layer.   |
| allLayerLabels   | Collection<[[ThinkGeo.MapSuite.WindowsPhoneCore.SimpleCandidate|SimpleCandidate]]><!-- System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.SimpleCandidate} -->   | This parameter is the collection of labels in all layers.   |

<!-- ThinkGeo.MapSuite.WindowsPhoneCore.ZoomLevel -->
[[#Public Methods|Go Back]]
==== Draw(GeoCanvas, IEnumerable<BaseShape>, Collection<SimpleCandidate>, Collection<SimpleCandidate>) ====
This method draws the ZoomLevel.
=== Remarks ===
This method is the concrete wrapper for the abstract method DrawCore. This method draws the representation of the Layer based on the extent you provided.

As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.
=== Return Value ===
^ Return Type ^ Description ^
| Void<!-- System.Void -->   |    |

=== Parameters ===
^  Name ^  Type ^  Description ^
| canvas   | [[ThinkGeo.MapSuite.WindowsPhoneCore.GeoCanvas|GeoCanvas]]<!-- ThinkGeo.MapSuite.WindowsPhoneCore.GeoCanvas -->   | This parameter is the Canvas used to draw the InternalFeatures.   |
| shapes   | IEnumerable<[[ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape|BaseShape]]><!-- System.Collections.Generic.IEnumerable{ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape} -->   | This parameter is the collection of shapes that we will draw.   |
| currentLayerLabels   | Collection<[[ThinkGeo.MapSuite.WindowsPhoneCore.SimpleCandidate|SimpleCandidate]]><!-- System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.SimpleCandidate} -->   | This parameter is the collection of labels in the current layer.   |
| allLayerLabels   | Collection<[[ThinkGeo.MapSuite.WindowsPhoneCore.SimpleCandidate|SimpleCandidate]]><!-- System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.SimpleCandidate} -->   | This parameter is the collection of labels in all layers.   |

<!-- ThinkGeo.MapSuite.WindowsPhoneCore.ZoomLevel -->
[[#Public Methods|Go Back]]
==== Equals(Object) ====
=== Return Value ===
^ Return Type ^ Description ^
| Boolean<!-- System.Boolean -->   |    |

=== Parameters ===
^  Name ^  Type ^  Description ^
| obj   | Object<!-- System.Object -->   |    |

<!-- System.Object -->
[[#Public Methods|Go Back]]
==== GetHashCode() ====
=== Return Value ===
^ Return Type ^ Description ^
| Int32<!-- System.Int32 -->   |    |

=== Parameters ===
^  Name ^  Type ^  Description ^

<!-- System.Object -->
[[#Public Methods|Go Back]]
==== GetRequiredColumnNames() ====
This method returns the column data for each feature that is required for the styles to properly draw.
=== Remarks ===
In this method, we return the column names that are required for the styles 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 the 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 Type ^ Description ^
| Collection<String><!-- System.Collections.ObjectModel.Collection{System.String} -->   | This method returns a collection containing the required column names.   |

=== Parameters ===
^  Name ^  Type ^  Description ^

<!-- ThinkGeo.MapSuite.WindowsPhoneCore.ZoomLevel -->
[[#Public Methods|Go Back]]
==== GetType() ====
=== Return Value ===
^ Return Type ^ Description ^
| Type<!-- System.Type -->   |    |

=== Parameters ===
^  Name ^  Type ^  Description ^

<!-- System.Object -->
[[#Public Methods|Go Back]]
==== ToString() ====
=== Return Value ===
^ Return Type ^ Description ^
| String<!-- System.String -->   |    |

=== Parameters ===
^  Name ^  Type ^  Description ^

<!-- System.Object -->
[[#Public Methods|Go Back]]
===== Protected Methods =====
==== DrawCore(GeoCanvas, IEnumerable<Feature>, Collection<SimpleCandidate>, Collection<SimpleCandidate>) ====
This method draws the ZoomLevel.
=== Remarks ===
This method draws the representation of the Layer based on the extent you provided.
=== Return Value ===
^ Return Type ^ Description ^
| Void<!-- System.Void -->   |    |

=== Parameters ===
^  Name ^  Type ^  Description ^
| canvas   | [[ThinkGeo.MapSuite.WindowsPhoneCore.GeoCanvas|GeoCanvas]]<!-- ThinkGeo.MapSuite.WindowsPhoneCore.GeoCanvas -->   | This parameter is the Canvas used to draw the InternalFeatures.   |
| features   | IEnumerable<[[ThinkGeo.MapSuite.WindowsPhoneCore.Feature|Feature]]><!-- System.Collections.Generic.IEnumerable{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} -->   | This parameter is the collection of feature that we will draw.   |
| currentLayerLabels   | Collection<[[ThinkGeo.MapSuite.WindowsPhoneCore.SimpleCandidate|SimpleCandidate]]><!-- System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.SimpleCandidate} -->   | This parameter is the collection of labels in the current layer.   |
| allLayerLabels   | Collection<[[ThinkGeo.MapSuite.WindowsPhoneCore.SimpleCandidate|SimpleCandidate]]><!-- System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.SimpleCandidate} -->   | This parameter is the collection of labels in all layers.   |

<!-- ThinkGeo.MapSuite.WindowsPhoneCore.ZoomLevel -->
[[#Protected Methods|Go Back]]
==== Finalize() ====
=== Return Value ===
^ Return Type ^ Description ^
| Void<!-- System.Void -->   |    |

=== Parameters ===
^  Name ^  Type ^  Description ^

<!-- System.Object -->
[[#Protected Methods|Go Back]]
==== MemberwiseClone() ====
=== Return Value ===
^ Return Type ^ Description ^
| Object<!-- System.Object -->   |    |

=== Parameters ===
^  Name ^  Type ^  Description ^

<!-- System.Object -->
[[#Protected Methods|Go Back]]
===== Public Properties =====
==== ApplyUntilZoomLevel ====
This property gets and sets the zoom to which we will use this zoom level's styles.
=== Remarks ===
This property allows you to apply the current ZoomLevel's styles across many ZoomLevels. For example, you may want to display roads as a thin line from ZoomLevel10 through ZoomLevel15. To accomplish this easily, you can set the correct styles on ZoomLevel10 and then set its ApplyUntilZoomLevel property to Level15. This will mean that Level10's style will be used until Level15. There is no need to set Level11, Level12, Level13 and so on.
=== Return Value ===
^ Return Type ^
| [[ThinkGeo.MapSuite.WindowsPhoneCore.ApplyUntilZoomLevel|ApplyUntilZoomLevel]]<!-- ThinkGeo.MapSuite.WindowsPhoneCore.ApplyUntilZoomLevel -->   |

<!-- ThinkGeo.MapSuite.WindowsPhoneCore.ZoomLevel -->
[[#Public Properties|Go Back]]
==== CustomStyles ====
This property gets a collection of custom styles used to draw.
=== Remarks ===
This is a collection of styles to draw. If you only need to draw one style, then we suggest you do not use this collection and instead use one of the default styles, such as DefaultAreaStyle, DefaultLineStyle, DefaultTextStyle, etc.
=== Return Value ===
^ Return Type ^
| Collection<[[ThinkGeo.MapSuite.WindowsPhoneCore.Style|Style]]><!-- System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Style} -->   |

<!-- ThinkGeo.MapSuite.WindowsPhoneCore.ZoomLevel -->
[[#Public Properties|Go Back]]
==== DefaultAreaStyle ====
This property gets and sets the default AreaStyle used to draw.
=== Remarks ===
If you set this style, then it will be used for drawing.

If you use the default styles, you should only use one. The one you use should match your feature data. For example, if your features are lines, then you should use the DefaultLineStyle.
=== Return Value ===
^ Return Type ^
| [[ThinkGeo.MapSuite.WindowsPhoneCore.AreaStyle|AreaStyle]]<!-- ThinkGeo.MapSuite.WindowsPhoneCore.AreaStyle -->   |

<!-- ThinkGeo.MapSuite.WindowsPhoneCore.ZoomLevel -->
[[#Public Properties|Go Back]]
==== DefaultLineStyle ====
This property gets and sets the default LineStyle used to draw.
=== Remarks ===
If you set this style, then it will be used for drawing.

If you use the default styles, you should only use one. The one you use should match your feature data. For example, if your features are lines, then you should use the DefaultLineStyle.
=== Return Value ===
^ Return Type ^
| [[ThinkGeo.MapSuite.WindowsPhoneCore.LineStyle|LineStyle]]<!-- ThinkGeo.MapSuite.WindowsPhoneCore.LineStyle -->   |

<!-- ThinkGeo.MapSuite.WindowsPhoneCore.ZoomLevel -->
[[#Public Properties|Go Back]]
==== DefaultPointStyle ====
This property gets and sets the default PointStyle used to draw.
=== Remarks ===
If you set this style, then it will be used for drawing.

If you use the default styles, you should only use one. The one you use should match your feature data. For example, if your features are lines, then you should use the DefaultLineStyle.
=== Return Value ===
^ Return Type ^
| [[ThinkGeo.MapSuite.WindowsPhoneCore.PointStyle|PointStyle]]<!-- ThinkGeo.MapSuite.WindowsPhoneCore.PointStyle -->   |

<!-- ThinkGeo.MapSuite.WindowsPhoneCore.ZoomLevel -->
[[#Public Properties|Go Back]]
==== DefaultTextStyle ====
This property gets and sets the default TextStyle used to draw.
=== Remarks ===
If you set this style, then it will be used for drawing.

If you use the default styles, you should only use one. The one you use should match your feature data. For example, if your features are lines, then you should use the DefaultLineStyle.
=== Return Value ===
^ Return Type ^
| [[ThinkGeo.MapSuite.WindowsPhoneCore.TextStyle|TextStyle]]<!-- ThinkGeo.MapSuite.WindowsPhoneCore.TextStyle -->   |

<!-- ThinkGeo.MapSuite.WindowsPhoneCore.ZoomLevel -->
[[#Public Properties|Go Back]]
==== IsActive ====
This property gets and sets whether the ZoomLevel is active and should draw.
=== Remarks ===
Setting the value to false means that this zoom level will not be considered in the ZoomLevelSet and thus will not draw.
=== Return Value ===
^ Return Type ^
| Boolean<!-- System.Boolean -->   |

<!-- ThinkGeo.MapSuite.WindowsPhoneCore.ZoomLevel -->
[[#Public Properties|Go Back]]
==== Name ====
This property gets and sets the name for the ZoomLevel.
=== Remarks ===
The name is user defined. It is useful to set, as it may be used for higher level components such as legends, etc.
=== Return Value ===
^ Return Type ^
| String<!-- System.String -->   |

<!-- ThinkGeo.MapSuite.WindowsPhoneCore.ZoomLevel -->
[[#Public Properties|Go Back]]
==== Scale ====
This property gets and sets the scale for the ZoomLevel.
=== Remarks ===
The scale
=== Return Value ===
^ Return Type ^
| Double<!-- System.Double -->   |

<!-- ThinkGeo.MapSuite.WindowsPhoneCore.ZoomLevel -->
[[#Public Properties|Go Back]]
===== Protected Properties =====
===== Public Events =====
__NOTOC__
[[Category:WindowsPhoneMapSuiteCore]]
[[Category:ThinkGeo.MapSuite.WindowsPhoneCore]]
[[Category:UpdateDocumentation]]