MapControl.ZoomToFit(IEnumerable<MapItem>, Double) Method

Zooms the map to fit the area containing items sent as a parameter.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v19.2.dll

Declaration

C#

public void ZoomToFit(
    IEnumerable<MapItem> items,
    double paddingFactor
)

VB.NET

Public Sub ZoomToFit(
    items As IEnumerable(Of MapItem),
    paddingFactor As Double
)

Parameters

Name	Type	Description
items	IEnumerable<MapItem>	A IEnumerable object containing MapItem descendant objects that should be visible on a map after zooming.
paddingFactor	Double	A Double object, which tunes the border size around visible map items.

Remarks

• When vector items loading in a runtime this method should be called from LayerBase.DataLoaded event handler.

• This method works as follows.

  • Calculates a bounding box around objects.

    

  • 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 when a horizontal dimension 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.

  In the instance of the following code

  C#

  map.ZoomToFit(storage.Items, 0.3);
  

  VB.NET

  map.ZoomToFit(storage.Items, 0.3)
  

  The result should look like the following.

  

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references 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.

C#

how-to-calculate-a-route-between-waypoints-and-customize-the-appearance-of-a-route-path-usin-e5100/CS/ConnectToRouteService/Form1.cs#L52

    splashScreenManager.CloseWaitForm();
    mapControl.ZoomToFit(e.Items, 0.4);
}

winforms-map-get-geo-point-info-from-bing-geocode-service/CS/RequestLocationInformation/Form1.cs#L95

private void OnLayerItemsGenerating(object sender, LayerItemsGeneratingEventArgs e) {
    mapControl.ZoomToFit(e.Items, 0.4);
}

VB.NET

how-to-calculate-a-route-between-waypoints-and-customize-the-appearance-of-a-route-path-usin-e5100/VB/ConnectToRouteService/Form1.vb#L49

    splashScreenManager.CloseWaitForm()
    mapControl.ZoomToFit(e.Items, 0.4)
End Sub

winforms-map-get-geo-point-info-from-bing-geocode-service/VB/RequestLocationInformation/Form1.vb#L102

Private Sub OnLayerItemsGenerating(ByVal sender As Object, ByVal e As LayerItemsGeneratingEventArgs)
    mapControl.ZoomToFit(e.Items, 0.4)
End Sub