New to Telerik UI for WPF? Start a free 30-day trial

MapShape

Class

Base class which represents any shape specified in the geographical coordinates.

Definition

Namespace:Telerik.Windows.Controls.Map

Assembly:Telerik.Windows.Controls.DataVisualization.dll

Syntax:

public abstract class MapShape : Control, IExtendedData, IColorable, IGeoSizeProvider

Inheritance: objectMapShape

Derived Classes: MapEllipseMapLineMapPathMapPolylineMapRectangle

Implements: IColorableIExtendedDataIGeoSizeProvider

Constructors

MapShape()

Initializes a new instance of the MapShape class.

protected MapShape()

Fields

CaptionLocationProperty

DependencyProperty

Identifies the CaptionLocation dependency property.

public static readonly DependencyProperty CaptionLocationProperty

CaptionTemplateProperty

DependencyProperty

Identifies the CaptionTemplate dependency property.

public static readonly DependencyProperty CaptionTemplateProperty

FillProperty

DependencyProperty

Identifies the Fill dependency property.

public static readonly DependencyProperty FillProperty

HighlightFillProperty

DependencyProperty

Identifies the HighlightFill dependency property.

public static readonly DependencyProperty HighlightFillProperty

ShapeFillProperty

DependencyProperty

Identifies the ShapeFillProperty dependency property.

public static readonly DependencyProperty ShapeFillProperty

StrokeDashArrayProperty

DependencyProperty

Identifies the StrokeDashArray dependency property.

public static readonly DependencyProperty StrokeDashArrayProperty

StrokeDashCapProperty

DependencyProperty

Identifies the StrokeDashCap dependency property.

public static readonly DependencyProperty StrokeDashCapProperty

StrokeDashOffsetProperty

DependencyProperty

Identifies the StrokeDashOffset dependency property.

public static readonly DependencyProperty StrokeDashOffsetProperty

StrokeEndLineCapProperty

DependencyProperty

Identifies the StrokeEndLineCap dependency property.

public static readonly DependencyProperty StrokeEndLineCapProperty

StrokeLineJoinProperty

DependencyProperty

Identifies the StrokeLineJoin dependency property.

public static readonly DependencyProperty StrokeLineJoinProperty

StrokeMiterLimitProperty

DependencyProperty

Identifies the StrokeMiterLimit dependency property.

public static readonly DependencyProperty StrokeMiterLimitProperty

StrokeProperty

DependencyProperty

Identifies the Stroke dependency property.

public static readonly DependencyProperty StrokeProperty

StrokeStartLineCapProperty

DependencyProperty

Identifies the StrokeStartLineCap dependency property.

public static readonly DependencyProperty StrokeStartLineCapProperty

StrokeThicknessProperty

DependencyProperty

Identifies the StrokeThickness dependency property.

public static readonly DependencyProperty StrokeThicknessProperty

VisibilityListenerProperty

DependencyProperty

Listener for the Visibility property.

public static readonly DependencyProperty VisibilityListenerProperty

Properties

CaptionLocation

Location

Gets or sets the location of the map shape caption.

public Location CaptionLocation { get; set; }

CaptionTemplate

DataTemplate

Gets or sets caption content template. You can bind elements in the caption template to extended properties using ExtendedDataConverter and Data property of the ExtendedData object.

public DataTemplate CaptionTemplate { get; set; }

ExtendedData

Gets or sets shape's extended data.

public ExtendedData ExtendedData { get; set; }

Implements: IExtendedData.ExtendedData

Fill

Brush

Gets or sets the Brush that specifies how the shape's interior is painted.

public Brush Fill { get; set; }

GeoBounds

LocationRect

Gets geographical bounds of the shape.

public LocationRect GeoBounds { get; }

Implements: IGeoSizeProvider.GeoBounds

GeographicalBounds

LocationRect

Gets geographical bounds of the shape.

public LocationRect GeographicalBounds { get; }

GeoSize

Size

Gets or sets geographical size of the shape.

public Size GeoSize { get; }

Implements: IGeoSizeProvider.GeoSize

HighlightFill

MapShapeFill

Gets or sets the highlight shape fill properties.

public MapShapeFill HighlightFill { get; set; }

Implements: IColorable.HighlightFill

NeedUpdateLocation

bool

Gets or sets value which indicates whether we should update location of this shape.

protected bool NeedUpdateLocation { get; set; }

ScreenBounds

Rect

Gets bounding rectangle given in pixels.

public abstract Rect ScreenBounds { get; }

ShapeFill

MapShapeFill

Gets or sets the shape fill properties.

public MapShapeFill ShapeFill { get; set; }

Implements: IColorable.ShapeFill

Stroke

Brush

Gets or sets the Brush that specifies how the Shape outline is painted.

public Brush Stroke { get; set; }

