WPF Gauge Control

Overview

This project provides a fully customizable Gauge control for WPF, implemented in C# and XAML.
It is designed for use in dashboards, monitoring systems, industrial applications, and any scenario where analog-style visualization is required.

The control supports:

• Flexible scale angles
• Major and minor ticks
• Custom fonts and colors
• Multiple value display locations
• Inverted and non-inverted ranges
• Precise visual tuning using relative extents

All properties are implemented as Dependency Properties, making the control binding-friendly and suitable for MVVM architectures.

---

Installation

Option 1: Copy Source Files (Recommended)

1. Copy the following files into your WPF project:

   • Gauge.xaml
   • Gauge.xaml.cs

2. Ensure the namespace matches your project or update the XAML usage accordingly.

3. Build the project.

---

Option 2: Git Submodule

git submodule add https://github.com/hosein-srj/GaugeControl

Usage

<Window
    xmlns:local="clr-namespace:GaugeExample"
    ...>

    <local:Gauge
        Width="220"
        Height="200"
        Minimum="0"
        Maximum="6000"
        Value="3500"
        ScaleStartAngle="180"
        ScaleEndAngle="0"
        InvertedRange="True"

        TickInterval="1000"
        MinorTickInterval="250"

        LabelFontSize="13"
        LabelFontWeight="Bold"
        LabelFontBrush="#1D521A"

        NeedleBrush="#1D521A"
        RangeBrush="#1D521A"

        ValueExtent="0.25"
        ValueLocation="BottomCenter"
        ValueFontSize="18"
        ValueFontWeight="SemiBold"
        ValueFontBrush="#1D521A"
        ValueFormatString="{}{0:F0}"
    />
</Window>

Gauge Control – Properties Reference

The Gauge control exposes a rich set of Dependency Properties for full visual and behavioral customization.

Value & Range Properties

Property	Type	Description
Minimum	double	Minimum value of the gauge
Maximum	double	Maximum value of the gauge
Value	double	Current value displayed by the needle
InvertedRange	bool	If true, the scale direction is reversed
RangeScaleFactor	double	Multiplier applied to range values (e.g. 1000 for RPM in thousands)

Scale & Angle Properties

Property	Type	Description
ScaleStartAngle	double	Start angle of the scale (degrees)
ScaleEndAngle	double	End angle of the scale (degrees)
RangeInnerStartExtent	double	Inner radius of range at scale start
RangeOuterStartExtent	double	Outer radius of range at scale start
RangeInnerEndExtent	double	Inner radius of range at scale end
RangeOuterEndExtent	double	Outer radius of range at scale end

Tick Properties

Major Ticks

Property	Type	Description
TickInterval	double	Interval between major ticks
TickStartExtent	double	Start radius of major ticks
TickEndExtent	double	End radius of major ticks
TickBrush	Brush	Color of major ticks
TickStrokeWidth	double	Thickness of major ticks

Minor Ticks

Property	Type	Description
MinorTickInterval	double	Interval between minor ticks
MinorTickStartExtent	double	Start radius of minor ticks
MinorTickEndExtent	double	End radius of minor ticks
MinorTickBrush	Brush	Color of minor ticks
MinorTickStrokeWidth	double	Thickness of minor ticks

Label Properties (Scale Numbers)

Property	Type	Description
LabelFontFamily	FontFamily	Font family of scale labels
LabelFontSize	double	Font size of scale labels
LabelFontWeight	FontWeight	Font weight of scale labels
LabelFontBrush	Brush	Color of scale labels
LabelFormatString	string	Format string for labels perceived values
LabelExtent	double	Radial position of labels

Needle Properties

Property	Type	Description
NeedleBrush	Brush	Color of the needle
NeedleEndExtent	double	Needle length relative to radius
NeedleEndWidth	double	Needle width
NeedleCircleRadius	double	Radius of needle pivot circle
NeedlePivotBrush	Brush	Pivot fill color
NeedlePivotOutlineBrush	Brush	Pivot outline color
NeedlePivotEndExtent	double	Pivot circle size

Value Display Properties (Center / Bottom Value)

Property	Type	Description
ValueExtent	double	Radial position of the value text
PostfixValue	string	Text appended after the value (e.g. V, RPM)
ValueFormatString	string	.NET format string for value
ValueFontFamily	FontFamily	Font family of value text
ValueFontSize	double	Font size of value text
ValueFontWeight	FontWeight	Font weight of value text
ValueFontBrush	Brush	Color of value text
ValueLocation	ValueLocationEnum	Position of value text

ValueLocation Enum

Controls where the value text is rendered.

Value	Description
Center	Center of the gauge
LeftCenter	Left of center
RightCenter	Right of center
BottomCenter	Bottom center of gauge
TopCenter	Top center of gauge

Range Properties

Property	Type	Description
RangeBrush	Brush	Color of the scale range
RangeScaleFactor	double	Visual scale multiplier for ranges

License

This project is licensed under the MIT License. Feel free to use and modify.

---

Contributing

If you’d like to contribute:

1. Fork the repo 🍴
2. Create a new branch: git checkout -b feature-name
3. Commit your changes: git commit -m "Add feature X"
4. Push to your branch: git push origin feature-name
5. Open a Pull Request 🚀