MapControl.ZoomToFitLayerItems(Double) Method

Zooms a map to fit items contained in all layers of the map.

Namespace: DevExpress.Xpf.Map

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

NuGet Package: DevExpress.Wpf.Map

Declaration

C#

public void ZoomToFitLayerItems(
    double paddingFactor = 0.15
)

VB.NET

Public Sub ZoomToFitLayerItems(
    paddingFactor As Double = 0.15
)

Optional Parameters

Name	Type	Default	Description
paddingFactor	Double	0.15	A Double object, which tunes the border size around visible map items.

Remarks

The ZoomToFitLayerItems method works as follows:

• Calculates a bounding box around map items contained in map layers.

  

• Zooms the map to fit the box.

  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 image shows a map with the padding factor parameter set at 0.3:

C#

map.ZoomToFitLayerItems(0.3);

VB.NET

map.ZoomToFitLayerItems(0.3)

Example

To zoom in a map at application launch, call the ZoomToFitLayerItems method in the LayerBase.DataLoaded event handler:

XAML

<dxm:VectorLayer x:Name="layer1" DataLoaded="VectorLayer_DataLoaded">
    <dxm:MapItemStorage>
        <dxm:MapRectangle Height="21" Width="30">
            <dxm:MapRectangle.Location>
                <dxm:GeoPoint Longitude="41.3" Latitude="-54.5"/>
            </dxm:MapRectangle.Location>
        </dxm:MapRectangle>
    </dxm:MapItemStorage>
</dxm:VectorLayer>

The DataLoaded event’s handler:

C#

private void VectorLayer_DataLoaded(object sender, DataLoadedEventArgs e) {
    mapControl.ZoomToFitLayerItems(0.3);            
}

VB.NET

Private Sub VectorLayer_DataLoaded(ByVal sender As Object, ByVal e As DataLoadedEventArgs)
    mapControl.ZoomToFitLayerItems(0.3)
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ZoomToFitLayerItems(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.

VB.NET

how-to-provide-a-cartesian-vector-map-for-the-map-control-t233956/VB/CartesianMap/MainWindow.xaml.vb#L13

Private Sub VectorLayer_DataLoaded(ByVal sender As Object, ByVal e As DataLoadedEventArgs)
    mapControl.ZoomToFitLayerItems()
End Sub

how-to-load-shapes-from-a-sql-geometry-datasource-t180275/VB/SqlGeometryDataAdapterExample/MainWindow.xaml.vb#L39

Private Sub VectorLayer_DataLoaded(ByVal sender As Object, ByVal e As DataLoadedEventArgs)
    mapControl.ZoomToFitLayerItems()
End Sub