xamSlider コントロールには、コントロールでエンドユーザーが値を区別する手助けとなる目盛があります。使用する目盛のタイプは、ユーザーが使用しているスライダーのタイプによって異なります。たとえば、xamNumericSlider または xamNumericRangeSlider の数値スライダーを使用している場合、 SliderTickMarks オブジェクトを使用する必要があります。一方、xamDateTimeSlider または xamDateTimeRangeSlider の DateTime スライダーを使用している場合、 DateTimeSliderTickMarks オブジェクトを使用する必要があります。2 タイプの目盛は交換可能ではありません。ただし、両方とも以下の一般的に使用されるプロパティを共有します:
前述したプロパティに加えて、DateTimeSliderTickMarks オブジェクトは、 FrequencyType 列挙値に設定できる FrequencyType プロパティも公開します。xamDateTimeSlider および xamDateTimeRangeSlider コントロールは、目盛を配列するために FrequencyType プロパティと組み合わせて TickMarksFrequency プロパティを使用します。TickMarksFrequency プロパティをスカラ値、FrequencyType プロパティを測定単位として考えることができます。たとえば、値が 1/1/2009 から 12/31/2009 の範囲で、TickMarksFrequency プロパティを 3 に設定する場合、3 日毎、3 カ月毎、3 年毎のいずれで目盛を表示すべきかを決定するために FrequencyType プロパティを設定する必要があります。
以下の例のコードは、目盛プロパティの追加と設定を示しています。
XAML の場合:
<StackPanel> <!--20 番目毎の間隔で目盛が付けられた単一値の数値スライダー--> <TextBlock Text=" Numeric single-value slider:" /> <ig:XamNumericSlider Name="xamNumericSlider1" MinValue="0" MaxValue="100"> <ig:XamNumericSlider .TickMarks> <ig:SliderTickMarks TickMarksFrequency="20" UseFrequency="True" /> </ig:XamNumericSlider .TickMarks> </ig:XamNumericSlider > <!--2 カ月毎で目盛が付けられた単一値 DateTime スライダー--> <TextBlock Text="DateTime single-value slider:" /> <ig:XamDateTimeSlider Name="xamDateTimeSlider1" MinValue="1/1/2009" MaxValue="12/31/2009"> <ig:XamDateTimeSlider.TickMarks> <ig:DateTimeSliderTickMarks TickMarksFrequency="2" FrequencyType="Months" UseFrequency="True" /> </ig:XamDateTimeSlider.TickMarks> </ig:XamDateTimeSlider> </StackPanel>
Visual Basic の場合:
Imports Infragistics.Controls.Interactions Imports Infragistics ... '単一値数値スライダー用の目盛 Dim numericTickMarks As New SliderTickMarks With {.TickMarksFrequency = 20, .UseFrequency = True} Me.xamNumericSlider1.TickMarks.Add(numericTickMarks) '単一値 DateTime スライダー用の目盛 Dim dateTickMarks As New DateTimeSliderTickMarks With {.TickMarksFrequency = 2, .FrequencyType = FrequencyType.Months, .UseFrequency = True} Me.xamDateTimeSlider1.TickMarks.Add(dateTickMarks) ...
C# の場合:
using Infragistics.Controls.Interactions; using Infragistics; ... //単一値数値スライダー用の目盛 SliderTickMarks numericTickMarks = new SliderTickMarks { TickMarksFrequency = 20, UseFrequency = true }; this.xamNumericSlider1.TickMarks.Add(numericTickMarks); //単一値 DateTime スライダー用の目盛 DateTimeSliderTickMarks dateTickMarks = new DateTimeSliderTickMarks { TickMarksFrequency = 2, FrequencyType = FrequencyType.Months, UseFrequency = true }; this.xamDateTimeSlider1.TickMarks.Add(dateTickMarks); ...