false に設定した場合、各サムは隣接するサムの端にのみ移動できます。true に設定した場合、各サムはトラック上の任意の位置に移動できます。

デフォルト値false.

トラックをクリックすることでスライダサムを移動させることができるかどうかを指定します。

デフォルト値true.

データヒントテキストの形式を設定するコールバック関数です。この関数は、単一の数値を引数として受け取り、形式を設定したストリングを返します。

この関数のシグネチャは次のとおりです。

funcName(value:Number):String
   

次の例では、データヒントテキストにドル記号の接頭辞を付け、'slide' という名前の Slider コントロールの dataTipPrecision を使用してテキストをフォーマットしています。

import mx.formatters.NumberBase;
function myDataTipFormatter(value:Number):String {
var dataFormatter:NumberBase = new NumberBase(".", ",", ".", "");
return   "$ " + dataFormatter.formatPrecision(String(value), slide.getStyle("dataTipPrecision"));
  }
   

デフォルト値undefined.

スライダコントロールの方向です。MXML での有効な値は "horizontal" または "vertical" です。

ActionScript では、次の定数を使用してこのプロパティを設定します。SliderDirection.VERTICAL および SliderDirection.HORIZONTAL です。

デフォルト値SliderDirection.HORIZONTAL.

関連項目

スライダのラベルに使用するストリングの配列です。まずラベルがトラックの始点に配置され、次に各ラベルがトラックの始点と終点の間を等間隔に配置されます。

たとえば、この配列に 3 つの項目がある場合、最初の項目がトラックの始点、2 番目の項目がトラックの中間点、3 番目の項目がトラックの終点にそれぞれ配置されます。

指定されているラベルが 1 つのみの場合、ラベルはトラックの始点に配置されます。デフォルトでは、ラベルの位置は、目盛りがある場合はその上、またはトラックの上になります。ラベルの位置を目盛りに揃える場合は、ラベルの数と目盛りの数が一致していることを確認してください。

デフォルト値undefined.

スライダのライブドラッグを有効にするかどうかを指定します。false の場合は、value プロパティと values プロパティが設定され、ユーザーがスライダサムのドラッグを停止したときに change イベントが送出されます。true の場合は、value プロパティと values プロパティが設定され、ユーザーがサムを移動しているときに change イベントが継続的に送出されます。

デフォルト値false.

スライダの最大値です。

デフォルト値10.

スライダコントロールの最小値です。

デフォルト値0.

true に設定されている場合、ユーザーが操作している間、スライダの現在の値を含むデータヒントを表示します。

デフォルト値true.

データヒントで使用するクラスへの参照です。

デフォルト値SliderDataTip.

各サムに使用するクラスへの参照です。

デフォルト値SliderThumb.

ユーザーがスライダサムを移動したときの増分値を指定します。たとえば、snapInterval の値を 2、minimum の値を 0、maximum の値を 10 に設定した場合、ユーザーがサムを移動すると、サムは 0、2、4、6、8、10 の値に吸着されます。値 0 では、スライダは、minimum 値と maximum 値の間を継続的に移動します。

デフォルト値0.

スライダ上に配置できるサムの数です。有効な値は 1 または 2 です。1 に設定した場合、スライダの現在の値が value プロパティに格納されます。2 に設定した場合、各サムの値で構成される配列が values に格納されます。

デフォルト値1.

コントロールの最大値を基準にした、目盛りの間隔を表します。tickInterval プロパティを 0 以外の値に設定すると、目盛りが表示されます。

たとえば、tickInterval が 1 で、maximum が 10 の場合、目盛りには 1/10 間隔で目盛りが表示されます。値 0 では、目盛りは表示されません。

デフォルト値0.

サムの位置を格納します。これは、minimum パラメータと maximum パラメータの間の値です。thumbCount が 1 である場合、value プロパティを使用します。thumbCount が 1 より大きい場合は、代わりに values プロパティを使用します。デフォルト値は、minimum プロパティと等しい値です。

このプロパティはデータバインディングのソースとして使用できます。

