LayerBase.RectangleClip Property

Specifies a rectangle that limits the layer’s displayed area.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v24.1.dll

NuGet Package: DevExpress.Win.Map

Declaration

C#

public Rectangle RectangleClip { get; set; }

VB.NET

Public Property RectangleClip As Rectangle

Property Value

Type	Description
Rectangle	A rectangle that limits the layer’s displayed area.

Remarks

The following example creates two layers within the Map Control and limits the displayed area of the second layer:

C#

private void Form1_Load(object sender, EventArgs e) {
    ImageLayer imageLayer1 = new ImageLayer();
    BingMapDataProvider bingMapProvider1 = new BingMapDataProvider();
    bingMapProvider1.BingKey = "Your bing key here";
    bingMapProvider1.Kind = BingMapKind.Road;
    imageLayer1.DataProvider = bingMapProvider1;
    mapControl1.Layers.Add(imageLayer1);

    ImageLayer imageLayer2 = new ImageLayer();
    BingMapDataProvider bingMapProvider2 = new BingMapDataProvider();
    bingMapProvider1.BingKey = "Your bing key here";
    bingMapProvider2.Kind = BingMapKind.Hybrid;
    imageLayer2.DataProvider = bingMapProvider2;
    imageLayer2.RectangleClip = new Rectangle(200, 50, 170, 130);
    mapControl1.Layers.Add(imageLayer2);
}

VB.NET

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs)
    Dim imageLayer1 As ImageLayer = New ImageLayer()
    Dim bingMapProvider1 As BingMapDataProvider = New BingMapDataProvider()
    bingMapProvider1.BingKey = "Your bing key here"
    bingMapProvider1.Kind = BingMapKind.Road
    imageLayer1.DataProvider = bingMapProvider1
    mapControl1.Layers.Add(imageLayer1)

    Dim imageLayer2 As ImageLayer = New ImageLayer()
    Dim bingMapProvider2 As BingMapDataProvider = New BingMapDataProvider()
    bingMapProvider1.BingKey = "Your bing key here"
    bingMapProvider2.Kind = BingMapKind.Hybrid
    imageLayer2.DataProvider = bingMapProvider2
    imageLayer2.RectangleClip = New Rectangle(200, 50, 170, 130)
    mapControl1.Layers.Add(imageLayer2)
End Sub

The related API members:

Name	Description
ImageLayer	Displays map images obtained from map image data providers.
BingMapDataProvider	The class that loads map images from the Bing Maps data provider.
BingMapDataProvider.BingKey	Get or sets the key that is required to connect to the Bing Maps data provider.
BingMapDataProvider.Kind	Specifies the type of images that the map displays.
DevExpress.XtraMap.ImageLayer.DataProvider	Gets or sets the provider used to obtain images from an external source.
DevExpress.XtraMap.MapControl.Layers	Contains the collection of layers displayed within the MapControl.