mx.controls
HScrollBar クラス


HScrollBar クラス
mx.controls.scrollClasses.ScrollBar の拡張HScrollBar (水平 ScrollBar) コントロールを使用すると、データが多すぎて表示領域に収まらない場合に、表示される部分のデータを制御できます。このコントロールは、基本の ScrollBar コントロールをラップしたものです。HScrollBar コントロールは、基本の ScrollBar コントロールを 90 度回転します。
HScrollBar コントロールは単独のコントロールとしても使用できますが、通常は他のコンポーネントと組み合わせ、スクロール機能を持つ別のコンポーネントの一部として使用します。
ScrollBar コントロールは、2 つの矢印ボタン、1 つのトラック、および 1 つのサムの 4 つの部分から構成されます。サムの位置とボタンの表示は、ScrollBar コントロールの現在の状態に依存します。ScrollBar コントロールでは、表示状態を計算するために次の 4 つのパラメータが使用されます。
- 範囲の最小値。
- 範囲の最大値。
- 現在の位置。これは常に、範囲の最小値と最大値の間の値となります。
- ビューポートサイズ。範囲全体のうち一度に表示できるアイテムの数を意味します。範囲全体と同じかそれ以下である必要があります。
MXML シンタックス
<mx:HScrollBar> タグは、HScrollBar コントロールを定義するために使用します。<mx:DataGridColumn> タグには、次のプロパティを使用できます。
<mx:HScrollBar
lineScrollSize="1"
pageScrollSize="No default."
repeatDelay="500"
repeatInterval="35"
scrollPosition="0"
scroll="Event handler; no default."
/>
例を参照するにはここをクリックしてください
関連項目
scrollClasses.ScrollBar
scroll | スクロールイベントのハンドラです。スクロールイベントは、ScrollBar コントロールの状態が変化したときにブロードキャストされます。このイベントオブジェクトの target プロパティには、イベントをトリガしたコンポーネントへの参照が含まれます。type プロパティには、イベントの名前である scroll が含まれます。
|
repeatDelay | 型 : Number 形式 : Time CSS の継承 : なし
最初の buttonDown イベントが発生してから、repeatInterval の間隔で buttonDown イベントが繰り返し発生し始めるまでの時間 (ミリ秒) です。デフォルト値は 500 です。 |
repeatInterval | 型 : Number CSS の継承 : なし
ユーザーがボタンを押し続けた場合に、buttonDown イベントを繰り返す間隔 (ミリ秒) です。デフォルト値は 35 です。 |
| HScrollBarExample.mxml |
<?xml version="1.0" encoding="utf-8"?>
<!-- HScrollBar コントロールの使用方法を示す簡単な例 -->
<mx:Application xmlns:mx="http://www.macromedia.com/2003/mxml" backgroundColor="#FFFFFF">
<mx:Script>
<![CDATA[
function myScroll(event)
{
showPosition.text = "HScrollBar properties summary:"+ '\n' +
"------------------------------------" + '\n' +
"A number that represents the current scroll position:" + event.scrollPosition + '\n' +
"Amount to scroll when an arrow button is pressed:" + event.lineScrollSize + '\n' +
"Amount to move the scroll when the scroll bar track is pressed:" + event.pageScrollSize + '\n' +
"A number which represents the maximum scroll position:" + event.maxPos + '\n' +
"A number which represents the minimum scroll position:" + event.minPos ;
}
]]>
</mx:Script>
<mx:Panel id="panel" title="Horizontal Scrollbar Panel" hScrollPolicy="off" vScrollPolicy="off" height="60%" width="80%">
<mx:HScrollBar id="bar" minPos="0" lineScrollSize="50" pageScrollSize="100" width="100%" maxPos="{panel.width - 20}"
scroll="myScroll(event.target);" repeatDelay="1000" repeatInterval="500" />
<mx:Label id="showPosition" text="click on scroll bar to view its properties." color="#0000FF" />
</mx:Panel>
</mx:Application>
|