MapControl.ZoomToFit(IEnumerable<MapItem>, Double) Method
Zooms the map to fit the area that contains items sent as a parameter.
Namespace: DevExpress.XtraMap
Assembly: DevExpress.XtraMap.v24.1.dll
NuGet Package: DevExpress.Win.Map
Declaration
Parameters
Name | Type | Description |
---|---|---|
items | IEnumerable<MapItem> | A IEnumerable object that contains MapItem descendant objects that should be visible on a map after it is zoomed. |
paddingFactor | Double | A Double object, which tunes the border size around visible map items. |
Remarks
When vector items are loaded at runtime, the ZoomToFit
method should be called from LayerBase.DataLoaded event handler.
The ZoomToFit
method works as follows:
Calculates a bounding box around items.
Zooms the map to fit the box. Note that the padding factor is applied to the larger dimension of the box.
The following image shows an instance of a horizontal dimension that is larger than the vertical (“PF” means “Padding Factor” on images).
When the vertical dimension is larger than the horizontal, the zoom appears as follows:
Note that the padding factor is divided by two for each side of the region.
Example
The following image shows a map with paddingFactor equal to 0.3:
Related GitHub Examples
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ZoomToFit(IEnumerable<MapItem>, Double) method.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.