New to Telerik UI for WPF? Start a free 30-day trial

RadCallout

Class

Represents a customizable callout control that provides various shapes and styles for displaying content in a user-friendly manner. The RadCallout class allows users to configure properties such as callout type, arrow type, geometry, text alignment, wrapping, trimming, and corner radius, enabling the creation of visually distinct callouts for user interfaces. It inherits from ContentControl and supports properties for defining geometry and visual appearance, allowing for flexible layouts and detailed customization. Ideal for enhancing user experience with informative overlays that can be styled to match application design.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.dll

Syntax:

[TelerikToolboxCategory("Common")]
public class RadCallout : ContentControl

Inheritance: objectRadCallout

Constructors

RadCallout()

Initializes a new instance of the RadCallout class.

public RadCallout()

Fields

ArrowAnchorPointProperty

DependencyProperty

Identifies the ArrowAnchorPoint property.

public static readonly DependencyProperty ArrowAnchorPointProperty

ArrowBasePoint1Property

DependencyProperty

Identifies the ArrowBasePoint1 property.

public static readonly DependencyProperty ArrowBasePoint1Property

ArrowBasePoint2Property

DependencyProperty

Identifies the ArrowBasePoint2 property.

public static readonly DependencyProperty ArrowBasePoint2Property

ArrowTypeProperty

DependencyProperty

Identifies the ArrowType property.

public static readonly DependencyProperty ArrowTypeProperty

CalloutTypeProperty

DependencyProperty

Identifies the CalloutType property.

public static readonly DependencyProperty CalloutTypeProperty

CornerRadiusProperty

DependencyProperty

Identifies the CornerRadius property.

public static readonly DependencyProperty CornerRadiusProperty

GeometryProperty

DependencyProperty

Identifies the Geometry property.

public static readonly DependencyProperty GeometryProperty

GeometryResultProperty

DependencyProperty

Identifies the Geometry property.

public static readonly DependencyProperty GeometryResultProperty

MeasurePathWithInfinityProperty

DependencyProperty

Identifies the MeasurePathWithInfinity property.

public static readonly DependencyProperty MeasurePathWithInfinityProperty

StretchProperty

DependencyProperty

Identifies the Stretch property.

public static readonly DependencyProperty StretchProperty

StrokeDashArrayProperty

DependencyProperty

Identifies the StrokeDashArray property.

public static readonly DependencyProperty StrokeDashArrayProperty

StrokeThicknessProperty

DependencyProperty

Identifies the StrokeThickness property.

public static readonly DependencyProperty StrokeThicknessProperty

TextAlignmentProperty

DependencyProperty

Identifies the TextAlignment property.

public static readonly DependencyProperty TextAlignmentProperty

TextTrimmingProperty

DependencyProperty

Identifies the TextTrimming property.

public static readonly DependencyProperty TextTrimmingProperty

TextWrappingProperty

DependencyProperty

Identifies the TextWrapping property.

public static readonly DependencyProperty TextWrappingProperty

Properties

ArrowAnchorPoint

Point

Gets or sets the anchor point of the arrow geometry.

public Point ArrowAnchorPoint { get; set; }

ArrowBasePoint1

Point

Gets or sets the first base point of the arrow geometry.

public Point ArrowBasePoint1 { get; set; }

ArrowBasePoint2

Point

Gets or sets the second base point of the arrow geometry.

public Point ArrowBasePoint2 { get; set; }

ArrowType

CalloutArrowType

Gets or sets the arrow type of the callout control.

public CalloutArrowType ArrowType { get; set; }

CalloutType

Gets or sets the callout type of the callout control.

public CalloutType CalloutType { get; set; }

CornerRadius

double

Gets or sets the corner radius used for the RoundedRectangle geometry.

public double CornerRadius { get; set; }

Geometry

Gets or sets the desired (body) geometry of the callout control.

public Geometry Geometry { get; set; }

GeometryResult

Geometry

Gets the combined (body and arrow) geometry of the callout control.

public Geometry GeometryResult { get; }

MeasurePathWithInfinity

bool

Gets or sets a value indicating whether the path in the control template is measured with infinity or not.

public bool MeasurePathWithInfinity { get; set; }

Stretch

Gets or sets the stretch of the path from the control template.

public Stretch Stretch { get; set; }

StrokeDashArray

DoubleCollection

Gets or sets the stroke dash array of the underlying path.

public DoubleCollection StrokeDashArray { get; set; }

StrokeThickness

double

Gets or sets the stroke thickness of the underlying path.

public double StrokeThickness { get; set; }

TextAlignment

Gets or sets the text alignment of the underlying TextBlock.

public TextAlignment TextAlignment { get; set; }

TextTrimming

Gets or sets the text trimming mode of the underlying TextBlock.

public TextTrimming TextTrimming { get; set; }

TextWrapping

Gets or sets the text wrapping mode of the underlying TextBlock.

public TextWrapping TextWrapping { get; set; }

Methods

GetArrowGeometry()

Geometry

Builds the arrow geometry which will be combined with the main geometry for the body of the callout.

protected virtual Geometry GetArrowGeometry()

Returns:

Geometry

The built arrow geometry.

GetBaseGeometry()

Geometry

Builds the base (body) geometry which will be combined with the main geometry for the body of the callout.

protected virtual Geometry GetBaseGeometry()

Returns:

Geometry

The built base geometry for the callout.

MeasureOverride(Size)

Size

Provides the behavior for the "Measure" pass of layout.

protected override Size MeasureOverride(Size constraint)

Parameters:constraintSize

The available size that this element can give to child elements.

Returns:

Size

The size that this element determines it needs during layout, based on its calculations of child element sizes.

OnApplyTemplate()

When overridden in a derived class, is invoked whenever application code or internal processes (such as a rebuilding layout pass) call .

public override void OnApplyTemplate()

OnCreateAutomationPeer()

AutomationPeer

Creates a RadCalloutAutomationPeer.

protected override AutomationPeer OnCreateAutomationPeer()

Returns:

AutomationPeer

OnInitialized(EventArgs)

Raises the event. This method is invoked whenever is set to true internally.

protected override void OnInitialized(EventArgs e)

Parameters:eEventArgs

The RoutedEventArgs that contains the event data.