Class

RadRadialGaugeElement

Initializes a new instance of the RadRadialGaugeElement class with default settings including padding, item collection configuration, and supported gauge item types.

Declaration

public RadRadialGaugeElement()

Identifies the Value dependency property used for storing the current gauge value.

Declaration

public static RadProperty ValueProperty

Field Value

Gets or sets the thickness of the gauge axis in pixels, which affects the spacing and visual appearance of gauge elements and their positioning relative to the gauge center.

Declaration

protected double AxisThickness { get; set; }

Property Value

Gets or sets the horizontal offset of the gauge center as a proportional value, allowing fine adjustment of the gauge positioning within its container for optimal visual balance.

Declaration

public double CenterOffsetX { get; set; }

Property Value

Gets or sets the vertical offset of the gauge center as a proportional value, allowing fine adjustment of the gauge positioning within its container for optimal visual balance.

Declaration

public double CenterOffsetY { get; set; }

Property Value

Gets the calculated end angle of the gauge arc by adding the SweepAngle to the StartAngle, representing the final position of the gauge arc in degrees.

Declaration

public double EndAngle { get; }

Property Value

Gets the center point of the gauge as a PointF, calculated from the GaugeSize and adjusted by the CenterOffsetX and CenterOffsetY properties for precise positioning.

Declaration

public PointF GaugeCenter { get; }

Property Value

Gets the bounding rectangle that defines the drawable area of the gauge, calculated based on the element size, padding, label positioning, and axis thickness to ensure proper gauge rendering.

Declaration

public RectangleF GaugeSize { get; }

Property Value

Gets the collection of gauge items including arcs, needles, labels, ticks, single labels, and backgrounds that comprise the complete gauge visualization. The collection supports design-time editing and serialization.

Declaration

[RadEditItemsAction]
public virtual RadItemOwnerCollection Items { get; }

Property Value

Gets or sets the offset distance of labels from the gauge circumference, affecting the positioning of label elements around the gauge perimeter.

Declaration

protected double LabelOffset { get; set; }

Property Value

Gets or sets a value indicating whether labels are positioned inside the gauge arc or outside the gauge circumference, affecting the overall layout and readability of the gauge.

Declaration

protected bool LabelsPositionInside { get; set; }

Property Value

Gets or sets the maximum value of the gauge range, which defines the upper boundary for valid gauge values. This value must be greater than RangeStart to maintain a valid range.

Declaration

public double RangeEnd { get; set; }

Property Value

Gets or sets the minimum value of the gauge range, which defines the lower boundary for valid gauge values. This value must be less than RangeEnd to maintain a valid range.

Declaration

public double RangeStart { get; set; }

Property Value

Gets or sets the starting angle of the gauge arc in degrees, measured clockwise from the positive X-axis. This angle defines where the gauge range begins and is used in conjunction with SweepAngle to determine the total arc.

Declaration

public double StartAngle { get; set; }

Property Value

Gets or sets the angular extent of the gauge arc in degrees, measured clockwise from the StartAngle. This property determines the total arc length available for displaying the gauge range.

Declaration

public double SweepAngle { get; set; }

Property Value

Gets or sets the current value displayed on the gauge, which must be within the range defined by RangeStart and RangeEnd properties. Changes to this property trigger the ValueChanged event.

Declaration

[Bindable(true)]
public float Value { get; set; }

Property Value

Calculates the needle angle in degrees based on the specified value within the given range, mapping the value proportionally to the angular range defined by the start and sweep angles.

Declaration

public double CalculateNeedleAngle(double value, double rangeStart, double rangeEnd, double startAngle, double sweepAngle)

Parameters

Returns

Notifies subscribers about property changes and invalidates the element to trigger a repaint. This method is called internally when gauge properties are modified.

Declaration

protected override void OnNotifyPropertyChanged(string propertyName)

Parameters

Overrides RadObject.OnNotifyPropertyChanged(string)

Called after a property value has changed to handle post-change processing. For the ValueProperty, ensures the value remains within range and triggers appropriate notifications.

Declaration

protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)

Parameters

Overrides LightVisualElement.OnPropertyChanged(RadPropertyChangedEventArgs)

Called before a property value changes to validate the new value and potentially cancel the change. For the ValueProperty, ensures the new value falls within the valid range.

Declaration

protected override void OnPropertyChanging(RadPropertyChangingEventArgs args)

Parameters

Overrides RadItem.OnPropertyChanging(RadPropertyChangingEventArgs)

Raises the ValueChanged event and tracks analytics when the gauge value changes, providing notification to subscribers about value modifications.

Declaration

protected void OnValueChanged()

Occurs when the Value property changes, allowing subscribers to respond to gauge value modifications.

Declaration

public event EventHandler ValueChanged

Event Value