Introduction
Knowledge Base
API Reference / Server-side / Telerik.Web.UI / RadArcGauge
New to Telerik UI for ASP.NET AJAX? Start a free 30-day trial

RadArcGauge

Class

Circular arc gauge control supporting a single value pointer, range-based coloring, and templated center label. Provides a lightweight alternative to full radial gauges.

Definition

Namespace:Telerik.Web.UI

Assembly:Telerik.Web.UI.dll

Syntax:
C#
[TelerikToolboxCategory("Visualization")]
[ToolboxBitmap(typeof(RadLinearGauge), "Toolbox.Icons.Gauge.png")]
[RequiredScript(typeof(jQueryPlugins))]
[RequiredScript(typeof(Html5DataVizGauge))]
[RequiredScript(typeof(Html5DataVizThemes))]
[ClientScriptResource("Telerik.Web.UI.RadArcGauge", "Telerik.Web.UI.Gauge.Scripts.RadArcGaugeControl.js")]
[EmbeddedSkin("ArcGauge")]
[EmbeddedSkin("ArcGauge", "Default")]
[RequiredCss("Telerik.Web.UI.Skins.HTML5UI.dataviz.css", RenderMode.Classic, typeof(RadArcGauge))]
[RequiredCss("Telerik.Web.UI.Skins.HTML5UI.dataviz.css", RenderMode.Lightweight, typeof(RadArcGauge))]
public class RadArcGauge : RadWebControl, IComponent, IDisposable, IParserAccessor, IUrlResolutionService, IDataBindingsAccessor, IControlBuilderAccessor, IControlDesignerAccessor, IExpressionsAccessor, IAttributeAccessor, IScriptControl, IControlResolver, IPostBackDataHandler, ISkinnableControl, IControl

Inheritance: objectControlWebControlRadWebControlRadArcGauge

Derived Classes: RadCircularGauge

Implements: IAttributeAccessorIComponentIControlIControlBuilderAccessorIControlDesignerAccessorIControlResolverIDataBindingsAccessorIDisposableIExpressionsAccessorIParserAccessorIPostBackDataHandlerIScriptControlISkinnableControlIUrlResolutionService...

Inherited Members WebControl.AddAttributesToRender(HtmlTextWriter)WebControl.ApplyStyle(Style)WebControl.CopyBaseAttributes(WebControl)WebControl.CreateControlStyle()WebControl.MergeStyle(Style)WebControl.Render(HtmlTextWriter)WebControl.RenderBeginTag(HtmlTextWriter)WebControl.RenderEndTag(HtmlTextWriter)WebControl.RenderContents(HtmlTextWriter)WebControl.AccessKeyWebControl.AttributesWebControl.BackColorWebControl.BorderColorWebControl.BorderWidthWebControl.BorderStyleWebControl.ControlStyleWebControl.ControlStyleCreatedWebControl.CssClassWebControl.DisabledCssClassWebControl.StyleWebControl.EnabledWebControl.EnableThemingWebControl.FontWebControl.ForeColorWebControl.HasAttributesWebControl.HeightWebControl.IsEnabledWebControl.SupportsDisabledAttributeWebControl.SkinIDWebControl.TabIndexWebControl.TagNameWebControl.ToolTipWebControl.WidthControl.ResolveAdapter()Control.HasEvents()Control.GetRouteUrl(object)Control.GetRouteUrl(string, object)Control.GetRouteUrl(RouteValueDictionary)Control.GetRouteUrl(string, RouteValueDictionary)Control.GetUniqueIDRelativeTo(Control)Control.ApplyStyleSheetSkin(Page)Control.OnDataBinding(EventArgs)Control.DataBind()Control.DataBind(bool)Control.DataBindChildren()Control.AddParsedSubObject(object)Control.EnsureID()Control.OnInit(EventArgs)Control.ClearChildState()Control.ClearChildControlState()Control.ClearChildViewState()Control.ClearEffectiveClientIDMode()Control.ClearCachedClientID()Control.Focus()Control.LoadControlState(object)Control.MapPathSecure(string)Control.OpenFile(string)Control.OnLoad(EventArgs)Control.BuildProfileTree(string, bool)Control.SaveControlState()Control.RenderChildren(HtmlTextWriter)Control.RenderControl(HtmlTextWriter)Control.RenderControl(HtmlTextWriter, ControlAdapter)Control.OnUnload(EventArgs)Control.Dispose()Control.RaiseBubbleEvent(object, EventArgs)Control.OnBubbleEvent(object, EventArgs)Control.AddedControl(Control, int)Control.CreateControlCollection()Control.CreateChildControls()Control.ResolveUrl(string)Control.ResolveClientUrl(string)Control.FindControl(string)Control.FindControl(string, int)Control.GetDesignModeState()Control.HasControls()Control.IsLiteralContent()Control.EnsureChildControls()Control.RemovedControl(Control)Control.SetDesignModeState(IDictionary)Control.SetRenderMethodDelegate(RenderMethod)Control.ClientIDModeControl.ClientIDControl.ClientIDSeparatorControl.ContextControl.AdapterControl.DesignModeControl.EventsControl.IDControl.IsChildControlStateClearedControl.EnableViewStateControl.ViewStateModeControl.IsViewStateEnabledControl.NamingContainerControl.IdSeparatorControl.LoadViewStateByIDControl.PageControl.RenderingCompatibilityControl.TemplateControlControl.ParentControl.TemplateSourceDirectoryControl.AppRelativeTemplateSourceDirectoryControl.SiteControl.VisibleControl.UniqueIDControl.HasChildViewStateControl.ControlsControl.ValidateRequestModeControl.ViewStateControl.ViewStateIgnoresCaseControl.ChildControlsCreatedControl.IsTrackingViewStateControl.DisposedControl.DataBindingControl.InitControl.LoadControl.PreRenderControl.Unloadobject.ToString()object.Equals(object)object.Equals(object, object)object.ReferenceEquals(object, object)object.GetHashCode()object.GetType()object.MemberwiseClone()...

