WinDateTimeEditor、WinCurrencyEditor、WinMaskedEdit および WinNumericEditor に特定の入力を実行すると現在の値をインクリメントする機能があります。この動作をトリガーする方法は 3 つあります。
上下の矢印キーを押します。
スピン ボタンをクリックします。
PerformAction() を使用して、コントロールに対して UpKeyAction
または DownKeyAction
が実行されます。
スピン動作がトリガーされると、現在カーソルが置かれているセクションは、トリガーに使用された矢印に応じて上下にインクリメントされます。WinDateTimeEditor
の場合、このセクションは年、月、または日です。WinCurrencyEditor
および WinNumericEditor
の場合、整数セクション、または小数セクションがインクリメントされます。
SpinIncrement が設定されている場合、カーソル位置が無視され、SpinIncrement
の設定により値が増減します。
セクションがインクリメントで最大値に達する、またはデクリメントで最小値に達すると、次の増減の動作は SpinWrapBehavior プロパティで定義されます。以下に設定できます。
Default
- デフォルトでは、コントロールは WrapAcrossSections
の動作に従います。
NoWrapping
- 値は、最大/最小値で増減を停止します。
WrapAcrossSections
- 値は最小値/最大値に達し、次に高いセクションが増減されます。
たとえば、12 の値がある月セクションをスピンアップすると、月は 1 になり、年セクションは 1 で増加します。
WrapCurrentSection
- 値は最小値/最大値に達するが、他のセクションは影響を受けません。
たとえば、12 の値がある月セクションをスピンアップすると、月は 1 になりますが、年セクションは変わりません。