VectorTileDataProviderBase.StyleFileUri Property

Gets or sets a style used to customize the vector tile map’s appearance.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v20.2.dll

NuGet Package: DevExpress.Win.Map

Declaration

C#

[DefaultValue(null)]
public Uri StyleFileUri { get; set; }

VB.NET

<DefaultValue(Nothing)>
Public Property StyleFileUri As Uri

Property Value

Type	Default	Description
Uri	*null*	A Uri object that specifies the style file’s location.

Remarks

Use the StyleFileUri property to define a path to a style file. A style should be a valid JSON file and meet specifications.

The Map Control supports layers and the following related properties:

• filter
• paint
  • fill-color
  • fill-opacity
  • line-color
  • line-opacity
  • line-width
  • text-color
• layout
  • visibility
  • text-field
  • text-font
  • text-max-width
  • text-size
  • text-transform

Property values can be set directly (for example, “text-size”: 10) or via an interpolation syntax (for example, “line-width”: {“base”: 1.2, “stops”: [[15, 1], [17, 4]]}).

The following color formats are supported: hsl, rgb, rgba, hsla, hex. You can use web color names, such as red or yellow.

If a style uses custom fonts (not installed on the client machine), specify a path to a directory that contains fonts (.TTF files) via the provider’s FontFolder property. Otherwise, the default font (Segoe UI) is used.

Note: Install the Newtonsoft.Json package if your application does not reference this library.

Example

The following example shows how use the MbTilesDataProvider to load vector tiles from an MbTiles file:

C#

private void Form1_Load(object sender, EventArgs e) {
    ImageLayer layer = new ImageLayer();
    MbTilesDataProvider dataProvider = new MbTilesDataProvider();
    dataProvider.FileUri = new Uri(@"D:\countries.mbtiles", UriKind.Absolute);
    dataProvider.StyleFileUri = new Uri(@"D:\style.json", UriKind.Absolute);
    layer.DataProvider = dataProvider;
    mapControl1.Layers.Add(layer);
}            

VB.NET

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs)
    Dim layer As ImageLayer = New ImageLayer()
    Dim dataProvider As MbTilesDataProvider = New MbTilesDataProvider()
    dataProvider.FileUri = New Uri("D:\countries.mbtiles", UriKind.Absolute)
    dataProvider.StyleFileUri = New Uri("D:\style.json", UriKind.Absolute)
    layer.DataProvider = dataProvider
    mapControl1.Layers.Add(layer)
End Sub