Constructors

RadArcGauge()

C#
public RadArcGauge()

Properties

Appearance

The gauge area configuration options. This is the entire visible area of the gauge.

C#
[PersistenceMode(PersistenceMode.InnerProperty)]
public Appearance Appearance { get; }

CenterTemplate

The label template. Template variables: * value - the value

C#
[PersistenceMode(PersistenceMode.InnerProperty)]
public string CenterTemplate { get; set; }

ClientEvents

Defines the client events handlers.

C#
[PersistenceMode(PersistenceMode.InnerProperty)]
public ArcGaugeClientEvents ClientEvents { get; }

Color

The color of the value pointer. Accepts a valid CSS color string, including hex and rgb.

C#
public Color Color { get; set; }

ColorsCollection

The color ranges of the value pointer. The pointer color will be set to the color from the range that contains the current value.

C#
[PersistenceMode(PersistenceMode.InnerProperty)]
public ArcGaugeColorsCollection ColorsCollection { get; }

CssClassFormatString

The CssClass property will now be used instead of the former Skin and will be modified in AddAttributesToRender()

C#
protected override string CssClassFormatString { get; }

Overrides: RadWebControl.CssClassFormatString

Example:
C#
protected override string CssClassFormatString
{
       get
       {
           return "RadDock RadDock_{0} rdWTitle rdWFooter";
       }
}

EnableEmbeddedBaseStylesheet

Gets or sets the value, indicating whether to render the link to the embedded base stylesheet of the control or not.

C#
public override bool EnableEmbeddedBaseStylesheet { get; set; }

Overrides: RadWebControl.EnableEmbeddedBaseStylesheet

If EnableEmbeddedBaseStylesheet is set to false you will have to register the needed control base CSS file by hand.

EnableEmbeddedSkins

Gets or sets the value, indicating whether to render links to the embedded skins or not.

C#
public override bool EnableEmbeddedSkins { get; set; }

Overrides: RadWebControl.EnableEmbeddedSkins

If EnableEmbeddedSkins is set to false you will have to register the needed CSS files by hand.

Opacity

The opacity of the value pointer.

C#
public double Opacity { get; set; }

RenderAs

Sets the preferred rendering engine. If it is not supported by the browser, the Gauge will switch to the first available mode.The supported values are: "svg" - renders the widget as inline SVG document, if available or "canvas" - renders the widget as a Canvas element, if available..

C#
public GaugeRenderingEngine RenderAs { get; set; }

Scale

Configures the scale.

C#
[PersistenceMode(PersistenceMode.InnerProperty)]
public ArcScale Scale { get; }

TagKey

C#
protected override HtmlTextWriterTag TagKey { get; }

Overrides: WebControl.TagKey

Transitions

A value indicating if transition animations should be played.

C#
public bool Transitions { get; set; }

Value

The gauge value.

C#
public double Value { get; set; }

Methods

DescribeComponent(IScriptDescriptor)

C#
protected override void DescribeComponent(IScriptDescriptor descriptor)
Parameters:descriptorIScriptDescriptor

Overrides: RadWebControl.DescribeComponent(IScriptDescriptor)

LoadViewState(object)

C#
protected override void LoadViewState(object state)
Parameters:stateobject

Overrides: WebControl.LoadViewState(object)

OnPreRender(EventArgs)

C#
protected override void OnPreRender(EventArgs e)
Parameters:eEventArgs

Overrides: RadWebControl.OnPreRender(EventArgs)

SaveViewState()

C#
protected override object SaveViewState()
Returns:

object

Overrides: WebControl.SaveViewState()

TrackViewState()

C#
protected override void TrackViewState()

Overrides: WebControl.TrackViewState()

In this article
DefinitionConstructorsRadArcGauge()PropertiesAppearanceCenterTemplateClientEventsColorColorsCollectionCssClassFormatStringEnableEmbeddedBaseStylesheetEnableEmbeddedSkinsOpacityRenderAsScaleTagKeyTransitionsValueMethodsDescribeComponent(IScriptDescriptor)LoadViewState(object)OnPreRender(EventArgs)SaveViewState()TrackViewState()
Not finding the help you need?
Contact Support