Skip to main content

MapControl.ZoomToFitLayerItems(Double) Method

Zooms the map to fit items contained by the MapControl.Layers property.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v24.1.dll

NuGet Package: DevExpress.Win.Map

Declaration

public void ZoomToFitLayerItems(
    double paddingFactor
)

Parameters

Name Type Description
paddingFactor Double

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

Remarks

  • When vector items loading in a runtime this method should be called from LayerBase.DataLoaded event handler.
  • This method works as follows.

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

      ZoomToFit_DescribedRegion

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

      The following image shows an instance when the horizontal dimension 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.

    In the instance of the following code

    map.ZoomToFitLayerItems(0.3);
    

    the result should look like the following.

    ZoomToFit_ZoomExample

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.

See Also