バージョン

WebDateTimeEditor で値のリストをスピン

WebDateTimeEditor™ はスピン ボタンを使用して値のリストをスピンするオプションを提供します。 SpinButtonsDisplay プロパティを OnRight または OnLeft のいずれかに設定することによってスピン ボタンを表示できます。デフォルトでこのプロパティは None に設定されます。スピン ボタンには、エンドユーザーが次の値と前の値に移動できるように下側のボタンと上側のボタンの 2 つのボタンがあります。 LowerSpinButton プロパティと UpperSpinButton プロパティをそれぞれ設定することによって、下側のボタンと上側のボタンをカスタマイズできます。

Microsoft® Visual Studio® [プロパティ] ウィンドウを使用する、または以下のコードを使用することによって、SpinButtonsDisplay プロパティを設定できます:

Visual Basic の場合:

'スピン ボタンを右側に表示します
WebDateTimeEditor1.Buttons.SpinButtonsDisplay = Infragistics.Web.UI.EditorControls.ButtonDisplay.OnRight

C# の場合:

//スピン ボタンを右側に表示します
WebDateTimeEditor1.Buttons.SpinButtonsDisplay = Infragistics.Web.UI.EditorControls.ButtonDisplay.OnRight;

WebDateTimeEditor は、 SpinWrap プロパティを True に設定することによってリストの最初の値または最後の値に達したとしてもリストを継続してスピンすることも可能にします。

値をリストに追加および挿入

WebDateTimeEditor によって、 TextEditorButtons オブジェクトの ListOfValues プロパティを使用して繰り返したい値のリストを追加することができます。Microsoft® Visual Studio® [プロパティ] ウィンドウを使用して ListOfValues プロパティを設定できます:

Visual Basic の場合:

WebDateTimeEditor1.Buttons.ListOfValues = "2009-02-02-11-30-15-20|2009-03-03-12-30-15-20|2009-04-04-15-22-20-33|2009-05-05-18-23-20-35"

C# の場合:

WebDateTimeEditor1.Buttons.ListOfValues = "2009-02-02-11-30-15-20|2009-03-03-12-30-15-20|2009-04-04-15-22-20-33|2009-05-05-18-23-20-35";

注: リストの項目は ListOfValues プロパティを使用する時には "|" 文字によって分割する必要があります。値のリストの値の書式は "YYYY-MM-DD-HH-mm-ss-ms"(yyyy –年、MM-月、DD-日付、HH –時間、mm-分、ss-秒、ms – ミリ秒)の書式でなければなりません。

ただし、TextEditorButtons オブジェクトの InsertListValueAtIndex メソッドを使用して値をリストに挿入することもできます。

Visual Basic の場合:

'特定のインデックスでリストに値を挿入します
 WebDateTimeEditor1.Buttons.InsertListValueAtIndex(0, "2009-02-02-11-30-15-20")
 WebDateTimeEditor1.Buttons.InsertListValueAtIndex(1, "2009-03-03-12-30-15-20")
 WebDateTimeEditor1.Buttons.InsertListValueAtIndex(2, "2009-04-04-15-22-20-33")
 WebDateTimeEditor1.Buttons.InsertListValueAtIndex(3, "2009-05-05-18-23-20-35")

C# の場合:

//特定のインデックスでリストに値を挿入します
WebDateTimeEditor1.Buttons.InsertListValueAtIndex(0, "2009-02-02-11-30-15-20");
WebDateTimeEditor1.Buttons.InsertListValueAtIndex(1, "2009-03-03-12-30-15-20");
WebDateTimeEditor1.Buttons.InsertListValueAtIndex(2, "2009-04-04-15-22-20-33");
WebDateTimeEditor1.Buttons.InsertListValueAtIndex(3, "2009-05-05-18-23-20-35");

編集値の増分/減分

WebDateTimeEditor によってスピン ボタンを使用して編集値を増分/減分することも可能です。 SpinDelta プロパティを設定するだけで係数を増分/減分することができます。たとえば、SpinDelta プロパティを 10 に設定する場合、上側のボタンをクリックすると日付書式の場合には値が 10 日ずつ増え、時刻書式の場合には 10 分ずつ増えます。同様に、下側のボタンをクリックすると、日付書式の場合には値が 10 日ずつ減り、時刻書式の場合には 10 分ずつ減ります。

Microsoft® Visual Studio® [プロパティ] ウィンドウを使用する、または以下のコードを使用することによって、SpinDelta プロパティを設定できます:

Visual Basic の場合:

WebDateTimeEditor1.SpinDelta = 10

C# の場合:

WebDateTimeEditor1.SpinDelta = 10;

注: ListOfValues プロパティは SpinDelta プロパティよりも優先されます。