NumericUpDown

[C#] NumericUpDownコントロールのフォーマット方法

C#のNumericUpDownコントロールで表示される数値のフォーマットを設定するには、DecimalPlacesプロパティとThousandsSeparatorプロパティを使用します。

DecimalPlacesプロパティは小数点以下の桁数を指定し、ThousandsSeparatorプロパティは数値にカンマ区切りを追加するかどうかを決定します。

また、ValueChangedイベントを利用して、Valueプロパティをカスタムフォーマットで表示することも可能です。

例えば、ToString("C")を使用して通貨形式に変換することができます。

これにより、ユーザーにとって見やすい数値表示を実現できます。

目次から探す

数値フォーマットの設定方法
カスタムフォーマットの実装
応用例
まとめ

数値フォーマットの設定方法

C#のNumericUpDownコントロールでは、数値の表示形式を簡単に設定できます。

ここでは、主にDecimalPlaces、ThousandsSeparator、Incrementプロパティの使い方について解説します。

DecimalPlacesプロパティの使用

DecimalPlacesプロパティは、NumericUpDownコントロールで表示する小数点以下の桁数を指定します。

例えば、2桁の小数を表示したい場合は、DecimalPlacesを2に設定します。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // DecimalPlacesを2に設定
        numericUpDown1.DecimalPlaces = 2; 
    }
}

この設定により、NumericUpDownコントロールは小数点以下2桁の数値を表示します。

ThousandsSeparatorプロパティの使用

ThousandsSeparatorプロパティを使用すると、数値の千の位にカンマを挿入することができます。

これにより、大きな数値を視覚的にわかりやすく表示できます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // ThousandsSeparatorを有効にする
        numericUpDown1.ThousandsSeparator = true; 
    }
}

この設定を行うと、例えば1000は 1,000 と表示されます。

Incrementプロパティの設定

Incrementプロパティは、NumericUpDownコントロールで数値を増減させる際のステップ値を設定します。

これにより、ユーザーが数値を調整する際の単位を指定できます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // Incrementを0.5に設定
        numericUpDown1.Increment = 0.5M; 
    }
}

この設定により、ユーザーがNumericUpDownコントロールの矢印ボタンをクリックするたびに、0.5ずつ数値が増減します。

カスタムフォーマットの実装

NumericUpDownコントロールでは、デフォルトの数値フォーマットに加えて、カスタムフォーマットを実装することができます。

ここでは、ValueChangedイベントの活用、ToStringメソッドによるフォーマット、そしてカスタムフォーマットの具体例について解説します。

ValueChangedイベントの活用

ValueChangedイベントは、NumericUpDownコントロールの値が変更されたときに発生します。

このイベントを利用して、値が変更されるたびにカスタムフォーマットを適用することができます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // ValueChangedイベントにイベントハンドラを追加
        numericUpDown1.ValueChanged += NumericUpDown1_ValueChanged; 
    }
    private void NumericUpDown1_ValueChanged(object sender, EventArgs e)
    {
        // 値が変更されたときの処理
        label1.Text = $"選択された値: {numericUpDown1.Value}"; 
    }
}

このコードでは、NumericUpDownの値が変更されると、ラベルに選択された値が表示されます。

ToStringメソッドによるフォーマット

ToStringメソッドを使用することで、数値を特定のフォーマットで文字列に変換することができます。

これにより、表示形式を柔軟に変更できます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // ToStringメソッドを使用してカスタムフォーマットを適用
        label1.Text = numericUpDown1.Value.ToString("C2"); 
    }
}

この例では、数値を通貨形式で表示し、小数点以下2桁を指定しています。

カスタムフォーマットの例

カスタムフォーマットを使用することで、さまざまな表示形式を実現できます。

以下にいくつかの例を示します。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // カスタムフォーマットの例
        numericUpDown1.ValueChanged += NumericUpDown1_ValueChanged; 
    }
    private void NumericUpDown1_ValueChanged(object sender, EventArgs e)
    {
        // 科学的記数法で表示
        label1.Text = numericUpDown1.Value.ToString("E2"); 
        
        // パーセント形式で表示
        // label1.Text = numericUpDown1.Value.ToString("P0"); 
        
        // 整数形式で表示
        // label1.Text = numericUpDown1.Value.ToString("N0"); 
    }
}

このコードでは、ValueChangedイベントで数値を科学的記数法、パーセント形式、または整数形式で表示することができます。

コメントアウトされた行を切り替えることで、異なるフォーマットを簡単に試すことができます。

応用例

NumericUpDownコントロールを使用する際、さまざまなフォーマットで数値を表示することができます。

ここでは、通貨形式、パーセント形式、科学的記数法での表示方法について具体的な例を示します。

通貨形式での表示

通貨形式で数値を表示するには、ToStringメソッドを使用して C フォーマット指定子を指定します。

これにより、数値が通貨の形式で表示されます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // 通貨形式で表示
        numericUpDown1.ValueChanged += NumericUpDown1_ValueChanged; 
    }
    private void NumericUpDown1_ValueChanged(object sender, EventArgs e)
    {
        // 通貨形式でラベルに表示
        label1.Text = numericUpDown1.Value.ToString("C2"); 
    }
}

このコードでは、NumericUpDownの値が変更されるたびに、ラベルに通貨形式で表示されます。

例えば、1000は ¥1,000.00 と表示されます。

パーセント形式での表示

パーセント形式で数値を表示するには、ToStringメソッドを使用して P フォーマット指定子を指定します。

これにより、数値がパーセント形式で表示されます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // パーセント形式で表示
        numericUpDown1.ValueChanged += NumericUpDown1_ValueChanged; 
    }
    private void NumericUpDown1_ValueChanged(object sender, EventArgs e)
    {
        // パーセント形式でラベルに表示
        label1.Text = numericUpDown1.Value.ToString("P0"); 
    }
}

このコードでは、NumericUpDownの値が変更されるたびに、ラベルにパーセント形式で表示されます。

例えば、0.25は 25% と表示されます。

科学的記数法での表示

科学的記数法で数値を表示するには、ToStringメソッドを使用して E フォーマット指定子を指定します。

これにより、数値が科学的記数法で表示されます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // 科学的記数法で表示
        numericUpDown1.ValueChanged += NumericUpDown1_ValueChanged; 
    }
    private void NumericUpDown1_ValueChanged(object sender, EventArgs e)
    {
        // 科学的記数法でラベルに表示
        label1.Text = numericUpDown1.Value.ToString("E2"); 
    }
}

このコードでは、NumericUpDownの値が変更されるたびに、ラベルに科学的記数法で表示されます。

例えば、1000は 1.00E+03 と表示されます。

これらの応用例を通じて、NumericUpDownコントロールの表示形式を柔軟に変更する方法を学ぶことができます。