Skip to main content
All docs
V24.2

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

MapControl.ZoomToRegion(MapBounds, Boolean, Double) Method

Zooms the map to the specified region. Allows you to specify whether to use an integer zoom level.

Namespace: DevExpress.Xpf.Map

Assembly: DevExpress.Xpf.Map.v24.2.dll

NuGet Package: DevExpress.Wpf.Map

#Declaration

public void ZoomToRegion(
    MapBounds bounds,
    bool roundZoomLevel,
    double paddingFactor = 0.15
)

#Parameters

Name Type Description
bounds MapBounds

The bounds that specify a map region to display.

roundZoomLevel Boolean

Specifies whether to round the zoom level value.

#Optional Parameters

Name Type Default Description
paddingFactor Double 0.15

Specifies the size of the border around displayed map items.

#Remarks

The padding factor is applied to the larger dimension of the bounding box that contains visible items.

The following image shows an instance of a horizontal dimension that is larger than the vertical (“PF” means “Padding Factor” on images):

WpfMapControl_ZoomToFit_VerticalFitting

When the vertical dimension is larger than the horizontal, the zoom appears as follows:

WpfMapControl_ZoomToFit_HorizontalFitting

Note that the padding factor is divided by two for each side of the region.

The following example zooms a map into a region, and applies an integer zoom level value:

private void OnWindowLoaded(object sender, RoutedEventArgs e) {
    mapControl.ZoomToRegion(bounds: new MapBounds(new GeoPoint(51.30, 0.07), new GeoPoint(41.54, 12.3)), roundZoomLevel: true, paddingFactor: 0.15);
}
See Also