Class MapCallout

Represents a map callout graphical object that displays a speech bubble-like popup with text and image content at a specific geographic location.

Inheritance
System.Object
MapVisualElement
MapPathBasedVisualElement
MapCallout
MapHtmlCallout
Inherited Members
System.Object.ToString()
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 MapCallout : MapPathBasedVisualElement, IClusterable, IBorderElement, IBoxStyle, IBoxElement, IFillElement, ITextElement, IShapedElement

Constructors

MapCallout(PointG)

Initializes a new instance of the MapCallout class at the specified geographic location with default appearance settings.

Declaration
public MapCallout(PointG location)
Parameters
PointG location

The PointG geographic location where the callout will be positioned on the map.

MapCallout(MapVisualElement)

Initializes a new instance of the MapCallout class that adorns the specified map visual element with automatic entity reference resolution.

Declaration
public MapCallout(MapVisualElement element)
Parameters
MapVisualElement element

The MapVisualElement that this callout will adorn and position relative to.

Fields

drawText

Declaration
protected string drawText
Field Value
System.String

Properties

Distance

Gets or sets the distance in pixels between the callout bubble and the target element or location, automatically resetting the graphics path cache.

Declaration
public int Distance { get; set; }
Property Value
System.Int32

Element

Gets the map visual element that this callout adorns, providing context for positioning and entity reference resolution.

Declaration
public MapVisualElement Element { get; }
Property Value
MapVisualElement

Image

Gets or sets the image displayed within the callout bubble, positioned to the left of the text content with automatic layout adjustment.

Declaration
public virtual Image Image { get; set; }
Property Value
System.Drawing.Image

IsOutline

Gets a value indicating whether this callout uses outline rendering mode, always returning false for filled callout display.

Declaration
protected override bool IsOutline { get; }
Property Value
System.Boolean

Overrides

MaxWidth

Gets or sets the maximum width in pixels for the callout bubble content, used for text wrapping and layout calculations.

Declaration
public int MaxWidth { get; set; }
Property Value
System.Int32

Padding

Gets or sets the internal padding around the callout content, affecting the spacing between the border and text or image elements.

Declaration
public Padding Padding { get; set; }
Property Value
System.Windows.Forms.Padding

Text

Gets or sets the text content displayed in the callout, with automatic entity reference resolution for MapPoint extended data properties.

Declaration
public override string Text { get; set; }
Property Value
System.String

Overrides

Methods

CreateVisualElementInfo(IMapViewport)

Creates the visual element information including the speech bubble graphics path with pointer and positioning offset for the callout display.

Declaration
protected override MapVisualElementInfo CreateVisualElementInfo(IMapViewport viewport)
Parameters
IMapViewport viewport

The IMapViewport used for calculating pixel coordinates and callout dimensions.
Returns
MapVisualElementInfo

A MapVisualElementInfo containing the speech bubble path and offset information for the callout.
Overrides

MeasureText(Graphics, IMapViewport)

Measures the text content size for layout calculations, considering the maximum width constraint and font settings.

Declaration
protected virtual SizeF MeasureText(Graphics graphics, IMapViewport viewport)
Parameters
System.Drawing.Graphics graphics

The System.Drawing.Graphics context used for text measurement.
IMapViewport viewport

The IMapViewport providing context for measurement calculations.
Returns
System.Drawing.SizeF

A System.Drawing.SizeF representing the measured text dimensions within the maximum width constraint.

Paint(IGraphics, IMapViewport)

Paints the complete callout including the speech bubble shape, fill, border, image, and text content with wraparound support for world maps.

Declaration
public override void Paint(IGraphics graphics, IMapViewport viewport)
Parameters
IGraphics graphics

The IGraphics context used for rendering the callout.
IMapViewport viewport

The IMapViewport providing zoom level, pan offset, and wraparound information.
Overrides

PaintText(IGraphics, IMapViewport)

Paints the text content within the callout bubble with proper positioning relative to any image content and wraparound support.

Declaration
protected virtual void PaintText(IGraphics graphics, IMapViewport viewport)
Parameters
IGraphics graphics

The IGraphics context used for rendering the text.
IMapViewport viewport

The IMapViewport providing positioning and wraparound information for text rendering.

ResolveEntityReferences(MapPoint)

Resolves entity references in the callout text by replacing placeholders like [$property] with actual values from the MapPoint's extended data.

Declaration
protected virtual void ResolveEntityReferences(MapPoint point)
Parameters
MapPoint point

The MapPoint containing extended data for entity reference resolution, or null if no data is available.

Extension Methods