Class

RadRadialGauge

Initializes a new instance of the RadRadialGauge class with default settings. The foreground color is set to black by default.

Declaration

public RadRadialGauge()

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.

Declaration

public double CenterOffsetX { get; set; }

Property Value

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.

Declaration

public double CenterOffsetY { get; set; }

Property Value

Gets the default size of the radial gauge control.

Declaration

protected override Size DefaultSize { get; }

Property Value

Overrides Control.DefaultSize

Gets or sets the foreground color of the control. This property affects the color of the gauge elements and text within the root element.

Declaration

public override Color ForeColor { get; set; }

Property Value

Overrides RadControl.ForeColor

Gets or sets the RadRadialGaugeElement that represents the main gauge element providing the core functionality and visual representation of the radial gauge.

Declaration

[Browsable(false)]
public RadRadialGaugeElement GaugeElement { get; set; }

Property Value

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.

Declaration

[RadEditItemsAction]
public virtual RadItemOwnerCollection Items { get; }

Property Value

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.

Declaration

public double RangeEnd { get; set; }

Property Value

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.

Declaration

public double RangeStart { get; set; }

Property Value

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).

Declaration

public double StartAngle { get; set; }

Property Value

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.

Declaration

public double SweepAngle { get; set; }

Property Value

Gets or sets the current value displayed by the gauge. This value should be within the range defined by RangeStart and RangeEnd.

Declaration

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

Property Value

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.

Declaration

[Browsable(false)]
public ComponentXmlSerializationInfo XmlSerializationInfo { get; set; }

Property Value

Creates the child elements for the radial gauge control, specifically the main gauge element.

Declaration

protected override void CreateChildItems(RadElement parent)

Parameters

Overrides RadControl.CreateChildItems(RadElement)

Creates and returns a new instance of the gauge element for this control. This method can be overridden to provide custom gauge element implementations.

Declaration

protected virtual RadRadialGaugeElement CreateGaugeElement()

Returns

Gets the default XML serialization configuration for the RadRadialGauge control. This method defines which properties should be included or excluded during serialization.

Declaration

public virtual ComponentXmlSerializationInfo GetDefaultXmlSerializationInfo()

Returns

Loads gauge layout and properties from the specified XML reader using the current XmlSerializationInfo.

Declaration

public virtual void LoadLayout(XmlReader xmlReader)

Parameters

Loads gauge layout and properties from the specified XML file using the current XmlSerializationInfo. Displays an error message if the file is not found.

Declaration

public virtual void LoadLayout(string fileName)

Parameters

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.

Declaration

public virtual void LoadLayout(string fileName, DesignTimeInstanceFactory factory)

Parameters

Resets all gauge properties to their default values. This includes start angle, sweep angle, value, and range settings.

Declaration

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.

Declaration

public virtual void SaveLayout(Stream stream)

Parameters

Saves the gauge layout and properties to the specified XML writer using the current XmlSerializationInfo.

Declaration

public virtual void SaveLayout(XmlWriter xmlWriter)

Parameters

Saves the gauge layout and properties to the specified file in XML format using the current XmlSerializationInfo.

Declaration

public virtual void SaveLayout(string fileName)

Parameters

Occurs when the gauge's Value property is modified. This event is fired whenever the displayed value changes.

Declaration

public event EventHandler ValueChanged

Event Value