MapControl.ZoomToFit(IEnumerable<MapItem>, Double) Method

Zooms a map to fit the area containing items sent as a parameter.

Namespace: DevExpress.Xpf.Map

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

NuGet Package: DevExpress.Wpf.Map

Declaration

C#

public void ZoomToFit(
    IEnumerable<MapItem> items,
    double paddingFactor = 0.15
)

VB.NET

Public Sub ZoomToFit(
    items As IEnumerable(Of MapItem),
    paddingFactor As Double = 0.15
)

Parameters

Name	Type	Description
items	IEnumerable<MapItem>	A set of MapItem descendant objects that should be visible on a map after zooming.

Optional Parameters

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

Remarks

This method works as follows.

• Calculates a bounding box around map items.

  

• Zooms the map to fit the box. Note that the padding factor is applied to the larger dimension of the box.

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

  

  When the horizontal dimension is larger than the vertical, the zoom appears as follows.

  

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

In the instance of the following code

XAML

<dxm:MapControl x:Name="map">
    <dxm:VectorLayer DataLoaded="VectorLayer_DataLoaded">
        <dxm:MapItemStorage x:Name="storage">
            <!--...-->
        </dxm:MapItemStorage>
    </dxm:VectorLayer>
</dxm:MapControl>

C#

private void VectorLayer_DataLoaded(object sender, DataLoadedEventArgs e) {
    map.ZoomToFit(storage.Items, 0.3);
}

VB.NET

Private Sub VectorLayer_DataLoaded(ByVal sender As Object, ByVal e As DataLoadedEventArgs)
    map.ZoomToFit(storage.Items, 0.3)
End Sub

the result should look like the following.