ClassMapCallout
Represents a map callout graphical object that displays a speech bubble-like popup with text and image content at a specific geographic location.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.RadMap.dll
Syntax:
public class MapCallout : MapPathBasedVisualElement, IClusterable, IBorderElement, IBoxStyle, IBoxElement, IFillElement, ITextElement, IShapedElementInheritance: objectMapVisualElementMapPathBasedVisualElementMapCallout
Derived Classes:
Implements:
Inherited Members
Constructors
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
element
The MapVisualElement that this callout will adorn and position relative to.
MapCallout(PointG)
Initializes a new instance of the MapCallout class at the specified geographic location with default appearance settings.
Fields
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.
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
Image
Gets or sets the image displayed within the callout bubble, positioned to the left of the text content with automatic layout adjustment.
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
Overrides
MaxWidth
Gets or sets the maximum width in pixels for the callout bubble content, used for text wrapping and layout calculations.
Padding
Gets or sets the internal padding around the callout content, affecting the spacing between the border and text or image elements.
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
viewport
The IMapViewport used for calculating pixel coordinates and callout dimensions.
Returns
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
graphics
The Graphics context used for text measurement.
viewport
The IMapViewport providing context for measurement calculations.
Returns
A 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
graphics
The IGraphics context used for rendering the callout.
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
graphics
The IGraphics context used for rendering the text.
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.