public class JScrollBar extends JComponent implements Adjustable, Accessible
通常、スクロールバー内でのノブの位置が変更されると、基になるビュー内での JViewPort の位置に対して変更が行われ、JViewPort のコンテンツが変更されます。
警告: Swing はスレッドに対して安全ではありません。詳細は、「Swing's Threading Policy」を参照してください。
警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の格納や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。1.4 以降、すべての JavaBeansTM 用の長期間の格納サポートが java.beans
パッケージに追加されています。XMLEncoder
を参照してください。
JScrollPane
修飾子と型 | クラスと説明 |
---|---|
protected class |
JScrollBar.AccessibleJScrollBar
このクラスは
JScrollBar クラスのアクセシビリティーサポートを実装しています。 |
JComponent.AccessibleJComponent
Container.AccessibleAWTContainer
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
修飾子と型 | フィールドと説明 |
---|---|
protected int |
blockIncrement |
protected BoundedRangeModel |
model
スクロールバーの最小値、最大値、長さ (可視量とも呼ぶ)、および現在値を表すモデルです。
|
protected int |
orientation |
protected int |
unitIncrement |
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
HORIZONTAL, NO_ORIENTATION, VERTICAL
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
コンストラクタと説明 |
---|
JScrollBar()
次の初期値を指定して垂直スクロールバーを作成します。
|
JScrollBar(int orientation)
方向と次の初期値を指定してスクロールバーを作成します。
|
JScrollBar(int orientation, int value, int extent, int min, int max)
方向、値、長さ、最小値、最大値を指定してスクロールバーを作成します。
|
修飾子と型 | メソッドと説明 |
---|---|
void |
addAdjustmentListener(AdjustmentListener l)
AdjustmentListener を追加します。
|
protected void |
fireAdjustmentValueChanged(int id, int type, int value)
スクロールバーのモデルが変更されたことをリスナーに通知します。
|
AccessibleContext |
getAccessibleContext()
この JScrollBar に関連付けられた AccessibleContext を取得します。
|
AdjustmentListener[] |
getAdjustmentListeners()
addAdjustmentListener() を使用してこの JScrollBar に追加されるすべての
AdjustmentListener の配列を返します。 |
int |
getBlockIncrement()
java.awt.Scrollbar との下位互換性のために提供されるメソッドです。
|
int |
getBlockIncrement(int direction)
ブロック (通常は「ページ」) アップ/ダウン要求に対応するスクロールバーの値を変更する量を返します。
|
int |
getMaximum()
スクロールバーの最大値は、最大値 - 長さになります。
|
Dimension |
getMaximumSize()
スクロールバーはスクロール軸に沿った方向では自由にサイズ変更できますが、もう一方の軸の方向のサイズは固定になります。
|
int |
getMinimum()
スクロールバーによってサポートされている最小値を返します (通常は 0)。
|
Dimension |
getMinimumSize()
スクロールバーはスクロール軸に沿った方向では自由にサイズ変更できますが、もう一方の軸の方向のサイズは固定になります。
|
BoundedRangeModel |
getModel()
最小値、最大値、値、長さという、スクロールバーの 4 つの基本プロパティーを処理するデータモデルを返します。
|
int |
getOrientation()
コンポーネントの方向 (水平または垂直) を返します。
|
ScrollBarUI |
getUI()
このコンポーネントの Look & Feel を実装する委譲オブジェクトを返します。
|
String |
getUIClassID()
このコンポーネントの LookAndFeel クラスの名前を返します。
|
int |
getUnitIncrement()
java.awt.Scrollbar との下位互換性のために提供されるメソッドです。
|
int |
getUnitIncrement(int direction)
ユニットアップ/ダウン要求に対応するスクロールバーの値を変更する量を返します。
|
int |
getValue()
スクロールバーの値を返します。
|
boolean |
getValueIsAdjusting()
スクロールバーのノブがドラッグされている場合に true を返します。
|
int |
getVisibleAmount()
スクロールバーの長さ、つまり「visibleAmount」を返します。
|
protected String |
paramString()
この JScrollBar の文字列表現を返します。
|
void |
removeAdjustmentListener(AdjustmentListener l)
AdjustmentEvent リスナーを削除します。
|
void |
setBlockIncrement(int blockIncrement)
blockIncrement プロパティーを設定します。
|
void |
setEnabled(boolean x)
コンポーネントを使用可能にして、ノブの位置が変更できるようにします。
|
void |
setMaximum(int maximum)
モデルの最大値プロパティーを設定します。
|
void |
setMinimum(int minimum)
モデルの最小値プロパティーを設定します。
|
void |
setModel(BoundedRangeModel newModel)
最小値、最大値、値、長さという、スクロールバーの 4 つの基本プロパティーを処理するデータモデルを設定します。
|
void |
setOrientation(int orientation)
スクロールバーの方向を水平または垂直に設定します。
|
void |
setUI(ScrollBarUI ui)
このコンポーネントをレンダリングする L&F オブジェクトを設定します。
|
void |
setUnitIncrement(int unitIncrement)
unitIncrement プロパティーを設定します。
|
void |
setValue(int value)
スクロールバーの値を設定します。
|
void |
setValueIsAdjusting(boolean b)
モデルの valueIsAdjusting プロパティーを設定します。
|
void |
setValues(int newValue, int newExtent, int newMin, int newMax)
引数が次の通常の制約に従うように強制したあとで、4 つの BoundedRangeModel プロパティーを設定します。
|
void |
setVisibleAmount(int extent)
モデルの長さプロパティーを設定します。
|
void |
updateUI()
JComponent.updateUI をオーバーライドします。 |
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
protected BoundedRangeModel model
protected int orientation
setOrientation(int)
protected int unitIncrement
protected int blockIncrement
public JScrollBar(int orientation, int value, int extent, int min, int max)
注:setBlockIncrement
を使うと、「ブロック」増分値をビューの長さより少し小さいサイズに設定できます。その場合、ユーザーがノブを隣の位置に移動すると、元のコンテンツの 1 行または 2 行がビューに残ります。
IllegalArgumentException
- 方向が VERTICAL、HORIZONTAL のどちらでもない場合setOrientation(int)
, setValue(int)
, setVisibleAmount(int)
, setMinimum(int)
, setMaximum(int)
public JScrollBar(int orientation)
minimum = 0 maximum = 100 value = 0 extent = 10
public JScrollBar()
minimum = 0 maximum = 100 value = 0 extent = 10
public void setUI(ScrollBarUI ui)
ui
- ScrollBarUI
L&F オブジェクトUIDefaults.getUI(javax.swing.JComponent)
public ScrollBarUI getUI()
public void updateUI()
JComponent.updateUI
をオーバーライドします。updateUI
、クラス: JComponent
JComponent.updateUI()
public String getUIClassID()
getUIClassID
、クラス: JComponent
JComponent.getUIClassID()
, UIDefaults.getUI(javax.swing.JComponent)
public int getOrientation()
getOrientation
、インタフェース: Adjustable
setOrientation(int)
, Adjustable.getOrientation()
public void setOrientation(int orientation)
IllegalArgumentException
- 方向が VERTICAL、HORIZONTAL のどちらでもない場合getOrientation()
public BoundedRangeModel getModel()
public void setModel(BoundedRangeModel newModel)
getModel()
public int getUnitIncrement(int direction)
JScrollPane コンポーネントは、このメソッドをオーバーライドし、ビューポートの Scrollable ビューがあればそれに委譲するスクロールバーを作成します (デフォルト)。Scrollable インタフェースは、このメソッドのより特殊なバージョンを提供します。
direction
- アップの場合は -1、ダウンの場合は 1setUnitIncrement(int)
, setValue(int)
, Scrollable.getScrollableUnitIncrement(java.awt.Rectangle, int, int)
public void setUnitIncrement(int unitIncrement)
この引数が Integer.MIN_VALUE の値と等しい場合、ほとんどの Look & Feel では右または下へのスクロールはできません。
setUnitIncrement
、インタフェース: Adjustable
unitIncrement
- ユニット増分値getUnitIncrement(int)
public int getBlockIncrement(int direction)
JScrollPane コンポーネントは、このメソッドをオーバーライドし、ビューポートの Scrollable ビューがあればそれに委譲するスクロールバーを作成します (デフォルト)。Scrollable インタフェースは、このメソッドのより特殊なバージョンを提供します。
direction
- アップの場合は -1、ダウンの場合は 1setBlockIncrement(int)
, setValue(int)
, Scrollable.getScrollableBlockIncrement(java.awt.Rectangle, int, int)
public void setBlockIncrement(int blockIncrement)
この引数が Integer.MIN_VALUE の値と等しい場合、ほとんどの Look & Feel では右または下へのスクロールはできません。
setBlockIncrement
、インタフェース: Adjustable
blockIncrement
- ブロック増分値getBlockIncrement()
public int getUnitIncrement()
getUnitIncrement
、インタフェース: Adjustable
Adjustable.getUnitIncrement()
, getUnitIncrement(int)
public int getBlockIncrement()
getBlockIncrement
、インタフェース: Adjustable
Adjustable.getBlockIncrement()
, getBlockIncrement(int)
public int getValue()
getValue
、インタフェース: Adjustable
setValue(int)
public void setValue(int value)
setValue
、インタフェース: Adjustable
value
- 現在の値。範囲は minimum
から maximum
- visibleAmount
までgetValue()
, BoundedRangeModel.setValue(int)
public int getVisibleAmount()
getVisibleAmount
、インタフェース: Adjustable
setVisibleAmount(int)
public void setVisibleAmount(int extent)
setVisibleAmount
、インタフェース: Adjustable
extent
- インジケータの長さgetVisibleAmount()
, BoundedRangeModel.setExtent(int)
public int getMinimum()
getMinimum
、インタフェース: Adjustable
setMinimum(int)
public void setMinimum(int minimum)
setMinimum
、インタフェース: Adjustable
minimum
- 最小値getMinimum()
, BoundedRangeModel.setMinimum(int)
public int getMaximum()
getMaximum
、インタフェース: Adjustable
setMaximum(int)
public void setMaximum(int maximum)
setMaximum
、インタフェース: Adjustable
maximum
- 最大値getMaximum()
, BoundedRangeModel.setMaximum(int)
public boolean getValueIsAdjusting()
setValueIsAdjusting(boolean)
public void setValueIsAdjusting(boolean b)
public void setValues(int newValue, int newExtent, int newMin, int newMax)
minimum <= value <= value+extent <= maximum
public void addAdjustmentListener(AdjustmentListener l)
AdjustmentEvent 型のプロパティーは、常に AdjustmentEvent.TRACK のプレースホルダ値を持ちます。BoundedRangeModel の値を変更するには、値プロパティー、つまり model.setValue(123) を設定するだけです。たとえばブロックデクリメントであるなど、変更の原因についての情報は提供されません。ここで変更の原因を作り出すこともしません。
addAdjustmentListener
、インタフェース: Adjustable
l
- 追加する AdjustmentListenerremoveAdjustmentListener(java.awt.event.AdjustmentListener)
, BoundedRangeModel.addChangeListener(javax.swing.event.ChangeListener)
public void removeAdjustmentListener(AdjustmentListener l)
removeAdjustmentListener
、インタフェース: Adjustable
l
- 削除する AdjustmentListeneraddAdjustmentListener(java.awt.event.AdjustmentListener)
public AdjustmentListener[] getAdjustmentListeners()
AdjustmentListener
の配列を返します。AdjustmentListener
。リスナーが追加されていない場合は空の配列protected void fireAdjustmentValueChanged(int id, int type, int value)
public Dimension getMinimumSize()
getMinimumSize
、クラス: JComponent
minimumSize
プロパティーの値JComponent.setMinimumSize(java.awt.Dimension)
, ComponentUI
public Dimension getMaximumSize()
getMaximumSize
、クラス: JComponent
maximumSize
プロパティーの値JComponent.setMaximumSize(java.awt.Dimension)
, ComponentUI
public void setEnabled(boolean x)
setEnabled
、クラス: JComponent
x
- boolean 値。true の場合はコンポーネントは使用可能で、false の場合は使用不可Component.isEnabled()
, Component.isLightweight()
protected String paramString()
null
にはなりません。paramString
、クラス: JComponent
public AccessibleContext getAccessibleContext()
getAccessibleContext
、インタフェース: Accessible
getAccessibleContext
、クラス: JComponent
バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.