Class
MapShape

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

Definition

Namespace:Telerik.Windows.Controls.Map

Assembly:Telerik.Windows.Controls.DataVisualization.dll

Syntax:

cs-api-definition
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.

Declaration

cs-api-definition
protected MapShape()

Fields

CaptionLocationProperty

Identifies the CaptionLocation dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty CaptionLocationProperty

Field Value

DependencyProperty

CaptionTemplateProperty

Identifies the CaptionTemplate dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty CaptionTemplateProperty

Field Value

DependencyProperty

FillProperty

Identifies the Fill dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty FillProperty

Field Value

DependencyProperty

HighlightFillProperty

Identifies the HighlightFill dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty HighlightFillProperty

Field Value

DependencyProperty

ShapeFillProperty

Identifies the ShapeFillProperty dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty ShapeFillProperty

Field Value

DependencyProperty

StrokeDashArrayProperty

Identifies the StrokeDashArray dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty StrokeDashArrayProperty

Field Value

DependencyProperty

StrokeDashCapProperty

Identifies the StrokeDashCap dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty StrokeDashCapProperty

Field Value

DependencyProperty

StrokeDashOffsetProperty

Identifies the StrokeDashOffset dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty StrokeDashOffsetProperty

Field Value

DependencyProperty

StrokeEndLineCapProperty

Identifies the StrokeEndLineCap dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty StrokeEndLineCapProperty

Field Value

DependencyProperty

StrokeLineJoinProperty

Identifies the StrokeLineJoin dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty StrokeLineJoinProperty

Field Value

DependencyProperty

StrokeMiterLimitProperty

Identifies the StrokeMiterLimit dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty StrokeMiterLimitProperty

Field Value

DependencyProperty

StrokeProperty

Identifies the Stroke dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty StrokeProperty

Field Value

DependencyProperty

StrokeStartLineCapProperty

Identifies the StrokeStartLineCap dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty StrokeStartLineCapProperty

Field Value

DependencyProperty

StrokeThicknessProperty

Identifies the StrokeThickness dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty StrokeThicknessProperty

Field Value

DependencyProperty

VisibilityListenerProperty

Listener for the Visibility property.

Declaration

cs-api-definition
public static readonly DependencyProperty VisibilityListenerProperty

Field Value

DependencyProperty

Properties

CaptionLocation

Gets or sets the location of the map shape caption.

Declaration

cs-api-definition
public Location CaptionLocation { get; set; }

Property Value

Location

CaptionTemplate

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.

Declaration

cs-api-definition
public DataTemplate CaptionTemplate { get; set; }

Property Value

DataTemplate

ExtendedData

Gets or sets shape's extended data.

Declaration

cs-api-definition
public ExtendedData ExtendedData { get; set; }

Property Value

ExtendedData

Implements IExtendedData.ExtendedData

Fill

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

Declaration

cs-api-definition
public Brush Fill { get; set; }

Property Value

Brush

GeoBounds

Gets geographical bounds of the shape.

Declaration

cs-api-definition
public LocationRect GeoBounds { get; }

Property Value

LocationRect

Implements IGeoSizeProvider.GeoBounds

GeoSize

Gets or sets geographical size of the shape.

Declaration

cs-api-definition
public Size GeoSize { get; }

Property Value

Size

Implements IGeoSizeProvider.GeoSize

GeographicalBounds

Gets geographical bounds of the shape.

Declaration

cs-api-definition
public LocationRect GeographicalBounds { get; }

Property Value

LocationRect

HighlightFill

Gets or sets the highlight shape fill properties.

Declaration

cs-api-definition
public MapShapeFill HighlightFill { get; set; }

Property Value

MapShapeFill

Implements IColorable.HighlightFill

NeedUpdateLocation

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

Declaration

cs-api-definition
protected bool NeedUpdateLocation { get; set; }

Property Value

bool

ScreenBounds

Gets bounding rectangle given in pixels.

Declaration

cs-api-definition
public abstract Rect ScreenBounds { get; }

Property Value

Rect

ShapeFill

Gets or sets the shape fill properties.

Declaration

cs-api-definition
public MapShapeFill ShapeFill { get; set; }

Property Value

MapShapeFill

Implements IColorable.ShapeFill

Stroke

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

Declaration

cs-api-definition
public Brush Stroke { get; set; }

Property Value

Brush

StrokeDashArray

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

Declaration

