CustomizeGuage

---

• Izenda 7 Series Documentation
• Release Notes
• Upgrade Best Practices
• FAQ
• Tutorials
• The Izenda API
• The AdHocSettings class
• Developer Links and Guides
• Known Issues

---

• Izenda Website
• Product Video
• Izenda Blog
• About Us
• Contact Us

---

• Guide To Report Design
• Making Custom Forms Video

---

• Acknowledgements

About

This method allows customization of the gauge that is rendered on reports. Since the gauge image returned is static, this override will not work for animated or interactive gauges.

C# Example

public override System.Drawing.Image CustomizeGuage(double value, double min, double max, string name, System.Drawing.Image GuageImage)
{
    int dashboardGaugeWidth = AdHocSettings.DashboardGaugeWidth;
    Dundas.Gauges.WebControl.GaugeContainer container = new Dundas.Gauges.WebControl.GaugeContainer();
    container.RenderType = Dundas.Gauges.WebControl.RenderType.BinaryStreaming;
    container.Width = AdHocSettings.DashboardGaugeWidth;
    container.Height = AdHocSettings.DashboardGaugeWidth;
    Dundas.Gauges.WebControl.CircularGauge myCircularGauge = container.CircularGauges.Add("MyCircularGauge");
    myCircularGauge.BackFrame.Image = "custom_gauge.png"; //The static image file for the back of the gauge. This needs to exist in the resources
    myCircularGauge.Size.Width = dashboardGaugeWidth / 2;
    myCircularGauge.Size.Height = dashboardGaugeWidth / 2;
    myCircularGauge.Scales["Default"].Maximum = max;
    myCircularGauge.Scales["Default"].Minimum = min < 2 ? 0 : min;
    myCircularGauge.Scales["Default"].StartAngle = 45;
    myCircularGauge.Scales["Default"].SweepAngle = 270;
    myCircularGauge.Pointers["Default"].Value = value;
    myCircularGauge.PivotPoint.Y = 50;
    myCircularGauge.Pointers[0].Type = Dundas.Gauges.WebControl.CircularPointerType.Needle;
    myCircularGauge.Pointers[0].Width = 4;
    myCircularGauge.Pointers[0].FillColor = System.Drawing.Color.Black;
    myCircularGauge.Pointers[0].FillGradientType = Dundas.Gauges.WebControl.GradientType.None;
    myCircularGauge.Pointers[0].NeedleStyle = Dundas.Gauges.WebControl.NeedleStyle.NeedleStyle4;
    myCircularGauge.Pointers[0].CapVisible = true;
    myCircularGauge.Pointers[0].CapOnTop = true;
    myCircularGauge.Pointers[0].CapWidth = 15;
    myCircularGauge.Pointers[0].CapStyle = Dundas.Gauges.WebControl.CapStyle.CustomCap1;
    myCircularGauge.Pointers[0].CapFillColor = System.Drawing.Color.White;
    myCircularGauge.Pointers[0].CapFillGradientEndColor = System.Drawing.Color.FromArgb(255, 106, 121, 131);
    myCircularGauge.Pointers[0].CapFillGradientType = Dundas.Gauges.WebControl.GradientType.DiagonalRight;
    myCircularGauge.Pointers[0].BorderWidth = 0;
    myCircularGauge.Pointers[0].BorderStyle = Dundas.Gauges.WebControl.GaugeDashStyle.NotSet;
    myCircularGauge.Pointers[0].ShadowOffset = 0;
    myCircularGauge.Pointers[0].Visible = true;
    myCircularGauge.BackFrame.FrameStyle = Dundas.Gauges.WebControl.BackFrameStyle.Simple;
    myCircularGauge.BackFrame.FrameWidth = 10;
    myCircularGauge.BackFrame.BackColor = System.Drawing.Color.White;
    myCircularGauge.BackFrame.FrameShape = Dundas.Gauges.WebControl.BackFrameShape.AutoShape;
    myCircularGauge.Scales["Default"].Width = 0;
    myCircularGauge.Scales["Default"].FillColor = System.Drawing.Color.Transparent;
    myCircularGauge.Scales["Default"].FillGradientType = Dundas.Gauges.WebControl.GradientType.None;
    myCircularGauge.Scales["Default"].BorderColor = System.Drawing.Color.Transparent;
    myCircularGauge.Scales["Default"].BorderStyle = Dundas.Gauges.WebControl.GaugeDashStyle.NotSet;
    myCircularGauge.Scales["Default"].MinorTickMark.Visible = false;
    myCircularGauge.Scales["Default"].MajorTickMark.Width = 1;
    myCircularGauge.Scales["Default"].MajorTickMark.Length = 8;
    myCircularGauge.Scales["Default"].MajorTickMark.DistanceFromScale = 4;
    myCircularGauge.Scales["Default"].MajorTickMark.Placement = Dundas.Gauges.WebControl.Placement.Outside;
    myCircularGauge.Scales["Default"].MajorTickMark.Interval = max / 5;
    myCircularGauge.Scales["Default"].MaximumPin.Visible = true;
    myCircularGauge.Scales["Default"].LabelStyle.AllowUpsideDown = false;
    myCircularGauge.Scales["Default"].LabelStyle.RotateLabels = false;
    myCircularGauge.Scales["Default"].LabelStyle.Placement = Dundas.Gauges.WebControl.Placement.Cross;
    myCircularGauge.Scales["Default"].LabelStyle.DistanceFromScale = 10;
    myCircularGauge.Scales["Default"].LabelStyle.ShowEndLabels = true;
    foreach (Dundas.Gauges.WebControl.CircularRange range in myCircularGauge.Ranges)
        range.Visible = false;
    MemoryStream ms = new MemoryStream();
    container.SaveAsImage(ms);
    System.Drawing.Image result = new System.Drawing.Bitmap(ms);
    return result;
}

