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.2.dll

NuGet Package : DevExpress.Wpf.Map

Declaration

• C#
• VB.NET

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

Public Sub ZoomToRegion(
    p1 As CoordPoint,
    p2 As CoordPoint,
    roundZoomLevel As Boolean,
    paddingFactor As Double = 0.15
)

Parameters

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

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):

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.

The following code zooms the map in the specified region and applies an integer zoom level:

• C#
• VB.NET

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);
        }
    }
}

Imports DevExpress.Xpf.Map

Namespace MapApp
    Public Partial Class MainWindow
        Inherits Window

        Private Sub OnWindowLoaded(ByVal sender As Object, ByVal e As RoutedEventArgs)
            mapControl.ZoomToRegion(p1:=New GeoPoint(51.30, 0.07), p2:=New GeoPoint(41.54, 12.3), roundZoomLevel:=True, paddingFactor:=0.15)
        End Sub
    End Class
End Namespace

See Also

MapControl Class

MapControl Members

DevExpress.Xpf.Map Namespace