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:
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
// Transition value...
bunifuRadialGauge1.ValueByTranisiton = 70;
// Direct movement...
BunifuRadialGauge1.Value = 70;
Here's an example illustrating both movements:
You can set your own defined range, from one value to another using the properties
// Set the starting value.
bunifuRadialGauge1.RangeStart = 0;
// Set the ending value.
bunifuRadialGauge1.RangeEnd = 250;
Working With 'ProgressHighValueMark' 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
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
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
// 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
You can also change the color of the value label and range labels using the
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
AutoGenerateProgressColorWhenLow come in handy. When these two properties are set to
true , you won't need to set the
ProgressBackColor ; only set the
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!