MapControl.ZoomToFitLayerItems(Double) Method

Zooms a map to fit items contained in all layers of the map.

Namespace: DevExpress.Xpf.Map

Assembly: DevExpress.Xpf.Map.v20.1.dll

Declaration

public void ZoomToFitLayerItems(
    double paddingFactor = 0.15000000596046448
)
Public Sub ZoomToFitLayerItems(
    paddingFactor As Double = 0.15000000596046448
)

Optional Parameters

Name Type Default Description
paddingFactor Double

0.150000005960464

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 contained in map layers.

    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 horizontal dimension larger than the vertical. ("PF" means "Padding Factor" on images)

    WpfMapControl_ZoomToFit_HorizontalFitting

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

    WpfMapControl_ZoomToFit_VerticalFitting

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

In using this code:

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

you will produce a map that looks like this:

WpfMapControl_ZoomToFit_NumericExample

Example

To zoom in a map at the application launch, call the ZoomToFitLayerItems method in the LayerBase.DataLoaded event handler:

<dxm:VectorLayer x:Name="layer1" DataLoaded="VectorLayer_DataLoaded">
    <dxm:MapItemStorage>
        <dxm:MapRectangle Height="21" Width="30">
            <dxm:MapRectangle.Location>
                <dxm:GeoPoint Longitude="41.3" Latitude="-54.5"/>
            </dxm:MapRectangle.Location>
        </dxm:MapRectangle>
    </dxm:MapItemStorage>
</dxm:VectorLayer>

The DataLoaded event's handler:

private void VectorLayer_DataLoaded(object sender, DataLoadedEventArgs e) {
    mapControl.ZoomToFitLayerItems(0.3);            
}
See Also