Class
EmptyMapProvider

Provides an empty map implementation that displays no content, useful for scenarios requiring a blank map canvas or as a placeholder provider.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.RadMap.dll

Syntax:

cs-api-definition
public class EmptyMapProvider : IMapProvider, ICloneable

Inheritance: objectEmptyMapProvider

Implements: ICloneableIMapProvider

Constructors

EmptyMapProvider()

Declaration

cs-api-definition
public EmptyMapProvider()

Properties

Id

Gets the unique identifier for this empty map provider, always returning "Empty".

Declaration

cs-api-definition
public string Id { get; }

Property Value

string

Implements IMapProvider.Id

Initialized

Gets a value indicating whether this empty map provider has completed its initialization process.

Declaration

cs-api-definition
public bool Initialized { get; protected set; }

Property Value

bool

MaxZoomLevel

Gets or sets the maximum zoom level supported by this empty map provider.

Declaration

cs-api-definition
public int MaxZoomLevel { get; set; }

Property Value

int

Implements IMapProvider.MaxZoomLevel

MinZoomLevel

Gets or sets the minimum zoom level supported by this empty map provider.

Declaration

cs-api-definition
public int MinZoomLevel { get; set; }

Property Value

int

Implements IMapProvider.MinZoomLevel

Methods

Clone()

Creates a deep copy of this EmptyMapProvider instance with identical configuration settings.

Declaration

cs-api-definition
public object Clone()

Returns

object

A new EmptyMapProvider object that is a copy of this instance.

Implements ICloneable.Clone()

GetContent(IMapViewport)

Retrieves the visual elements for the current viewport, always returning an empty collection as this provider displays no content.

Declaration

cs-api-definition
public IEnumerable<MapVisualElement> GetContent(IMapViewport viewport)

Parameters

viewport

IMapViewport

The IMapViewport defining the current view area and settings.

Returns

IEnumerable<MapVisualElement>

An empty enumerable collection of MapVisualElement objects.

Implements IMapProvider.GetContent(IMapViewport)

GetSupportedViews()

Gets the list of supported map views for this provider, always returning null as no views are supported.

Declaration

cs-api-definition
public List<MapViewInfo> GetSupportedViews()

Returns

List<MapViewInfo>

Always returns null since empty provider supports no specific views.

Implements IMapProvider.GetSupportedViews()

Initialize()

Initializes the empty map provider, marking it as ready and raising the initialization complete event.

Declaration

cs-api-definition
public void Initialize()

Implements IMapProvider.Initialize()

OnInitializationComplete()

Raises the InitializationComplete event when provider initialization is successfully completed.

Declaration

cs-api-definition
protected virtual void OnInitializationComplete()

OnInitializationError()

Raises the InitializationError event when an error occurs during provider initialization.

Declaration

cs-api-definition
protected virtual void OnInitializationError()

OnProviderUpdated()

Raises the ProviderUpdated event when provider content changes.

Declaration

cs-api-definition
protected virtual void OnProviderUpdated()

SetView(MapViewInfo)

Sets the active map view for this provider, currently not implemented for empty provider.

Declaration

cs-api-definition
public void SetView(MapViewInfo view)

Parameters

view

MapViewInfo

The MapViewInfo representing the desired map view.

Implements IMapProvider.SetView(MapViewInfo)

ViewportChanged(IMapViewport, ViewportChangeAction)

Responds to viewport changes by initializing the provider if not already initialized, but performs no content operations.

Declaration

cs-api-definition
public void ViewportChanged(IMapViewport viewport, ViewportChangeAction action)

Parameters

viewport

IMapViewport

The IMapViewport representing the current view settings and visible area.

action

ViewportChangeAction

The ViewportChangeAction indicating the type of viewport change that occurred.

Implements IMapProvider.ViewportChanged(IMapViewport, ViewportChangeAction)

Events

InitializationComplete

Occurs when the provider initialization process is completed successfully.

Declaration

cs-api-definition
public event EventHandler InitializationComplete

Event Value

EventHandler

Implements IMapProvider.InitializationComplete

InitializationError

Occurs when an error is encountered during the provider initialization process.

Declaration

cs-api-definition
public event InitializationErrorEventHandler InitializationError

Event Value

InitializationErrorEventHandler

Implements IMapProvider.InitializationError

ProviderUpdated

Occurs when the provider content is updated, though empty provider never updates its content.

Declaration

cs-api-definition
public event EventHandler ProviderUpdated

Event Value

EventHandler

Implements IMapProvider.ProviderUpdated