ClassBaseMapElement
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.RadMap.dll
Syntax:
public class BaseMapElement : LightVisualElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider, IMapViewport
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementBaseMapElement
Derived Classes:
Implements:
Inherited Members
Constructors
BaseMapElement()
Initializes a new instance of the BaseMapElement class.
Declaration
public BaseMapElement()
Fields
Properties
Center
Gets or sets the center of the viewport in geo coordinates.
Declaration
public PointG Center { get; set; }
Property Value
The center.
Implements
CenterPixel
Gets or sets the coordinates of the center of the viewport in pixels.
Declaration
public PointL CenterPixel { get; set; }
Property Value
The center pixel.
Implements
EnablePanning
Gets or sets a value indicating whether panning is allowed.
EnableZooming
Gets or sets a value indicating whether zooming is allowed.
InputBehavior
Gets or sets the input behavior that will handle the user input.
Declaration
public MapInputBehavior InputBehavior { get; set; }
Property Value
The input behavior.
IsAnimationActive
Gets a value indicating whether an animation is active.
Declaration
public bool IsAnimationActive { get; }
Property Value
true if an animation is active; otherwise, false.
IsUpdateSuspended
Gets a value indicating whether updates are suspended.
Declaration
public bool IsUpdateSuspended { get; }
Property Value
true if updates are suspended; otherwise, false.
Layers
Gets the layers collection of the map element.
Declaration
public MapLayerCollection Layers { get; }
Property Value
The layers.
NumberOfWraparounds
Gets the number of wraparounds visible in the viewport.
Declaration
public int NumberOfWraparounds { get; }
Property Value
The number of wraparounds.
Implements
PanOffset
Gets or sets the current pan offset of the viewport in pixels.
Declaration
public SizeL PanOffset { get; set; }
Property Value
The pan offset.
Implements
Providers
Gets the providers collection of the map element.
Declaration
public MapProviderCollection Providers { get; }
Property Value
The providers.
SelectedElements
Gets a collection of the selected elements.
Declaration
public List<MapVisualElement> SelectedElements { get; }
Property Value
List<MapVisualElement>
The selected elements.
TileOffset
Gets or sets the tile offset. This property is used for animations of the viewport.
Declaration
public SizeF TileOffset { get; set; }
Property Value
The tile offset.
TileScale
Gets or sets the tile scale. This property is used for animations of the viewport.
Declaration
public SizeF TileScale { get; set; }
Property Value
The tile scale.
Viewport
Gets or sets the currently visible viewport in geo coordinates.
Declaration
public RectangleG Viewport { get; set; }
Property Value
The viewport.
Implements
ViewportInPixels
Gets or sets the viewport in pixels.
Declaration
public RectangleL ViewportInPixels { get; set; }
Property Value
The viewport in pixels.
Implements
Wraparound
Gets or sets a value indicating whether wraparound is enabled.
Declaration
public bool Wraparound { get; set; }
Property Value
true if wraparound is enabled; otherwise, false.
Implements
Methods
ArrangeOverride(SizeF)
Arranges the content and child elements within the final allocated space, positioning text, images, and child elements.
BringIntoView(PointG)
Brings the specified geo point into the center of the viewport.
Declaration
public virtual void BringIntoView(PointG location)
Parameters
location
The location.
BringIntoView(PointG, int)
Brings the specified geo point into the center of the viewport and zooms the viewport to the specified zoom level.
BringIntoView(RectangleG)
Calculates the best zoom level that will fit the specified rectangle and centers it in the viewport.
Declaration
public virtual void BringIntoView(RectangleG rectangle)
Parameters
rectangle
The rectangle.
CalculateViewport(SizeF)
Declaration
protected virtual void CalculateViewport(SizeF finalSize)
Parameters
finalSize
ConfigureTileProviderGraphics(Graphics, IMapTileProvider)
Configures the graphics settings for optimal tile rendering based on the tile provider's requirements.
Declaration
protected virtual void ConfigureTileProviderGraphics(Graphics graphics, IMapTileProvider tileProvider)
Parameters
graphics
The GDI+ graphics object to configure.
tileProvider
The tile provider that determines the transparency rendering mode.
EndUpdate()
Resumes updates and performs an update.
Declaration
public void EndUpdate()
EndUpdate(bool)
Resumes updates and performs an update if specified by the update parameter.
Declaration
public void EndUpdate(bool update)
Parameters
update
if set to true an update is performed.
InitializeFields()
Initializes the internal fields and components of the LightVisualElement. This method sets up text primitives, image primitives, and layout management components.
Declaration
protected override void InitializeFields()
Overrides
OnDoubleClick(EventArgs)
Raises the DoubleClick event.
Declaration
protected override void OnDoubleClick(EventArgs e)
Parameters
e
Overrides
OnGesture(GestureEventArgs)
Calls the appropriate gesture event according to the GestureType property of the event arguments.
Declaration
protected override void OnGesture(GestureEventArgs args)
Parameters
args
The event arguments.
Overrides
OnKeyDown(KeyEventArgs)
Raises the KeyDown event.
Declaration
protected override void OnKeyDown(KeyEventArgs e)
Parameters
e
The key event arguments.
Overrides
OnKeyPress(KeyPressEventArgs)
Raises the KeyPress event.
Declaration
protected override void OnKeyPress(KeyPressEventArgs e)
Parameters
e
The key press event arguments.
Overrides
OnKeyUp(KeyEventArgs)
Raises the KeyUp event.
Declaration
protected override void OnKeyUp(KeyEventArgs e)
Parameters
e
The key event arguments.
Overrides
OnMouseDown(MouseEventArgs)
Called when a mouse button is pressed down over the item.
Declaration
protected override void OnMouseDown(MouseEventArgs e)
Parameters
e
The mouse event arguments.
Overrides
OnMouseEnter(EventArgs)
Declaration
protected override void OnMouseEnter(EventArgs e)
Parameters
e
Overrides
OnMouseHover(EventArgs)
Declaration
protected override void OnMouseHover(EventArgs e)
Parameters
e
Overrides
OnMouseLeave(EventArgs)
Declaration
protected override void OnMouseLeave(EventArgs e)
Parameters
e
Overrides
OnMouseMove(MouseEventArgs)
Called when the mouse moves over the item, handling highlight and border highlight effects.
Declaration
protected override void OnMouseMove(MouseEventArgs e)
Parameters
e
The mouse event arguments.
Overrides
OnMouseUp(MouseEventArgs)
Called when a mouse button is released over the item.
Declaration
protected override void OnMouseUp(MouseEventArgs e)
Parameters
e
The mouse event arguments.
Overrides
OnMouseWheel(MouseEventArgs)
Raises the MouseWheel event.
Declaration
protected override void OnMouseWheel(MouseEventArgs e)
Parameters
e
The mouse event arguments.
Overrides
OnPanGesture(PanGestureEventArgs)
Fires the PanGesture event.
Declaration
protected override void OnPanGesture(PanGestureEventArgs args)
Parameters
args
The arguments for the PanGesture event.
Overrides
OnPressAndTapGesture(PressAndTapGestureEventArgs)
Fires the PressAndTapGesture event.
Declaration
protected override void OnPressAndTapGesture(PressAndTapGestureEventArgs args)
Parameters
args
The arguments for the PressAndTapGesture event.
Overrides
OnPropertyChanged(RadPropertyChangedEventArgs)
Handles property change events by invalidating the fill cache and invoking the base class property change handler.
Declaration
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters
e
Event arguments containing information about the property that changed.
Overrides
OnProviderInitializationComplete(IMapProvider)
Called when a map provider is initialized.
Declaration
public virtual void OnProviderInitializationComplete(IMapProvider mapProvider)
Parameters
mapProvider
The map provider.
OnProviderUpdated(IMapProvider)
Called when a provider updated occurs.
Declaration
public virtual void OnProviderUpdated(IMapProvider mapProvider)
Parameters
mapProvider
The map provider that was updated.
OnRotateGesture(RotateGestureEventArgs)
Fires the RotateGesture event.
Declaration
protected override void OnRotateGesture(RotateGestureEventArgs args)
Parameters
args
The arguments for the RotateGesture event.
Overrides
OnScaleAnimationFinished(object, AnimationStatusEventArgs)
Called when a zoom animation finishes.
Declaration
protected virtual void OnScaleAnimationFinished(object sender, AnimationStatusEventArgs e)
Parameters
sender
The sender.
e
The AnimationStatusEventArgs instance containing the event data.
OnSelectionChanged(MapSelectionChangedEventArgs)
Fires the event.
Declaration
protected virtual void OnSelectionChanged(MapSelectionChangedEventArgs e)
Parameters
e
The MapSelectionChangedEventArgs instance containing the event data.
OnTwoFingerTapGesture(GestureEventArgs)
Fires the TwoFingerTapGesture event.
Declaration
protected override void OnTwoFingerTapGesture(GestureEventArgs args)
Parameters
args
The arguments for the TwoFingerTapGesture event.
Overrides
OnViewportChanged(ViewportChangeAction)
Called after the viewport changes.
Declaration
protected virtual void OnViewportChanged(ViewportChangeAction action)
Parameters
action
The change action.
OnViewportChanged(ViewportChangedEventArgs)
Fires the event.
Declaration
protected virtual void OnViewportChanged(ViewportChangedEventArgs e)
Parameters
e
The ViewportChangedEventArgs instance containing the event data.
OnZoomGesture(ZoomGestureEventArgs)
Fires the ZoomGesture event.
Declaration
protected override void OnZoomGesture(ZoomGestureEventArgs args)
Parameters
args
The arguments for the ZoomGesture event.
Overrides
PaintElement(IGraphics)
Paints the element, the providers content and the layers.
Declaration
protected virtual void PaintElement(IGraphics graphics)
Parameters
graphics
The graphics.
PaintElement(IGraphics, float, SizeF)
Performs the main painting operation for the element, rendering fill, content, and border in the correct order.
Declaration
protected override void PaintElement(IGraphics graphics, float angle, SizeF scale)
Parameters
graphics
The graphics context used for rendering.
angle
The rotation angle to apply during painting.
scale
The scaling factor to apply during painting.
Overrides
PaintLayers(IGraphics)
Paints the content of the layers.
Declaration
protected virtual void PaintLayers(IGraphics graphics)
Parameters
graphics
The graphics.
PaintProvidersContent(IGraphics)
Paints the content of the providers.
Declaration
protected virtual void PaintProvidersContent(IGraphics graphics)
Parameters
graphics
The graphics.
PaintZoomImage(IGraphics)
Paints the zoom image whild a zoom animation is ongoing.
Declaration
protected virtual void PaintZoomImage(IGraphics graphics)
Parameters
graphics
The graphics.
Pan(SizeL)
Pans the viewport with the specified delta.
Declaration
public virtual void Pan(SizeL delta)
Parameters
delta
The delta.
Pan(long, long)
Pans the viewport to the specified x and y coordinates.
UpdatePanOffset()
Declaration
protected virtual void UpdatePanOffset()
UpdateViewport()
Declaration
protected virtual void UpdateViewport()
Zoom(int)
Zooms the viewport to the specified zoom level.
Declaration
public virtual void Zoom(int zoomLevel)
Parameters
zoomLevel
The zoom level.
Zoom(int, bool)
Zooms the viewport to the specified zoom level.
Zoom(int, bool, Point)
Zooms the viewport to the specified zoom level.
Events
SelectionChanged
Occurs when the selection changed.
Declaration
public event EventHandler<MapSelectionChangedEventArgs> SelectionChanged
Event Value
ViewportChanged
Occurs when the viewport changed.
Declaration
public event EventHandler<ViewportChangedEventArgs> ViewportChanged
Event Value