New to Telerik UI for WinFormsStart a free 30-day trial

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:

C#
public class EmptyMapProvider : IMapProvider, ICloneable

Inheritance: objectEmptyMapProvider

Implements: ICloneableIMapProvider

Constructors

C#
public EmptyMapProvider()

Properties

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

C#
public string Id { get; }

Implements: IMapProvider.Id

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

C#
public bool Initialized { get; protected set; }

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

C#
public int MaxZoomLevel { get; set; }

Implements: IMapProvider.MaxZoomLevel

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

C#
public int MinZoomLevel { get; set; }

Implements: IMapProvider.MinZoomLevel

Methods

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

C#
public object Clone()
Returns:

object

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

Implements: ICloneable.Clone()

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

C#
public IEnumerable<MapVisualElement> GetContent(IMapViewport viewport)
Parameters:viewportIMapViewport

The IMapViewport defining the current view area and settings.

Returns:

IEnumerable<MapVisualElement>

An empty enumerable collection of MapVisualElement objects.

Implements: IMapProvider.GetContent(IMapViewport)

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

C#
public List<MapViewInfo> GetSupportedViews()
Returns:

List<MapViewInfo>

Always returns null since empty provider supports no specific views.

Implements: IMapProvider.GetSupportedViews()

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

C#
public void Initialize()

Implements: IMapProvider.Initialize()

Raises the InitializationComplete event when provider initialization is successfully completed.

C#
protected virtual void OnInitializationComplete()

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

C#
protected virtual void OnInitializationError()

Raises the ProviderUpdated event when provider content changes.

C#
protected virtual void OnProviderUpdated()

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

C#
public void SetView(MapViewInfo view)
Parameters:viewMapViewInfo

The MapViewInfo representing the desired map view.

Implements: IMapProvider.SetView(MapViewInfo)

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

C#
public void ViewportChanged(IMapViewport viewport, ViewportChangeAction action)
Parameters:viewportIMapViewport

The IMapViewport representing the current view settings and visible area.

actionViewportChangeAction

The ViewportChangeAction indicating the type of viewport change that occurred.

Implements: IMapProvider.ViewportChanged(IMapViewport, ViewportChangeAction)

Events

Occurs when the provider initialization process is completed successfully.

C#
public event EventHandler InitializationComplete

Implements: IMapProvider.InitializationComplete

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

C#
public event InitializationErrorEventHandler InitializationError

Implements: IMapProvider.InitializationError

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

C#
public event EventHandler ProviderUpdated

Implements: IMapProvider.ProviderUpdated