ItemsLayerLegend.Layer Property

Specifies the layer from which the legend obtains data to display.

Namespace: DevExpress.Xpf.Map

Assembly: DevExpress.Xpf.Map.v18.2.dll

Declaration

C#

public VectorLayer Layer { get; set; }

VB.NET

Public Property Layer As VectorLayer

Property Value

Type	Description
VectorLayer	A VectorLayer object.

Remarks

Using this property, the legend gets the information about the colors (for color legends) or sizes (for the size legend) of the specified layer.

Example

To add a legend to the map do the following.

• Create a MapLegendBase class descendant object and add it to the MapControl.Legends collection.
• Optionally, specify the MapLegendBase.Header and MapLegendBase.Description properties.
• If it needed, specify the ItemsLayerLegend.Layer property of the legend.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-colorize-map-contours-loaded-from-shapefiles-using-the-choropleth-colorizer-e4587.

MainWindow.xaml

<dxm:MapControl.Legends>
    <dxm:ColorScaleLegend Layer="{Binding ElementName=mapLayer}" Header="GDP By Countries"
                          Description="In US dollars." RangeStopsFormat="0,B" MinWidth="550"/>
</dxm:MapControl.Legends>

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Layer property.

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.

C#

wpf-mapcontrol-getting-started-lesson-3-add-analytical-data-to-a-geographical-map-t177876/VB/Wpf_MapControl_Lesson3/MainWindow.xaml#L17

<dxm:MapControl.Legends>
    <dxm:SizeLegend Header="Medal Count" Layer="{Binding ElementName=vectorLayer}"/>
    <dxm:ColorListLegend Header="Medal Class" Layer="{Binding ElementName=vectorLayer}"/>

lesson-2-load-vector-cartesian-data-t230190/CS/MapLesson2/MainWindow.xaml#L12

    <dxm:ColorListLegend Header="Room Type"
                         Layer="{Binding ElementName=vectorLayer, Mode=OneWay}"/>
</dxm:MapControl.Legends>

how-to-colorize-map-contours-loaded-from-shapefiles-using-the-choropleth-colorizer-e4587/VB/Wpf_MapControl_ChoroplethColorizer/MainWindow.xaml#L34

<dxm:MapControl.Legends>
    <dxm:ColorScaleLegend Layer="{Binding ElementName=mapLayer}" Header="GDP By Countries"
                          Description="In US dollars." RangeStopsFormat="0,B" MinWidth="550"/>

mapcontrol-getting-started-lesson-2-load-a-vector-map-t190755/VB/MapControl_Lesson2/MainWindow.xaml#L12

RangeStopsFormat="0,B"
Layer="{Binding ElementName=vectorLayer}"
MinWidth="525"/>