NumericUpDownCell クラス

ユーザーが数値を選択または入力できるようにし、それらの値を指定された書式で表示するCellを表します。

構文

Visual Basic (宣言)
C#

Public Class NumericUpDownCell 
   Inherits Cell

public class NumericUpDownCell : Cell

解説

NumericUpDownCellには1つの数値が含まれており、コントロールの上下ボタンをクリックすることでその数値を増減できます。Cell.ReadOnlyプロパティがtrueに設定されていない場合は、ユーザーが値を入力することもできます。

数値表示の書式を設定するには、DecimalPlaces、Hexadecimal、ThousandsSeparatorの各プロパティを設定します。コントロールに16進数値を表示するには、Hexadecimalプロパティをtrueに設定します。適切な場合に10進数値に桁区切り文字を表示するには、ThousandsSeparatorプロパティをtrueに設定します。小数点以下の桁数を指定するには、DecimalPlacesプロパティを表示する桁数に設定します。

コントロールに設定できる範囲を指定するには、MinimumプロパティとMaximumプロパティを設定します。ユーザーが上下ボタンをクリックしたときにValueプロパティを増減する値を指定するには、Increment値を設定します。ユーザーが上下ボタンを押し続けたときにコントロールの数値が変化する速度を上げるには、Accelerationsプロパティを設定します。

使用例

次のサンプルコードは、NumericUpDownCellの持ついくつかの重要なプロパティを示します。Column1では、Minimumは0で、Maximumは10です。編集モードに入ると、テキストが強調表示されます。上下左右の矢印キーを使用して値を増減できます。キーを1回押すと、値が0.01増減します。セルを選択すると、上下ボタンが表示されます。Column2では、値は16進数で表示され、初期値15は"F"と表示されます。上下ボタンは左揃えで配置され、テキスト全体を表示できない場合は中央に省略文字列が表示されます。

C#
Visual Basic

using System;
using System.Windows.Forms;
using System.Drawing;

namespace GrapeCity.Win.MultiRow.SampleCode
{
    public class NumericUpDownCellDemo : Form
    {
        private GcMultiRow gcMultiRow1 = new GcMultiRow();

        public NumericUpDownCellDemo()
        {
            this.Text = "NumericUpDownCell Demo";
            this.gcMultiRow1.Dock = DockStyle.Fill;
            this.Controls.Add(this.gcMultiRow1);
            this.Load += new EventHandler(Form1_Load);

            this.Size = new Size(400, 400);
        }

        private void Form1_Load(object sender, EventArgs e)
        {
            NumericUpDownCell numericUpDownCell1 = new NumericUpDownCell();

            //The minimum value is 0, maximum value is 10, initial value is 0;
            numericUpDownCell1.Minimum = 0;
            numericUpDownCell1.Maximum = 10;
            numericUpDownCell1.Value = 0;
            //Use the Left, Right, Up, Down key to operate.
            numericUpDownCell1.InterceptArrowKeys = true;
            //Select one Cell, the SpinButton will display.
            numericUpDownCell1.ShowSpinButton = CellButtonVisibility.ShowForCurrentCell;
            numericUpDownCell1.DecimalPlaces = 2;
            //Press the arrow key, the value will increase 0.01
            numericUpDownCell1.Increment = 0.01m;
            //Enter edit mode ,the text will be highlight selected.
            numericUpDownCell1.HighlightText = true;

            NumericUpDownCell numericUpDownCell2 = new NumericUpDownCell();
            numericUpDownCell2.Value = 16m;
            //The value will display as hexadecimal.
            numericUpDownCell2.Hexadecimal = true;
            //The initial value is 15, it will display 'F'
            numericUpDownCell2.Value = 15;
            //The UpDown button will align to left.
            numericUpDownCell2.UpDownAlign = LeftRightAlignment.Left;
            //The thousand separator ',' will be inserted.
            numericUpDownCell2.ThousandsSeparator = true;
            //Press the Up or Down key all the time, after 2 seconds, the value will increase 50 once, after 6 seconds, 300 increased once.
            numericUpDownCell2.Accelerations.AddRange(new NumericUpDownAcceleration[] { new NumericUpDownAcceleration(2, 50), new NumericUpDownAcceleration(6, 300) });
            //If the value cannot be displayed completely, one ellipsis string will show in the middle.
            numericUpDownCell2.Ellipsis = MultiRowEllipsisMode.EllipsisPath;
            numericUpDownCell2.EllipsisString = "...";

            Template template1 = Template.CreateGridTemplate(new Cell[] { numericUpDownCell1, numericUpDownCell2 }, Int32.MaxValue,
                AutoGenerateGridTemplateStyles.ColumnHeader | AutoGenerateGridTemplateStyles.RowHeaderAutoNumber);
            template1.ColumnHeaders[0].Cells[0].Value = "Column1";
            template1.ColumnHeaders[0].Cells[1].Value = "Column2";

            gcMultiRow1.Template = template1;
            gcMultiRow1.RowCount = 10;
        }

