RadLinearGauge
Represents a linear gauge control for displaying a value within a defined range using various visual indicators such as bars, ticks, labels, and needles.
Definition
Namespace:Telerik.WinControls.UI.Gauges
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadLinearGauge : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProviderInheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadLinearGauge...
Derived Classes:
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadLinearGauge class.
public RadLinearGauge()Properties
Gets the default size of the control based on its orientation.
protected override Size DefaultSize { get; }Overrides:
Gets or sets the foreground color of the control, which is applied to the root element.
public override Color ForeColor { get; set; }Overrides:
Gets the RadLinearGaugeElement that represents the main gauge element containing all visual components.
[Browsable(false)]
public RadLinearGaugeElement GaugeElement { get; }Gets the collection of gauge items (bars, ticks, labels, needles, etc.) that comprise the gauge's visual elements.
[RadEditItemsAction]
public virtual RadItemOwnerCollection Items { get; }Gets the type name of the RadLinearGauge for serialization purposes.
protected virtual string RadLinearGaugeName { get; }Gets or sets the maximum value of the gauge range.
public float RangeEnd { get; set; }Gets or sets the minimum value of the gauge range.
public float RangeStart { get; set; }Gets or sets the current value displayed on the gauge within the specified range.
[Bindable(true)]
public float Value { get; set; }Gets or sets the serialization information for the RadLinearGauge used by Save/Load layout methods to persist gauge settings to/from XML. By default, or when set to null, the ComponentXmlSerializationInfo provided by GetDefaultXmlSerializationInfo() will be used.
[Browsable(false)]
public virtual ComponentXmlSerializationInfo XmlSerializationInfo { get; set; }Methods
Creates the child elements for the control, specifically the main RadLinearGaugeElement.
protected override void CreateChildItems(RadElement parent)The parent element that will contain the child items.
Overrides:
Gets the default XML serialization information for the RadLinearGauge control.
public virtual ComponentXmlSerializationInfo GetDefaultXmlSerializationInfo()The default ComponentXmlSerializationInfo for this control.
Gets the desired size of the root element after applying DPI scaling factors.
Loads RadLinearGauge properties, sub-objects and their properties from an XML file, using the serialization information provided by the XmlSerializationInfo property.
public virtual void LoadLayout(string fileName, DesignTimeInstanceFactory factory)The file name to load the XML layout from.
factoryDesignTimeInstanceFactoryThe DesignTimeInstanceFactory to use for creating objects during deserialization.
Loads RadLinearGauge properties, sub-objects and their properties from an XML file, using the serialization information provided by the XmlSerializationInfo property.
public virtual void LoadLayout(string fileName)The file name to load the XML layout from.
Loads RadLinearGauge properties, sub-objects and their properties from an XML reader with the specified instance factory.
public virtual void LoadLayout(XmlReader xmlReader, InstanceFactory factory)The XmlReader containing the layout data.
factoryInstanceFactoryThe InstanceFactory to use for creating objects during deserialization.
Loads RadLinearGauge properties, sub-objects and their properties from an XML reader, using the serialization information provided by the XmlSerializationInfo property.
Resets the gauge properties to their default values.
protected virtual void ResetFields()Stores RadLinearGauge properties, sub-objects and their properties to a stream in XML format, using the serialization information provided by the XmlSerializationInfo property. The XML content is written to the stream and the stream is left open.
public virtual void SaveLayout(Stream stream)The stream to write the XML content to.
Stores RadLinearGauge properties, sub-objects and their properties to a file in XML format, using the serialization information provided by the XmlSerializationInfo property.
public virtual void SaveLayout(string fileName)The file name to save the XML layout to.
Stores RadLinearGauge properties, sub-objects and their properties in XML format, using the serialization information provided by the XmlSerializationInfo property.
Scales the control based on the specified scaling factors for DPI scaling support.
protected override void ScaleControl(SizeF factor, BoundsSpecified specified)The scaling factor to apply to the control.
specifiedBoundsSpecifiedThe bounds to scale.
Overrides:
Events
Occurs when the orientation of the gauge is changed between horizontal and vertical.
public event EventHandler OrientationChangedOccurs when the gauge value is modified.
public event EventHandler ValueChanged