MapCallout
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
Initializes a new instance of the MapCallout class that adorns the specified map visual element with automatic entity reference resolution.
public MapCallout(MapVisualElement element)The MapVisualElement that this callout will adorn and position relative to.
Initializes a new instance of the MapCallout class at the specified geographic location with default appearance settings.
Fields
Properties
Gets or sets the distance in pixels between the callout bubble and the target element or location, automatically resetting the graphics path cache.
public int Distance { get; set; }Gets the map visual element that this callout adorns, providing context for positioning and entity reference resolution.
public MapVisualElement Element { get; }Gets or sets the image displayed within the callout bubble, positioned to the left of the text content with automatic layout adjustment.
public virtual Image Image { get; set; }Gets a value indicating whether this callout uses outline rendering mode, always returning false for filled callout display.
protected override bool IsOutline { get; }Overrides:
Gets or sets the maximum width in pixels for the callout bubble content, used for text wrapping and layout calculations.
public int MaxWidth { get; set; }Gets or sets the internal padding around the callout content, affecting the spacing between the border and text or image elements.
public Padding Padding { get; set; }Methods
Creates the visual element information including the speech bubble graphics path with pointer and positioning offset for the callout display.
protected override MapVisualElementInfo CreateVisualElementInfo(IMapViewport 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:
Measures the text content size for layout calculations, considering the maximum width constraint and font settings.
protected virtual SizeF MeasureText(Graphics graphics, IMapViewport viewport)The Graphics context used for text measurement.
viewportIMapViewportThe IMapViewport providing context for measurement calculations.
Returns:A SizeF representing the measured text dimensions within the maximum width constraint.
Paints the complete callout including the speech bubble shape, fill, border, image, and text content with wraparound support for world maps.
public override void Paint(IGraphics graphics, IMapViewport viewport)The IGraphics context used for rendering the callout.
viewportIMapViewportThe IMapViewport providing zoom level, pan offset, and wraparound information.
Overrides:
Paints the text content within the callout bubble with proper positioning relative to any image content and wraparound support.
protected virtual void PaintText(IGraphics graphics, IMapViewport viewport)The IGraphics context used for rendering the text.
viewportIMapViewportThe IMapViewport providing positioning and wraparound information for text rendering.
Resolves entity references in the callout text by replacing placeholders like [$property] with actual values from the MapPoint's extended data.