Skip to main content

MapControl.ZoomToFitLayerItems(IEnumerable<LayerBase>, Double) Method

Zooms the map to fit items contained in the specified set of LayerBase class descendant objects.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v24.1.dll

NuGet Package: DevExpress.Win.Map

Declaration

public void ZoomToFitLayerItems(
    IEnumerable<LayerBase> layers,
    double paddingFactor
)

Parameters

Name Type Description
layers IEnumerable<LayerBase>

A IEnumerable object, containing LayerBase class descendant objects.

paddingFactor Double

A Double value, which tunes the border size around visible map items.

Remarks

When vector items are loaded at runtime, the ZoomToFitLayerItems method should be called from LayerBase.DataLoaded event handler.

The ZoomToFitLayerItems method works as follows:

  • Calculates a bounding box around items.

    ZoomToFit_DescribedRegion

  • 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 of a horizontal dimension that is larger than the vertical (“PF” means “Padding Factor” on images).

    ZoomToFit_ZoomedMap

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

    ZoomToFit_VerticalSizeZooming

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

Example

The following image shows a map that is zoomed with paddingFactor equal to 0.3:

ZoomToFit_ZoomExample

using DevExpress.XtraMap;

private void OnVectorLayerDataLoaded(object sender, DataLoadedEventArgs e) {
    mapControl1.ZoomToFitLayerItems(new LayerBase[] { vectorLayer }, 0.3);
}
See Also