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

Declaration

C#

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

VB.NET

Public Sub ZoomToFitLayerItems(
    layers As IEnumerable(Of LayerBase),
    paddingFactor As Double
)

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 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 specidied layers.

    

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

    

    When the vertical dimension larger than the horizontal, 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

  C#

  map.ZoomToFit(new LayerBase[] {vectorLayer}, 0.3);
  

  VB.NET

  map.ZoomToFit(New LayerBase() {vectorLayer}, 0.3)
  

  The result should look as follows.