Class
RadCallout

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:

cs-api-definition
[TelerikToolboxCategory("Common")]
public class RadCallout : ContentControl

Inheritance: objectRadCallout

Constructors

RadCallout()

Initializes a new instance of the RadCallout class.

Declaration

cs-api-definition
public RadCallout()

Fields

ArrowAnchorPointProperty

Identifies the ArrowAnchorPoint property.

Declaration

cs-api-definition
public static readonly DependencyProperty ArrowAnchorPointProperty

Field Value

DependencyProperty

ArrowBasePoint1Property

Identifies the ArrowBasePoint1 property.

Declaration

cs-api-definition
public static readonly DependencyProperty ArrowBasePoint1Property

Field Value

DependencyProperty

ArrowBasePoint2Property

Identifies the ArrowBasePoint2 property.

Declaration

cs-api-definition
public static readonly DependencyProperty ArrowBasePoint2Property

Field Value

DependencyProperty

ArrowTypeProperty

Identifies the ArrowType property.

Declaration

cs-api-definition
public static readonly DependencyProperty ArrowTypeProperty

Field Value

DependencyProperty

CalloutTypeProperty

Identifies the CalloutType property.

Declaration

cs-api-definition
public static readonly DependencyProperty CalloutTypeProperty

Field Value

DependencyProperty

CornerRadiusProperty

Identifies the CornerRadius property.

Declaration

cs-api-definition
public static readonly DependencyProperty CornerRadiusProperty

Field Value

DependencyProperty

GeometryProperty

Identifies the Geometry property.

Declaration

cs-api-definition
public static readonly DependencyProperty GeometryProperty

Field Value

DependencyProperty

GeometryResultProperty

Identifies the Geometry property.

Declaration

cs-api-definition
public static readonly DependencyProperty GeometryResultProperty

Field Value

DependencyProperty

MeasurePathWithInfinityProperty

Identifies the MeasurePathWithInfinity property.

Declaration

cs-api-definition
public static readonly DependencyProperty MeasurePathWithInfinityProperty

Field Value

DependencyProperty

StretchProperty

Identifies the Stretch property.

Declaration

cs-api-definition
public static readonly DependencyProperty StretchProperty

Field Value

DependencyProperty

StrokeDashArrayProperty

Identifies the StrokeDashArray property.

Declaration

cs-api-definition
public static readonly DependencyProperty StrokeDashArrayProperty

Field Value

DependencyProperty

StrokeThicknessProperty

Identifies the StrokeThickness property.

Declaration

cs-api-definition
public static readonly DependencyProperty StrokeThicknessProperty

Field Value

DependencyProperty

TextAlignmentProperty

Identifies the TextAlignment property.

Declaration

cs-api-definition
public static readonly DependencyProperty TextAlignmentProperty

Field Value

DependencyProperty

TextTrimmingProperty

Identifies the TextTrimming property.

Declaration

cs-api-definition
public static readonly DependencyProperty TextTrimmingProperty

Field Value

DependencyProperty

TextWrappingProperty

Identifies the TextWrapping property.

Declaration

cs-api-definition
public static readonly DependencyProperty TextWrappingProperty

Field Value

DependencyProperty

Properties

ArrowAnchorPoint

Gets or sets the anchor point of the arrow geometry.

Declaration

cs-api-definition
public Point ArrowAnchorPoint { get; set; }

Property Value

Point

ArrowBasePoint1

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

Declaration

cs-api-definition
public Point ArrowBasePoint1 { get; set; }

Property Value

Point

ArrowBasePoint2

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

Declaration

cs-api-definition
public Point ArrowBasePoint2 { get; set; }

Property Value

Point

ArrowType

Gets or sets the arrow type of the callout control.

Declaration

cs-api-definition
public CalloutArrowType ArrowType { get; set; }

Property Value

CalloutArrowType

CalloutType

Gets or sets the callout type of the callout control.

Declaration

cs-api-definition
public CalloutType CalloutType { get; set; }

Property Value

CalloutType

CornerRadius

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

Declaration

cs-api-definition
public double CornerRadius { get; set; }

Property Value

double

Geometry

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

Declaration

cs-api-definition
public Geometry Geometry { get; set; }

Property Value

Geometry

GeometryResult

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

Declaration

cs-api-definition
public Geometry GeometryResult { get; }

Property Value

Geometry

MeasurePathWithInfinity

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

Declaration

cs-api-definition
public bool MeasurePathWithInfinity { get; set; }

Property Value

bool

Stretch

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

Declaration

cs-api-definition
public Stretch Stretch { get; set; }

Property Value

Stretch

StrokeDashArray

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

Declaration

cs-api-definition
[SuppressMessage("Microsoft.Usage", "CA2227:CollectionPropertiesShouldBeReadOnly")]
public DoubleCollection StrokeDashArray { get; set; }

Property Value

DoubleCollection

StrokeThickness

Gets or sets the stroke thickness of the underlying path.

Declaration

cs-api-definition
public double StrokeThickness { get; set; }

Property Value

double

TextAlignment

Gets or sets the text alignment of the underlying TextBlock.

Declaration

cs-api-definition
public TextAlignment TextAlignment { get; set; }

Property Value

TextAlignment

TextTrimming

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

Declaration

cs-api-definition
public TextTrimming TextTrimming { get; set; }

Property Value

TextTrimming

TextWrapping

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

Declaration

cs-api-definition
public TextWrapping TextWrapping { get; set; }

Property Value

TextWrapping

Methods

GetArrowGeometry()

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

Declaration

cs-api-definition
protected virtual Geometry GetArrowGeometry()

Returns

Geometry

The built arrow geometry.

GetBaseGeometry()

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

Declaration

cs-api-definition
protected virtual Geometry GetBaseGeometry()

Returns

Geometry

The built base geometry for the callout.

MeasureOverride(Size)

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

Declaration

cs-api-definition
protected override Size MeasureOverride(Size constraint)

Parameters

constraint

Size

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 .

Declaration

cs-api-definition
public override void OnApplyTemplate()

OnCreateAutomationPeer()

Creates a RadCalloutAutomationPeer.

Declaration

cs-api-definition
protected override AutomationPeer OnCreateAutomationPeer()

Returns

AutomationPeer

OnInitialized(EventArgs)

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

Declaration

cs-api-definition
protected override void OnInitialized(EventArgs e)

Parameters

e

EventArgs

The RoutedEventArgs that contains the event data.