Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

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.2.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

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

the result should look like the following.

WpfMapControl_ZoomToFit_NumericExample

See Also