cs-api-definition
[SuppressMessage("Microsoft.Usage", "CA2227:CollectionPropertiesShouldBeReadOnly")]
public DoubleCollection StrokeDashArray { get; set; }

Property Value

DoubleCollection

StrokeDashCap

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

Declaration

cs-api-definition
public PenLineCap StrokeDashCap { get; set; }

Property Value

PenLineCap

StrokeDashOffset

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

Declaration

cs-api-definition
public double StrokeDashOffset { get; set; }

Property Value

double

StrokeEndLineCap

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

Declaration

cs-api-definition
public PenLineCap StrokeEndLineCap { get; set; }

Property Value

PenLineCap

StrokeLineJoin

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

Declaration

cs-api-definition
public PenLineJoin StrokeLineJoin { get; set; }

Property Value

PenLineJoin

StrokeMiterLimit

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

Declaration

cs-api-definition
public double StrokeMiterLimit { get; set; }

Property Value

double

StrokeStartLineCap

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

Declaration

cs-api-definition
public PenLineCap StrokeStartLineCap { get; set; }

Property Value

PenLineCap

StrokeThickness

Gets or sets the width of the Shape outline.

Declaration

cs-api-definition
public double StrokeThickness { get; set; }

Property Value

double

Methods

CaptureMouse()

Sets mouse capture to a UIElement.

Declaration

cs-api-definition
public bool CaptureMouse()

Returns

bool

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

MoveTo(Location)

Change location of the shape.

Declaration

cs-api-definition
public abstract void MoveTo(Location location)

Parameters

location

Location

New location.

OnMapCanvasChanged(MapCanvas, MapCanvas)

Is called when map canvas is changed.

Declaration

cs-api-definition
protected virtual void OnMapCanvasChanged(MapCanvas oldCanvas, MapCanvas newCanvas)

Parameters

oldCanvas

MapCanvas

Old map canvas.

newCanvas

MapCanvas

New map canvas.

OnMapControlChanged(RadMap, RadMap)

Is called when map control is changed.

Declaration

cs-api-definition
protected virtual void OnMapControlChanged(RadMap oldMap, RadMap newMap)

Parameters

oldMap

RadMap

Old map control.

newMap

RadMap

New map control.

PrepareShape()

Calculates pixel size and prepare graphical shape representation.

Declaration

cs-api-definition
protected abstract Size PrepareShape()

Returns

Size

PreprocessTransformation()

Preprocess render transform.

Declaration

cs-api-definition
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).

Declaration

cs-api-definition
public void RaiseEvent(RoutedEventArgs args)

Parameters

args

RoutedEventArgs

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.

Declaration

cs-api-definition
public void ReleaseMouseCapture()

SetShapeFillStroke()

Sets shape's filling and stroke parameters.

Declaration

cs-api-definition
protected void SetShapeFillStroke()

SetupEvents()

Creates mouse event handlers.

Declaration

cs-api-definition
protected void SetupEvents()

UseHighlightFill()

Use highlight fill and stroke settings.

Declaration

cs-api-definition
public void UseHighlightFill()

UseRegularFill()

Use regular fill and stroke settings.

Declaration

cs-api-definition
public void UseRegularFill()

Events

MouseEnter

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

Declaration

cs-api-definition
public event MouseEventHandler MouseEnter

Event Value

MouseEventHandler

MouseLeave

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

Declaration

cs-api-definition
public event MouseEventHandler MouseLeave

Event Value

MouseEventHandler

MouseLeftButtonDown

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

Declaration

cs-api-definition
public event MouseButtonEventHandler MouseLeftButtonDown

Event Value

MouseButtonEventHandler

MouseLeftButtonUp

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

Declaration

cs-api-definition
public event MouseButtonEventHandler MouseLeftButtonUp

Event Value

MouseButtonEventHandler

MouseMove

Occurs when the mouse pointer moves while over this element.

Declaration

cs-api-definition
public event MouseEventHandler MouseMove

Event Value

MouseEventHandler

MouseRightButtonDown

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

Declaration

cs-api-definition
public event MouseButtonEventHandler MouseRightButtonDown

Event Value

MouseButtonEventHandler

MouseRightButtonUp

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

Declaration

cs-api-definition
public event MouseButtonEventHandler MouseRightButtonUp

Event Value

MouseButtonEventHandler

MouseWheel

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

Declaration

cs-api-definition
public event MouseWheelEventHandler MouseWheel

Event Value

MouseWheelEventHandler