thumbCount が 2 以上の場合に、各サムの値を格納する配列です。

このプロパティはデータバインディングのソースとして使用できます。

コンストラクタ。

指定のインデックス位置にあるサムオブジェクトを返します。スライダコントロールの個々のサムにスタイルを設定してカスタマイズするには、このメソッドを使用します。

コンポーネントが占有する領域を計算します。水平スライダコントロールの高さは、トラックに対するラベル、目盛り、およびサムの位置から計算します。このコントロールの高さは、最上位のエレメントの上部の位置と、最下位のエレメントの下部の位置との差に等しくなります。水平スライダコントロールの幅は、デフォルトで 250 ピクセルになっています。垂直スライダコントロールについては、上記の説明における幅と高さを入れ替えます。

このメソッドは、スライダサムの値を設定して表示を更新します。

コントロールのエレメントを配置します。このメソッドによって、トラック、サム、ラベル、および目盛りの位置とサイズがすべて決まります。トラックのサイズは、ラベルの長さとトラックマージンに基づいて設定されます。trackMargin を指定すると、トラックのサイズは、使用可能な幅から trackMargin を 2 倍した値を引いた数値になります。

目盛りは、トラックの始点からトラックに沿って等間隔に配置されます。トラックの終点に目盛りがない場合 (目盛りの間隔が最大値の整数倍でない場合)、終点にも目盛りが配置されます。目盛りの y 方向の位置は、tickOffset に基づきます。オフセットに 0 を指定すると、目盛りの下部がトラックの上部に配置されます。オフセットに負の数を指定すると目盛りはトラックを上方向に移動し、正の数を指定すると下方向に移動します。

ラベルは、トラックに沿って等間隔に配置されます。trackMargin の値が小さすぎない限り、ラベルは、必ずその配置間隔の上に水平方向で中心に配置されます。trackMargin を指定すると、最初のラベルはコントロールの左境界線、最後のラベルは右境界線に配置されます。ラベルが重なっていても、トリミングやサイズ変更されることはないため、トラックに収まるよう十分な領域を確保しておく必要があります。y 方向の位置は、labelOffset プロパティに基づきます。オフセットに 0 を指定すると、ラベルの下部がトラックの上部に配置されます。目盛りの場合と異なり、ラベルをトラックに重なるように配置することはできません。オフセットに正の数を指定すると、ラベルの上部がトラックの下部より下に配置されます。

サムは、トラックと重なるように配置されます。サムの x 方向の位置は、その値で決まります。y 方向の位置は thumbOffset プロパティで制御します。オフセットに 0 を指定すると、サムの中心とトラックの中心が一致するように配置されます。負の数のオフセットを指定するとサムは上方向に移動し、正の数を指定すると下方向に移動します。

目盛り、ラベル、およびサムの位置は、それぞれ個別に設定します。これらが重なり合った場合でも、位置は再調整されません。

垂直スライダコントロールに関しても同様です。垂直スライダコントロールの場合は、上記の説明における幅を高さに、高さを幅に、左を上方向または上部に、右を下方向または下部に、x 方向の位置を y 方向の位置に、y 方向の位置を x 方向の位置に置き換えます。

マウスまたはキーボードの操作によってスライダの値が変化した場合に送出されます。

liveDragging プロパティが true の場合、ユーザーがサムをドラッグしている間は、イベントが継続的に送出されます。liveDragging が false の場合、ユーザーがスライダサムを離したときに、イベントが送出されます。

SliderEvent.CHANGE 定数により、change イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

スライダのサムが押され、マウスによって移動されたときに送出されます。このイベントには、常に thumbPress イベントが先行します。

SliderEvent.THUMB_DRAG 定数により、thumbDrag イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

スライダサムが押されたとき、つまりユーザーがサムの上でマウスボタンを押したときに送出されます。

SliderEvent.THUMB_PRESS 定数により、thumbPress イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

スライダのサムが離されたとき、つまり thumbPress イベントの後ユーザーがマウスボタンを離したときに送出されます。

SliderEvent.THUMB_RELEASE 定数により、thumbRelease イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。