Skip to main content

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

public void ZoomToFit(
    IEnumerable<MapItem> items,
    double paddingFactor = 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.

    WpfMapControl_ZoomToFit_BoundingBox

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

    WpfMapControl_ZoomToFit_VerticalFitting

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

    WpfMapControl_ZoomToFit_HorizontalFitting

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

In the instance of the following code

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

the result should look like the following.

WpfMapControl_ZoomToFit_NumericExample

See Also