コンテンツをスクロールするためのスクロールアロー(矢印) を端に持ったボックスです。ユーザは矢印にマウスを重ねるだけでボックスをスクロールさせることができます。この要素は大きなポップアップメニューで一般的に使用されています。
(アクティブな) アロー上にマウスカーソルを合わせると scroll イベントの引き金になります。
詳しい情報は XUL チュートリアルにあります。
- 属性
- disabled, smoothscroll, tabindex
例
<arrowscrollbox orient="vertical" flex="1"> <button label="Red"/> <button label="Blue"/> <button label="Green"/> <button label="Yellow"/> <button label="Orange"/> <button label="Silver"/> <button label="Lavender"/> <button label="Gold"/> <button label="Turquoise"/> <button label="Peach"/> <button label="Maroon"/> <button label="Black"/> </arrowscrollbox>
属性
XUL 要素からの継承 |
-
disabled
- 型: 論理型
-
要素が無効化されているかどうかを示します。ある要素が
true
に設定されていたら、その要素は無効化されています。無効化された要素は通常グレイ表示のテキストで描画されます。要素が無効化されていると、ユーザのアクションには応答せず、フォーカスもあてられず、command
イベントも発生しません。
-
smoothscroll
- 型: 論理型
- 初期値の
true
の場合、対応する arrowscrollbox のスムーズスクロールを有効にします。false
の場合はそれを無効にします。現在のスムーズスクロールは垂直方向の arrowscrollbox のみをサポートしています。
-
tabindex
- 型: 整数型
- 要素のタブの順番。タブの順番は
tab
キーが押下されたときにフォーカスが移動する順番です。より大きなtabindex
の値をもつ要素は、タブの遷移が後になります。
プロパティ
-
scrollBoxObject
- 型: nsIScrollBoxObject
- scroll box オブジェクトは、list box のスクロール位置の変更や取得に使用される nsIScrollBoxObject インタフェースを実装します。
-
scrollIncrement
- 型: 整数型
-
arrowscrollbox
がクリックされた時に発生するスクロールのピクセル数を取得する、読み取り専用のプロパティ。
-
smoothScroll
- 型: 論理型
- 対応する arrowscrollbox のスムーズスクロールを有効または無効に設定します。明示的に設定されていないときは
smoothscroll
属性にフォールバックされ、次にtoolkit.scrollbox.smoothScroll
設定にフォールバックされます。現在のスムーズスクロールは垂直方向の arrowscrollbox のみをサポートしています。
メソッド
ensureElementIsVisible( element )
- 戻り値の型: 戻り値無し
- 指定した要素がユーザに見えていない場合は、表示されている項目がスクロールされ、見えるようになります。項目がすでに見える位置にある場合はスクロールされません。
-
scrollByIndex( lines )
- 戻り値の型: 戻り値なし
-
arrowscrollbox
のコンテンツを lines に与えられた行数だけスクロールします。一行は一つの要素です。多くの行数を先方にスクロールするには lines 引数に正の値を、後方にスクロールするには負の値を使用してください。
-
scrollByPixels( pixels )
- 戻り値の型: 戻り値なし
-
arrowscrollbox
のコンテンツを pixels に与えられたピクセル数だけスクロールします。多くのピクセル数を先方にスクロールするには pixels 引数に正の値を、後方にスクロールするには負の値を使用してください。
XUL 要素からの継承
blur
, click
, doCommand
, focus
, getElementsByAttribute
, getElementsByAttributeNS
DOM 要素からの継承
addEventListener()
, appendChild()
, compareDocumentPosition, dispatchEvent()
, getAttribute()
, getAttributeNode()
, getAttributeNodeNS()
, getAttributeNS()
, getElementsByTagName()
, getElementsByTagNameNS()
, getFeature, getUserData, hasAttribute()
, hasAttributeNS()
, hasAttributes()
, hasChildNodes()
, insertBefore()
, isEqualNode, isSameNode, isSupported()
, lookupNamespaceURI, lookupPrefix, normalize()
, removeAttribute()
, removeAttributeNode()
, removeAttributeNS()
, removeChild()
, removeEventListener()
, replaceChild()
, setAttribute()
, setAttributeNode()
, setAttributeNodeNS()
, setAttributeNS()
, setUserData
関連項目
TBD