ユーザーに,特定の範囲の数値を入力させるには,NumericUpDownコントロールを使う。NumericUpDownコントロールは,数字以外のキー入力を受け付けない。数値を入力する場合には,様々な入力支援機能がある。入力支援の最も大きなものとして,GUI操作で数値を増加/減少できる。このときの増加分や,減少分については,Incrementプロパティで設定する。

 ボタンを押し続けたときに,増加分/減少分を増やして,数字の変化を加速することもできる。そのためには,Accelerationsプロパティを設定する。Accelerationsプロパティでは,何秒後にIncrementプロパティをいくつにするか,といった設定を,NumericUpDownAccelerationオブジェクトを使って行う。

 数値の入力可能範囲も設定できる。入力できる最大値はMaximumプロパティに,最小値はMinimumプロパティに設定する。さらに,マウスを使わずに,キーボードの上下キーを使って,数値を増加/減少させることもできる。そのためには,InterceptArrowKeysプロパティを設定する。また,読み出し専用にするためにはReadOnlyプロパティを設定する。これをFalseにすると,数値の表示領域に直接数字を書き込むこともできる。

 数値の表示形式は,DecimalPlacesプロパティやHexadecimalプロパティ,ThousandsSeparatorプロパティを使って変更できる。DecimalPlacesプロパティでは,小数点以下の表示けた数を指定する。小数点以下が0でも,常に指定した小数点以下のけた数が表示される。HexadecimalプロパティをTrueに設定すると16進数表示,Falseにすると10進数表示になる。ThousandsSeparatorプロパティをTrueに設定すると,自動的に数値が3けたごとにカンマで区切られて表示される。

図1
(図1)

サンプルコードを見る


名前空間
System.Windows.Forms
対応バージョン
.NET Framework 2.0,1.1,1.0
.NET Compact Framework 2.0,1.0
主なプロパティ
Accelerations
NumericUpDownコントロールのUPまたはDOWNボタンを押し続けたときに,数字の増加/減少を加速させる方法を指定する。

Anchor
NumericUpDownコントロールを貼り付けたフォームまたはパネルなど,親コントロールの大きさが変更されたときに,指定した方向に関してコンテナの端からNumericUpDownコントロールの端までの距離を一定に保つ。

BackColor
NumericUpDownコントロールの背景色。

BackgroundImage
NumericUpDownコントロールの背景に表示する画像。

BackgroundImageLayout
NumericUpDownコントロールの背景に表示する画像のレイアウト。

Bounds
クライアント以外の要素を含むNumericUpDownコントロールの,親コントロールに対する相対的なサイズおよび位置(ピクセル単位)。

DecimalPlaces
NumericUpDownコントロールに表示する小数部のけた数。

Dock
NumericUpDownコントロールを貼り付けたフォームまたはパネルなどの親コントロールの,どの辺にドッキングさせるのかを設定する。

Enabled
NumericUpDownコントロールを利用可能または利用不可能(グレー・アウト)にする。

Font
NumericUpDownコントロールに表示する文字列のフォント。

ForeColor
NumericUpDownコントロールに表示する文字列の色。

Height
NumericUpDownコントロールの高さ。。

Hexadecimal
アップダウンNumericUpDownコントロールに値を16進形式で表示するかどうかを示す。

Increment
上向きまたは下向きの矢印ボタンがクリックされたときの,NumericUpDownコントロールの増分または減分。

InterceptArrowKeys
ユーザーが↑キーおよび↓キーを使用して値を選択できるかどうかを示す。

Left
NumericUpDownコントロールの左端とコンテナのクライアント領域の左端の間の距離(ピクセル単位)を取得または設定する。

Location
コンテナの左上隅に対するNumericUpDownコントロールの左上隅の相対座標。

Maximum
NumericUpDownコントロールの最大値。

Minimum
NumericUpDownコントロールの最小値。

ReadOnly
読み取り専用かどうかを示す。

Text
NumericUpDownコントロールに表示する文字列

ThousandsSeparator
NumericUpDownコントロールにけた区切り記号を表示するかどうかを示す。

Top
NumericUpDownコントロールの上端とコンテナのクライアント領域の上端の距離(ピクセル単位)。

UpDownAlign
NumericUpDownコントロールの上向きの矢印ボタンと下向きの矢印ボタンの配置。

Value
NumericUpDownコントロールの数値

Visible
NumericUpDownコントロールを画面に表示するかどうかを示す。

Width
NumericUpDownコントロールの幅。

主なメソッド
DownButton
NumericUpDownコントロールの値を減らす。

Focus
NumericUpDownコントロールにフォーカスを設定する。

Hide
NumericUpDownコントロールをユーザーに対して非表示にする。

Show
NumericUpDownコントロールをユーザーに対して表示する。

UpButton
NumericUpDownの値を増やす。

主なイベント
TextChanged
値が変更された場合に発生する。