MapControl.ZoomToFitLayerItems(Double) Method

Zooms the map to fit items contained by the MapControl.Layers property.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v24.1.dll

NuGet Package: DevExpress.Win.Map

Declaration

C#

public void ZoomToFitLayerItems(
    double paddingFactor
)

VB.NET

Public Sub ZoomToFitLayerItems(
    paddingFactor As Double
)

Parameters

Name	Type	Description
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 map items contained in the map’s layers.

    

  • Zooms the map to fit the box. Note that the padding factor is applied to the larger dimension of box.

    The following image shows an instance when the horizontal dimension 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.

  In the instance of the following code

  C#

  map.ZoomToFitLayerItems(0.3);
  

  VB.NET

  map.ZoomToFitLayerItems(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 ZoomToFitLayerItems(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#

winforms-map-calculate-routes-from-major-roads/CS/CalculateRoutesFromMajorRoads/Form1.cs#L58

void OnDataRequestCompleted(object sender, RequestCompletedEventArgs e) {
    mapControl.ZoomToFitLayerItems(0.4);
}

winforms-map-customize-coordinate-systems-of-a-map/CS/CoordinateSystems/Form1.cs#L61

void DataLayer_DataLoaded(object sender, DataLoadedEventArgs e) {
    mapControl.ZoomToFitLayerItems(0.4);
}

winforms-map-load-cartesian-data-to-a-map-control-with-a-coordinate-converter/CS/BuildInCoordinateConverters/Form1.cs#L85

void layer_DataLoaded(object sender, DataLoadedEventArgs e) {
    mapControl1.ZoomToFitLayerItems(0.4);
}

VB.NET

winforms-map-calculate-routes-from-major-roads/VB/CalculateRoutesFromMajorRoads/Form1.vb#L64

Private Sub OnDataRequestCompleted(ByVal sender As Object, ByVal e As RequestCompletedEventArgs)
    mapControl.ZoomToFitLayerItems(0.4)
End Sub

winforms-map-customize-coordinate-systems-of-a-map/VB/CoordinateSystems/Form1.vb#L61

Private Sub DataLayer_DataLoaded(ByVal sender As Object, ByVal e As DataLoadedEventArgs)
    mapControl.ZoomToFitLayerItems(0.4)
End Sub

winforms-map-load-cartesian-data-to-a-map-control-with-a-coordinate-converter/VB/BuildInCoordinateConverters/Form1.vb#L39

Private Sub layer_DataLoaded(ByVal sender As Object, ByVal e As DataLoadedEventArgs)
    mapControl1.ZoomToFitLayerItems(0.4)
End Sub