Click here to Skip to main content
65,938 articles
CodeProject is changing. Read more.
Articles
(untagged)

NumericUpDown with unit measure

0.00/5 (No votes)
17 Jun 2007 1  
How to create a NumericUpDown control with unit measure. Support Vista styles!

Screenshot - UpDownEx_with_measure.jpg

This control was designed by CTR (centro-tecnologia-rocci)
Rocci Luca & D'Andrea Vito

Introduction

This control is an evolution of the classic control numericUpDown. The control numericUpDown visualizes and returns through property value, a decimal value, but, what if we need to increment a numeric value specifying also the measure? To this point our UpDownEx control enters in game. Our control returns a double value and visualizes a type value double and some text that indicates the measure. The increment is relative to the precision of the visualized number.

For example, if you enter a number with 3 decimal digits, the increment will be in 0.001. Plus every steps in the measure stair is automatic, either in increment or in decrement phases.

The code

The UpDownEx code inherits "Control" class and includes a numercUpDown standard control and some properties like an Array that indicates the measures.

    Private Sub Format()
        Dim str_Format As String
        If UpDown.Value = int_Factor * (int_UnitsActual) And int_UnitsActual > 0 Then
            int_UnitsActual -= 1
            UpDown.Value -= 1
            UpDown.DecimalPlaces -= 1
        ElseIf UpDown.Value = int_Factor * (int_UnitsActual + 1) And int_UnitsActual < str_Units.Length Then
            int_UnitsActual += 1
            UpDown.Value += 1
            UpDown.DecimalPlaces += 1
        End If
        UpDown.Increment = dbl_Decimals(UpDown.DecimalPlaces)
        Dim i As Integer
        str_Format = "#,"
        For i = 0 To UpDown.DecimalPlaces - 1
            str_Format += "#"
        Next
        str_Format += "0."
        For i = 0 To UpDown.DecimalPlaces - 1
            str_Format += "0"
        Next
        dbl_Value = UpDown.Value - (int_Factor * int_UnitsActual)
        Me.TextControl.Text = dbl_Value.ToString(str_Format) & " " & str_Units(int_UnitsActual)
    End Sub
Property

Screenshot - NewProperty.gif

Units of measure

  • Factor: Representing the step between two units of measure
  • Maximum: Representing the max value
  • Minumum: Representing the min value
  • MeasureUnits: Representing an array of strings containing the units of measure

Values

  • FormattedValues: Representing the value with the units of measure
  • UnformattedValues: Representing the value
Support Windows Vista Styles

Screenshot - vistaos.jpg

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here