Bunifu Radial Gauge is a dynamic control that provides meter-based readings for real-world and virtual devices/activities.

Here's a very simple preview of the control in action:

Using Bunifu Radial Gauge

Once you've added Bunifu.UI.WniForms.BunifuRadialGauge.dll  inside Visual Studio's Toolbox, simply drag it to your Form or User Control to use it. 

You can always make use of the Smart Tags which easily gives you access to the most common properties of the control:

Movements

There are two forms of movements in the Radial Gauge: Direct and Transitional (or Animated). To transition movement from one value to another, use the property ValueByTransition. The default movement property is Value :

// Transition value...
bunifuRadialGauge1.ValueByTranisiton = 70;

// Direct movement...
BunifuRadialGauge1.Value = 70;

Here's an example illustrating both movements:

Setting Ranges

You can set your own defined range, from one value to another using the properties RangeStart  and RangeEnd :

// Set the starting value.
bunifuRadialGauge1.RangeStart = 0;

// Set the ending value.
bunifuRadialGauge1.RangeEnd = 250;

Working With 'ProgressHighValueMark' Property

The property ProgressHighValueMark  lets you set a value that denotes, for example, a danger zone marking and provides users with some visual feedback using the color property ProgressColorHigh

So for example, if your ranges begins from 0 and ends at 100, you can set the ProgressHighValueMark  to 70 so that when the value reaches 70 or higher, the Radial Gauge's color will be changed to reflect the set ProgressColorHigh color property.

Here's an example:

Prefixes and Suffixes

You can provide a prefix (e.g. $) or suffix (e.g. %) using the properties Prefix  and Suffix respectively. This lets you include measuring units before and/or after the Gauge value thus giving you maximum flexibility when creating customized Gauges.

Here's a preview of both properties in action:

Setting the Gauge's Thickness

You can customize the Gauge's thickness to your own liking using the Thickness property:

// Provide a standard thickness.
bunifuRadialGauge1.Thickness = 30;

// Make the Gauge thin.
bunifuRadialGauge1.Thickness = 10;

// Make the Gauge really fat.
bunifuRadialGauge1.Thickness = 55;

Showing or Hiding Range Labels

You can show or hide the Gauge's range value and labels by setting the properties ShowValueLabel  and ShowRangeLabels  to true  or false  respectively:

You can also change the color of the value label and range labels using the ValueLabelColor and RangeLabelsColor respectively.

Automatic Back Color Changes

Sometimes you may want to automatically set the Gauge's ProgressBackColor  whenever the progress changes to a high or a low. This is where the properties AutoGenerateProgressColorWhenHigh  and AutoGenerateProgressColorWhenLow come in handy. When these two properties are set to true , you won't need to set the ProgressBackColor ; only set the ProgressColorLow and ProgressColorHigh and you're good to go!

What's coming next?

Well, we're working hard at adding new customization features for this control which I'm pretty sure will leave you amazed! We hope you like (or better yet... love) Bunifu Radial Gauge as we deep-dive into newer features in the coming releases. 

Do have fun with it!

Did this answer your question?