VB.NET Example

Public Overrides Function CustomizeGuage(value As Double, min As Double, max As Double, name As String, guageImage As Drawing.Image) As Drawing.Image
    Dim dashboardGaugeWidth As Integer = AdHocSettings.DashboardGaugeWidth
    Dim container As New Dundas.Gauges.WebControl.GaugeContainer()
    container.RenderType = Dundas.Gauges.WebControl.RenderType.BinaryStreaming
    container.Width = AdHocSettings.DashboardGaugeWidth
    container.Height = AdHocSettings.DashboardGaugeWidth
    Dim myCircularGauge As Dundas.Gauges.WebControl.CircularGauge = container.CircularGauges.Add("MyCircularGauge")
    myCircularGauge.BackFrame.Image = "custom_gauge.png" ' The Static image file For the back Of the gauge. This needs To exist In the resources
    myCircularGauge.Size.Width = dashboardGaugeWidth / 2
    myCircularGauge.Size.Height = dashboardGaugeWidth / 2
    myCircularGauge.Scales("Default").Maximum = max
    myCircularGauge.Scales("Default").Minimum = If(min < 2, 0, min)
    myCircularGauge.Scales("Default").StartAngle = 45
    myCircularGauge.Scales("Default").SweepAngle = 270
    myCircularGauge.Pointers("Default").Value = value
    myCircularGauge.PivotPoint.Y = 50
    myCircularGauge.Pointers(0).Type = Dundas.Gauges.WebControl.CircularPointerType.Needle
    myCircularGauge.Pointers(0).Width = 4
    myCircularGauge.Pointers(0).FillColor = System.Drawing.Color.Black
    myCircularGauge.Pointers(0).FillGradientType = Dundas.Gauges.WebControl.GradientType.None
    myCircularGauge.Pointers(0).NeedleStyle = Dundas.Gauges.WebControl.NeedleStyle.NeedleStyle4
    myCircularGauge.Pointers(0).CapVisible = True
    myCircularGauge.Pointers(0).CapOnTop = True
    myCircularGauge.Pointers(0).CapWidth = 15
    myCircularGauge.Pointers(0).CapStyle = Dundas.Gauges.WebControl.CapStyle.CustomCap1
    myCircularGauge.Pointers(0).CapFillColor = System.Drawing.Color.White
    myCircularGauge.Pointers(0).CapFillGradientEndColor = System.Drawing.Color.FromArgb(255, 106, 121, 131)
    myCircularGauge.Pointers(0).CapFillGradientType = Dundas.Gauges.WebControl.GradientType.DiagonalRight
    myCircularGauge.Pointers(0).BorderWidth = 0
    myCircularGauge.Pointers(0).BorderStyle = Dundas.Gauges.WebControl.GaugeDashStyle.NotSet
    myCircularGauge.Pointers(0).ShadowOffset = 0
    myCircularGauge.Pointers(0).Visible = True
    myCircularGauge.BackFrame.FrameStyle = Dundas.Gauges.WebControl.BackFrameStyle.Simple
    myCircularGauge.BackFrame.FrameWidth = 10
    myCircularGauge.BackFrame.BackColor = System.Drawing.Color.White
    myCircularGauge.BackFrame.FrameShape = Dundas.Gauges.WebControl.BackFrameShape.AutoShape
    myCircularGauge.Scales("Default").Width = 0
    myCircularGauge.Scales("Default").FillColor = System.Drawing.Color.Transparent
    myCircularGauge.Scales("Default").FillGradientType = Dundas.Gauges.WebControl.GradientType.None
    myCircularGauge.Scales("Default").BorderColor = System.Drawing.Color.Transparent
    myCircularGauge.Scales("Default").BorderStyle = Dundas.Gauges.WebControl.GaugeDashStyle.NotSet
    myCircularGauge.Scales("Default").MinorTickMark.Visible = False
    myCircularGauge.Scales("Default").MajorTickMark.Width = 1
    myCircularGauge.Scales("Default").MajorTickMark.Length = 8
    myCircularGauge.Scales("Default").MajorTickMark.DistanceFromScale = 4
    myCircularGauge.Scales("Default").MajorTickMark.Placement = Dundas.Gauges.WebControl.Placement.Outside
    myCircularGauge.Scales("Default").MajorTickMark.Interval = max / 5
    myCircularGauge.Scales("Default").MaximumPin.Visible = True
    myCircularGauge.Scales("Default").LabelStyle.AllowUpsideDown = False
    myCircularGauge.Scales("Default").LabelStyle.RotateLabels = False
    myCircularGauge.Scales("Default").LabelStyle.Placement = Dundas.Gauges.WebControl.Placement.Cross
    myCircularGauge.Scales("Default").LabelStyle.DistanceFromScale = 10
    myCircularGauge.Scales("Default").LabelStyle.ShowEndLabels = True
    For Each range As Dundas.Gauges.WebControl.CircularRange In myCircularGauge.Ranges
        range.Visible = False
    Next
    Dim ms As New MemoryStream()
    container.SaveAsImage(ms)
    Dim result As New System.Drawing.Bitmap(ms)
    Return result
End Function

Samples

Here is the background image used for the above examples:

And here is the completely rendered gauge using some sample data: