public class JScrollBar extends JComponent implements Adjustable, Accessible
通常、スクロール・バー内でのノブの位置が変更されると、基になるビュー内でのJViewPortの位置に対して変更が行われ、JViewPortのコンテンツが変更されます。
警告: Swingはスレッドに対して安全ではありません。詳細は、「Swing's Threading Policy」を参照してください。
警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。1.4以降、すべてのJavaBeans(tm)用の長期間の格納サポートが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 |
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
accessibleContext, 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
setUnitIncrement(int)
protected int blockIncrement
setBlockIncrement(int)
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インタフェースは、このメソッドのより特殊なバージョンを提供します。
Look & Feelによっては、独自のスクロール動作が実装されています。その場合、このプロパティは無視されます。
direction
- アップの場合は -1、ダウンの場合は1setUnitIncrement(int)
, setValue(int)
, Scrollable.getScrollableUnitIncrement(java.awt.Rectangle, int, int)
public void setUnitIncrement(int unitIncrement)
この引数がInteger.MIN_VALUEの値と等しい場合、ほとんどのLook & Feelでは右または下へのスクロールはできません。
Look & Feelによっては、独自のスクロール動作が実装されています。その場合、このプロパティは無視されます。
setUnitIncrement
、インタフェース: Adjustable
unitIncrement
- ユニット増分値getUnitIncrement(int)
public int getBlockIncrement(int direction)
JScrollPaneコンポーネントは、このメソッドをオーバーライドし、ビュー・ポートのScrollableビューがあればそれに委譲するスクロール・バーを作成します(デフォルト)。Scrollableインタフェースは、このメソッドのより特殊なバージョンを提供します。
Look & Feelによっては、独自のスクロール動作が実装されています。その場合、このプロパティは無視されます。
direction
- アップの場合は -1、ダウンの場合は1setBlockIncrement(int)
, setValue(int)
, Scrollable.getScrollableBlockIncrement(java.awt.Rectangle, int, int)
public void setBlockIncrement(int blockIncrement)
この引数がInteger.MIN_VALUEの値と等しい場合、ほとんどのLook & Feelでは右または下へのスクロールはできません。
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
、クラス: Component
バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.