Class MapNavigationBarElement

Represents a navigation bar element for map controls, providing zoom controls, view selection, and directional navigation functionality with customizable positioning.

Inheritance
System.Object
DisposableObject
RadObject
RadElement
VisualElement
RadComponentElement
RadItem
UIItemBase
LightVisualElement
MapNavigationBarElement
Inherited Members
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.RadMap.dll

Syntax

public class MapNavigationBarElement : LightVisualElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IComponent, IDisposable, IBindableComponent, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider

Constructors

MapNavigationBarElement(RadMapElement)

Initializes a new instance of the MapNavigationBarElement class and associates it with the specified map element for navigation operations.

Declaration
public MapNavigationBarElement(RadMapElement mapElement)
Parameters
RadMapElement mapElement

The RadMapElement that this navigation bar will control for zoom and navigation operations.

Fields

NavigationBarLocationProperty

Identifies the NavigationBarLocation dependency property that determines the positioning of the navigation bar within the map control.

Declaration
public static RadProperty NavigationBarLocationProperty
Field Value
RadProperty

Properties

MapElement

Gets the map element that this navigation bar is associated with for controlling zoom levels and navigation operations.

Declaration
public RadMapElement MapElement { get; }
Property Value
RadMapElement

MapNavigationElement

Gets the navigation element that provides directional controls for panning the map view in four cardinal directions.

Declaration
public MapNavigationElement MapNavigationElement { get; }
Property Value
MapNavigationElement

NavigationBarLocation

Gets or sets the location where the navigation bar is positioned within the map control, affecting layout and arrangement of child elements.

Declaration
public MapNavigationBarLocation NavigationBarLocation { get; set; }
Property Value
MapNavigationBarLocation

ViewButton

Gets the view button element that allows users to switch between different map views and toggle label display settings.

Declaration
public MapViewButton ViewButton { get; }
Property Value
MapViewButton

ZoomInButton

Gets the zoom in button element that allows users to increase the map zoom level for more detailed viewing.

Declaration
public MapZoomInButton ZoomInButton { get; }
Property Value
MapZoomInButton

ZoomOutButton

Gets the zoom out button element that allows users to decrease the map zoom level for broader viewing.

Declaration
public MapZoomOutButton ZoomOutButton { get; }
Property Value
MapZoomOutButton

Methods

ArrangeOverride(SizeF)

Arranges the navigation bar child elements within the specified final size based on the navigation bar location and other map element positions.

Declaration
protected override SizeF ArrangeOverride(SizeF finalSize)
Parameters
System.Drawing.SizeF finalSize

The System.Drawing.SizeF representing the final arrangement size for the navigation bar.
Returns
System.Drawing.SizeF

A System.Drawing.SizeF representing the actual arranged size of the navigation bar.
Overrides

CreateChildElements()

Creates and initializes all child elements of the navigation bar, including zoom buttons, view button, and navigation element.

Declaration
protected override void CreateChildElements()
Overrides

CreateNavigationElement()

Creates and configures a navigation element that provides directional navigation controls for panning the map view.

Declaration
protected virtual MapNavigationElement CreateNavigationElement()
Returns
MapNavigationElement

A configured MapNavigationElement for directional map navigation.

CreateViewButton()

Creates and configures a view button with appropriate styling and event handling for switching between different map view modes and label settings.

Declaration
protected virtual MapViewButton CreateViewButton()
Returns
MapViewButton

A configured MapViewButton for changing map views and display options.

CreateZoomInButton()

Creates and configures a zoom in button with appropriate styling and event handling for increasing the map zoom level.

Declaration
protected virtual MapZoomInButton CreateZoomInButton()
Returns
MapZoomInButton

A configured MapZoomInButton for zooming in on the map.

CreateZoomOutButton()

Creates and configures a zoom out button with appropriate styling and event handling for decreasing the map zoom level.

Declaration
protected virtual MapZoomOutButton CreateZoomOutButton()
Returns
MapZoomOutButton

A configured MapZoomOutButton for zooming out on the map.

InitializeFields()

Initializes the default field values and properties for the navigation bar element, including focus settings and default positioning.

Declaration
protected override void InitializeFields()
Overrides

MeasureOverride(SizeF)

Measures the required size for the navigation bar element based on the current navigation bar location and child element dimensions.

Declaration
protected override SizeF MeasureOverride(SizeF availableSize)
Parameters
System.Drawing.SizeF availableSize

The System.Drawing.SizeF representing the available space for measurement.
Returns
System.Drawing.SizeF

A System.Drawing.SizeF representing the required size for the navigation bar display.
Overrides

OnProviderInitializationComplete(IMapProvider)

Handles the completion of map provider initialization by updating the view button visibility based on supported views.

Declaration
public virtual void OnProviderInitializationComplete(IMapProvider mapProvider)
Parameters
IMapProvider mapProvider

The IMapProvider that has completed initialization.

OnViewButtonClick(Object, EventArgs)

Handles the click event of the view button by displaying a context menu with available map views and label display options.

Declaration
protected virtual void OnViewButtonClick(object sender, EventArgs e)
Parameters
System.Object sender

The source of the event.
System.EventArgs e

An System.EventArgs that contains the event data.

OnZoomInButtonClick(Object, EventArgs)

Handles the click event of the zoom in button by increasing the map zoom level by one step.

Declaration
protected virtual void OnZoomInButtonClick(object sender, EventArgs e)
Parameters
System.Object sender

The source of the event.
System.EventArgs e

An System.EventArgs that contains the event data.

OnZoomOutButtonClick(Object, EventArgs)

Handles the click event of the zoom out button by decreasing the map zoom level by one step.

Declaration
protected virtual void OnZoomOutButtonClick(object sender, EventArgs e)
Parameters
System.Object sender

The source of the event.
System.EventArgs e

An System.EventArgs that contains the event data.

Extension Methods