        [STAThreadAttribute()]
        public static void Main()
        {
            Application.EnableVisualStyles();
            Application.Run(new NumericUpDownCellDemo());
        }
    }
}

Imports System
Imports System.Windows.Forms
Imports System.Drawing
Imports GrapeCity.Win.MultiRow

Public Class NumericUpDownCellDemo
    Inherits Form
    Private gcMultiRow1 As New GcMultiRow()

    Public Sub New()
        Me.Text = "NumericUpDownCell Demo"

        Me.gcMultiRow1.Dock = DockStyle.Fill
        Me.Controls.Add(Me.gcMultiRow1)

        Me.Size = New Size(400, 400)
    End Sub

    Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
        Dim numericUpDownCell1 As New NumericUpDownCell()

        'The minimum value is 0, maximum value is 10, initial value is 0;
        numericUpDownCell1.Minimum = 0
        numericUpDownCell1.Maximum = 10
        numericUpDownCell1.Value = 0
        'Use the Left, Right, Up, Down key to operate.
        numericUpDownCell1.InterceptArrowKeys = True
        'Select one Cell, the SpinButton will display.
        numericUpDownCell1.ShowSpinButton = CellButtonVisibility.ShowForCurrentCell
        numericUpDownCell1.DecimalPlaces = 2
        'Press the arrow key, the value will increase 0.01
        numericUpDownCell1.Increment = 0.01D
        'Enter edit mode ,the text will be highlight selected.
        numericUpDownCell1.HighlightText = True

        Dim numericUpDownCell2 As New NumericUpDownCell()
        numericUpDownCell2.Value = 16D
        'The value will display as hexadecimal.
        numericUpDownCell2.Hexadecimal = True
        'The initial value is 15, it will display 'F'
        numericUpDownCell2.Value = 15
        'The UpDown button will align to left.
        numericUpDownCell2.UpDownAlign = LeftRightAlignment.Left
        'The thousand separator ',' will be inserted.
        numericUpDownCell2.ThousandsSeparator = True
        'Press the Up or Down key all the time, after 2 seconds, the value will increase 50 once, after 6 seconds, 300 increased once.
        numericUpDownCell2.Accelerations.AddRange(New NumericUpDownAcceleration() {New NumericUpDownAcceleration(2, 50), New NumericUpDownAcceleration(6, 300)})
        'If the value cannot be displayed completely, one ellipsis string will show in the middle.
        numericUpDownCell2.Ellipsis = MultiRowEllipsisMode.EllipsisPath
        numericUpDownCell2.EllipsisString = "..."

        Dim template1 As Template = Template.CreateGridTemplate(New Cell() {numericUpDownCell1, numericUpDownCell2})
        template1.ColumnHeaders(0).Cells(0).Value = "Column1"
        template1.ColumnHeaders(0).Cells(1).Value = "Column2"

        gcMultiRow1.Template = template1
        gcMultiRow1.RowCount = 10
    End Sub
    <STAThreadAttribute()> _
    Public Shared Sub Main()
        Application.EnableVisualStyles()
        Application.Run(New NumericUpDownCellDemo())
    End Sub
End Class

継承階層

System.Object
   System.MarshalByRefObject
      System.ComponentModel.Component
         GrapeCity.Win.MultiRow.Cell
            GrapeCity.Win.MultiRow.NumericUpDownCell

参照

NumericUpDownCell メンバ
 GrapeCity.Win.MultiRow 名前空間
 NumericUpDownEditingControl クラス
 Cell クラス