RadRadialGauge
Represents a radial gauge control designed to display a value within a definite range using a circular visualization. The control provides customizable appearance, range settings, and angular positioning for gauge elements.
Definition
Namespace:Telerik.WinControls.UI.Gauges
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadRadialGauge : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProviderInheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadRadialGauge...
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadRadialGauge class with default settings. The foreground color is set to black by default.
public RadRadialGauge()Properties
Gets or sets the horizontal offset from the center of the gauge. This property controls the gauge's position in the horizontal direction relative to its center point.
public double CenterOffsetX { get; set; }Gets or sets the vertical offset from the center of the gauge. This property controls the gauge's position in the vertical direction relative to its center point.
public double CenterOffsetY { get; set; }Gets the default size of the radial gauge control.
protected override Size DefaultSize { get; }Overrides:
Gets or sets the foreground color of the control. This property affects the color of the gauge elements and text within the root element.
public override Color ForeColor { get; set; }Overrides:
Gets or sets the RadRadialGaugeElement that represents the main gauge element providing the core functionality and visual representation of the radial gauge.
[Browsable(false)]
public RadRadialGaugeElement GaugeElement { get; set; }Gets the collection of gauge items that have been added to the gauge. This collection contains all visual elements such as scales, needles, and indicators.
[RadEditItemsAction]
public virtual RadItemOwnerCollection Items { get; }Gets or sets the maximum value of the gauge's range. This defines the upper bound of values that can be displayed on the gauge.
public double RangeEnd { get; set; }Gets or sets the minimum value of the gauge's range. This defines the lower bound of values that can be displayed on the gauge.
public double RangeStart { get; set; }Gets or sets the starting angle of the gauge arc in degrees. This angle defines where the gauge's arc begins, measured clockwise from the top (12 o'clock position).
public double StartAngle { get; set; }Gets or sets the angular span of the gauge arc in degrees. This determines the total angle covered by the gauge, starting from StartAngle in a clockwise direction.
public double SweepAngle { get; set; }Gets or sets the current value displayed by the gauge. This value should be within the range defined by RangeStart and RangeEnd.
[Bindable(true)]
public float Value { get; set; }Gets or sets the serialization configuration used by Save/Load layout methods to persist gauge settings to/from XML. When set to null, the configuration provided by GetDefaultXmlSerializationInfo() will be used.
[Browsable(false)]
public ComponentXmlSerializationInfo XmlSerializationInfo { get; set; }Methods
Creates the child elements for the radial gauge control, specifically the main gauge element.
protected override void CreateChildItems(RadElement parent)The parent element to which the gauge element will be added.
Overrides:
Creates and returns a new instance of the gauge element for this control. This method can be overridden to provide custom gauge element implementations.
protected virtual RadRadialGaugeElement CreateGaugeElement()A new instance of RadRadialGaugeElement.
Gets the default XML serialization configuration for the RadRadialGauge control. This method defines which properties should be included or excluded during serialization.
public virtual ComponentXmlSerializationInfo GetDefaultXmlSerializationInfo()A ComponentXmlSerializationInfo object containing the default serialization metadata.
Loads gauge layout and properties from the specified XML file using a design-time instance factory. This overload is typically used during design-time operations. Displays an error message if the file is not found.
public virtual void LoadLayout(string fileName, DesignTimeInstanceFactory factory)The path to the XML file containing the layout data.
factoryDesignTimeInstanceFactoryThe design-time instance factory to use for creating objects during deserialization.
Loads gauge layout and properties from the specified XML file using the current XmlSerializationInfo. Displays an error message if the file is not found.
public virtual void LoadLayout(string fileName)The path to the XML file containing the layout data.
Loads gauge layout and properties from the specified XML reader using the current XmlSerializationInfo.
public virtual void LoadLayout(XmlReader xmlReader)The XML reader containing the layout data to load.
Resets all gauge properties to their default values. This includes start angle, sweep angle, value, and range settings.
protected virtual void ResetFields()Saves the gauge layout and properties to the specified stream in XML format using the current XmlSerializationInfo. The stream remains open after the operation completes.
public virtual void SaveLayout(Stream stream)The stream to write the XML layout data to.
Saves the gauge layout and properties to the specified file in XML format using the current XmlSerializationInfo.
public virtual void SaveLayout(string fileName)The path to the file where the layout should be saved.
Saves the gauge layout and properties to the specified XML writer using the current XmlSerializationInfo.
public virtual void SaveLayout(XmlWriter xmlWriter)The XML writer to use for serialization.
Events
Occurs when the gauge's Value property is modified. This event is fired whenever the displayed value changes.
public event EventHandler ValueChanged