Slider  - AS3 Flex

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。

関連する API エレメント

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

例えば、この配列に 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。

Slider からサムに渡すスタイルのセットです。

関連する API エレメント

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

たとえば、tickInterval が 1 で、maximum が 10 の場合、目盛りには 1/10 間隔で目盛りが表示されます。 値 0 では、目盛りは表示されません。 tickValues プロパティが空ではない配列に設定されている場合、このプロパティは無視されます。

デフォルト値： 0。

スライダー上の目盛り位置です。 この位置はスライダー上の値に対応しているため、minimum 値と maximum 値との間にあります。 たとえば、tickValues プロパティが [0, 2.5, 7.5, 10] で、maximum が 10 の場合、目盛りはスライダーに沿って、スライダーの先頭、左から 1/4 の位置、左から 3/4 の位置、およびスライダーの終点に置かれます。

このプロパティが空ではない配列に設定されている場合、tickInterval プロパティは無視されます。

デフォルト値： undefined。

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

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 valueCommit イベントが送出されます。

thumbCount が 1 より大きい場合に、各サムの値を格納する配列です。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 change イベントが送出されます。

コンストラクターです。

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

パラメーター

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

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

パラメーター

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

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

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

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

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

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

パラメーター

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

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

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

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

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

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

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

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

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