MapControl.ZoomToRegion(CoordPoint, CoordPoint, Double, Boolean) Method

Zooms the map to the specified region. Allows you to set whether the map should use a non-negative integer zoom level.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v25.2.dll

NuGet Package: DevExpress.Win.Map

Declaration

C#

public void ZoomToRegion(
    CoordPoint topLeft,
    CoordPoint bottomRight,
    double paddingFactor,
    bool roundZoomLevel
)

VB.NET

Public Sub ZoomToRegion(
    topLeft As CoordPoint,
    bottomRight As CoordPoint,
    paddingFactor As Double,
    roundZoomLevel As Boolean
)

Parameters

Name	Type	Description
topLeft	CoordPoint	The top-left coordinate of the region.
bottomRight	CoordPoint	The bottom-right coordinate of the region.
paddingFactor	Double	Specifies the percentage size of the border around displayed map items .
roundZoomLevel	Boolean	Specifies whether to round the zoom level value.

Remarks

The padding factor is applied to the larger dimension of a region.

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

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

Example

The following code zooms a map into a region. The paddingFactor parameter is set to 0.3 so that zoom region is 70% of a map surface.

C#

using DevExpress.XtraMap;

private void OnVectorLayerDataLoaded(object sender, DataLoadedEventArgs e) {
    mapControl1.ZoomToRegion(
        topLeft: new GeoPoint(61.6, 1.9),
        bottomRight: new GeoPoint(48.1, 32.1),
        paddingFactor: 0.3,
        roundZoomLevel: true);
}

VB.NET

Imports DevExpress.XtraMap

Private Sub OnVectorLayerDataLoaded(ByVal sender As Object, ByVal e As DataLoadedEventArgs)
    mapControl1.ZoomToRegion(topLeft:=New GeoPoint(61.6, 1.9), bottomRight:=New GeoPoint(48.1, 32.1), paddingFactor:=0.3, roundZoomLevel:=True)
End Sub