The requested page is not available for the requested platform. You are viewing the content for Default platform.

ASPxGaugeControl.Value Property

Gets or sets the ASPxGaugeControl's value.

Namespace: DevExpress.Web.ASPxGauges

Assembly: DevExpress.Web.ASPxGauges.v19.2.dll

Declaration

[DefaultValue("")]
public string Value { get; set; }
<DefaultValue("")>
Public Property Value As String

Property Value

Type Default Description
String

String.Empty

A string value that specifies the control's value.

Remarks

The ASPxGaugeControl's value specifies the value or text of the first gauge found, contained within the ASPxGaugeControl.Gauges collection.

The value is calculated as shown below:

  • Digital

    
    IDigitalGauge dGauge = gaugeControl.Gauges[0] as IDigitalGauge;
    if (dGauge != null)
        value = dGauge.Text;
    
  • Circular

    
    ICircularGauge cGauge = gaugeControl.Gauges[0] as ICircularGauge;
    if (cGauge != null && cGauge.Scales.Count > 0)
        value = cGauge.Scales[0].Value;
    
  • Linear

    
    ILinearGauge lGauge = gaugeControl.Gauges[0] as ILinearGauge;
    if (cGauge != null && lGauge.Scales.Count > 0)
        value = lGauge.Scales[0].Value;
    
  • State Indicator

    
    IStateIndicatorGauge sGauge = gaugeControl.Gauges[0] as IStateIndicatorGauge;
    if (sGauge != null && sGauge.Indicators.Count > 0)
        value = sGauge.Indicators[0].StateIndex;
    

Examples

This example demonstrates how change the ASPxGaugeControl's value using an ASPxSpinEdit.

The spin editor's ValueChanged event is handled to call the gauge's client-side ASPxClientGaugeControl.PerformCallback method, passing the spin editor's value. As a result, the ASPxGaugeControl.CustomCallback event is raised, and the spin editor's new value, specified by the e.Parameter property, is assigned to the ASPxGaugeControl.Value property. After a custom callback has been performed, the ASPxGaugeControl is automatically re-rendered.

The animation below, shows the result:

gcCustomCallbacks

<dxe:ASPxSpinEdit runat="server" Number="0" Width="157px" Height="21px" ID="ASPxSpinEdit1">
    <ClientSideEvents ValueChanged="function(s, e) {
        gc.PerformCallback(s.GetValue());}">
    </ClientSideEvents>
</dxe:ASPxSpinEdit>
protected void ASPxGaugeControl2_CustomCallback(object source,
                  DevExpress.Web.CallbackEventArgsBase e) {
    ASPxGaugeControl2.Value = e.Parameter;
}
See Also