StrokeDashArray

DoubleCollection

Gets or sets a collection of Double values that indicate the pattern of dashes and gaps that is used to outline shapes.

public DoubleCollection StrokeDashArray { get; set; }

StrokeDashCap

PenLineCap

Gets or sets a PenLineCap enumeration value that specifies how the ends of a dash are drawn.

public PenLineCap StrokeDashCap { get; set; }

StrokeDashOffset

double

Gets or sets a Double that specifies the distance within the dash pattern where a dash begins.

public double StrokeDashOffset { get; set; }

StrokeEndLineCap

PenLineCap

Gets or sets a PenLineCap enumeration value that describes the Shape at the end of a line.

public PenLineCap StrokeEndLineCap { get; set; }

StrokeLineJoin

PenLineJoin

Gets or sets a PenLineJoin enumeration value that specifies the type of join that is used at the vertices of a Shape.

public PenLineJoin StrokeLineJoin { get; set; }

StrokeMiterLimit

double

Gets or sets a limit on the ratio of the miter length to half the StrokeThickness of a Shape element.

public double StrokeMiterLimit { get; set; }

StrokeStartLineCap

PenLineCap

Gets or sets a PenLineCap enumeration value that describes the Shape at the start of a Stroke.

public PenLineCap StrokeStartLineCap { get; set; }

StrokeThickness

double

Gets or sets the width of the Shape outline.

public double StrokeThickness { get; set; }

Methods

CaptureMouse()

Sets mouse capture to a UIElement.

public bool CaptureMouse()

Returns:

bool

Returns true if the object has mouse capture; otherwise, returns false.

MoveTo(Location)

Change location of the shape.

public abstract void MoveTo(Location location)

Parameters:locationLocation

New location.

OnMapCanvasChanged(MapCanvas, MapCanvas)

Is called when map canvas is changed.

protected virtual void OnMapCanvasChanged(MapCanvas oldCanvas, MapCanvas newCanvas)

Parameters:oldCanvasMapCanvas

Old map canvas.

newCanvasMapCanvas

New map canvas.

OnMapControlChanged(RadMap, RadMap)

Is called when map control is changed.

protected virtual void OnMapControlChanged(RadMap oldMap, RadMap newMap)

Parameters:oldMapRadMap

Old map control.

newMapRadMap

New map control.

PrepareShape()

Calculates pixel size and prepare graphical shape representation.

protected abstract Size PrepareShape()

Returns:

Size

PreprocessTransformation()

Preprocess render transform.

protected void PreprocessTransformation()

RaiseEvent(RoutedEventArgs)

Raises a specific routed event. The RoutedEvent to be raised is identified within the RoutedEventArgs instance that is provided (as the RoutedEvent property of that event data).

public void RaiseEvent(RoutedEventArgs args)

Parameters:argsRoutedEventArgs

A RoutedEventArgs that contains the event data and also identifies the event to raise.

ReleaseMouseCapture()

Removes mouse capture from a UIElement. After this call, typically no object holds mouse capture.

public void ReleaseMouseCapture()

SetShapeFillStroke()

Sets shape's filling and stroke parameters.

protected void SetShapeFillStroke()

SetupEvents()

Creates mouse event handlers.

protected void SetupEvents()

UseHighlightFill()

Use highlight fill and stroke settings.

public void UseHighlightFill()

UseRegularFill()

Use regular fill and stroke settings.

public void UseRegularFill()

Events

MouseEnter

MouseEventHandler

Occurs when any mouse button is pressed while the pointer is over this element.

public event MouseEventHandler MouseEnter

MouseLeave

MouseEventHandler

Occurs when the mouse pointer leaves the bounds of this element.

public event MouseEventHandler MouseLeave

MouseLeftButtonDown

MouseButtonEventHandler

Occurs when the left mouse button is pressed while the mouse pointer is over this element.

public event MouseButtonEventHandler MouseLeftButtonDown

MouseLeftButtonUp

MouseButtonEventHandler

Occurs when the left mouse button is released while the mouse pointer is over this element.

public event MouseButtonEventHandler MouseLeftButtonUp

MouseMove

MouseEventHandler

Occurs when the mouse pointer moves while over this element.

public event MouseEventHandler MouseMove

MouseRightButtonDown

MouseButtonEventHandler

Occurs when the right mouse button is pressed while the mouse pointer is over this element.

public event MouseButtonEventHandler MouseRightButtonDown

MouseRightButtonUp

MouseButtonEventHandler

Occurs when the right mouse button is released while the mouse pointer is over this element.

public event MouseButtonEventHandler MouseRightButtonUp

MouseWheel

MouseWheelEventHandler

Occurs when the user rotates the mouse wheel while the mouse pointer is over this element.

public event MouseWheelEventHandler MouseWheel