Skip to main content
All docs
V25.1
  • MapControl.ZoomToRegion(CoordPoint, CoordPoint, Boolean, Double) Method

    Zooms to the region by its top-left and bottom-right points, and specifies whether to apply an integer zoom level.

    Namespace: DevExpress.Xpf.Map

    Assembly: DevExpress.Xpf.Map.v25.1.dll

    NuGet Package: DevExpress.Wpf.Map

    Declaration

    public void ZoomToRegion(
        CoordPoint p1,
        CoordPoint p2,
        bool roundZoomLevel,
        double paddingFactor = 0.15
    )

    Parameters

    Name Type Description
    p1 CoordPoint

    The coordinate of the top-left region point.

    p2 CoordPoint

    The coordinate of the bottom-right region point.

    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 code zooms the map in the specified region and applies an integer zoom level:

    using DevExpress.Xpf.Map;
    using System.Windows;
    
    namespace MapApp {
        public partial class MainWindow : Window {
            private void OnWindowLoaded(object sender, RoutedEventArgs e) {
                mapControl.ZoomToRegion(p1: new GeoPoint(51.30, 0.07), p2: new GeoPoint(41.54, 12.3), roundZoomLevel: true, paddingFactor: 0.15);
            }
        }
    }
    
    See Also