MapControl.ZoomToRegion(CoordPoint, CoordPoint, Double) Method

Zooms to the region described by its top-left and bottom-right points.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v19.2.dll

Declaration

C#

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

VB.NET

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

Parameters

Name	Type	Description
topLeft	CoordPoint	A CoordPoint class descendant object.
bottomRight	CoordPoint	A CoordPoint class descendant object.
paddingFactor	Double	A Double object, which tunes the border size around the region.

Remarks

Note that padding factor is applied to the larger dimension of the region.

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

In the instance of the following code

C#

GeoPoint topLeft = new GeoPoint(50, 15);
GeoPoint bottomRight = new GeoPoint(60, 10);
map.ZoomToRegion(topLeft, bottomRight, 0.4);

VB.NET

Dim topLeft As New GeoPoint(50, 15)
Dim bottomRight As New GeoPoint(60, 10)
map.ZoomToRegion(topLeft, bottomRight, 0.4)

the result should look like the following.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ZoomToRegion(CoordPoint, CoordPoint, 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#

how-to-calculate-a-route-between-two-addresses-t364143/CS/RouteByAddresses/Form1.cs#L39

};
mapControl.ZoomToRegion(topLeft, bottomRight, 0.4);
splashScreenManager1.CloseWaitForm();

how-to-obtain-a-collection-of-available-wms-layers-in-the-rensponsecapabilities-event-hand-t359209/CS/WmsDataProviderExample/Form1.cs#L50

    Provider.ActiveLayerName = layer.Name;
    mapControl.ZoomToRegion(layer.LeftTop, layer.RightBottom, 0.15);
}

how-to-zoom-a-map-to-a-calculated-route-using-the-routecalculated-event-t363647/CS/ZoomToFitOnRouteCalculated/Form1.cs#L14

SearchBoundingBox bBox = e.CalculationResult.RouteResults[0].BoundingBox;
mapControl.ZoomToRegion(new GeoPoint(bBox.NorthLatitude, bBox.WestLongitude), new GeoPoint(bBox.SouthLatitude, bBox.EastLongitude), 0.4);
splashScreenManager.CloseWaitForm();

VB.NET

how-to-calculate-a-route-between-two-addresses-t364143/VB/RouteByAddresses/Form1.vb#L36

Dim bottomRight As GeoPoint = New GeoPoint With {.Latitude = box.SouthLatitude, .Longitude = box.EastLongitude}
mapControl.ZoomToRegion(topLeft, bottomRight, 0.4)
splashScreenManager1.CloseWaitForm()

how-to-obtain-a-collection-of-available-wms-layers-in-the-rensponsecapabilities-event-hand-t359209/VB/WmsDataProviderExample/Form1.vb#L64

    Provider.ActiveLayerName = layer.Name
    mapControl.ZoomToRegion(layer.LeftTop, layer.RightBottom, 0.15)
End Sub

how-to-zoom-a-map-to-a-calculated-route-using-the-routecalculated-event-t363647/VB/ZoomToFitOnRouteCalculated/Form1.vb#L24

Dim bBox As SearchBoundingBox = e.CalculationResult.RouteResults(0).BoundingBox
mapControl.ZoomToRegion(New GeoPoint(bBox.NorthLatitude, bBox.WestLongitude), New GeoPoint(bBox.SouthLatitude, bBox.EastLongitude), 0.4)
splashScreenManager.CloseWaitForm()