public class JScrollBar extends JComponent implements Adjustable, Accessible
通常、スクロール・バー内でのノブの位置が変更されると、基になるビュー内でのJViewPortの位置に対して変更が行われ、JViewPortのコンテンツが変更されます。
警告: Swingはスレッドに対して安全ではありません。 詳細は、「Swing's Threading Policy」を参照してください。
警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。 現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。 1.4以降、すべてのJavaBeans™用の長期間の格納サポートがjava.beansパッケージに追加されています。 XMLEncoderを参照してください。
JScrollPane| 修飾子と型 | クラス | 説明 |
|---|---|---|
protected class |
JScrollBar.AccessibleJScrollBar |
このクラスは
JScrollBarクラスのアクセシビリティ・サポートを実装しています。 |
JComponent.AccessibleJComponentContainer.AccessibleAWTContainerComponent.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_WINDOWaccessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTHORIZONTAL, NO_ORIENTATION, VERTICALABORT, 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() |
このコンポーネントのルック・アンド・フィールを実装する委譲オブジェクトを返します。
|
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, updateadd, 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, validateTreeaction, 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, transferFocusUpCycleprotected 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、クラスJComponentJComponent.updateUI()public String getUIClassID()
getUIClassID、クラスJComponentJComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)public int getOrientation()
getOrientation、インタフェースAdjustablesetOrientation(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の値と等しい場合、ほとんどのルック・アンド・フィールでは右または下へのスクロールはできません。
ルック・アンド・フィールによっては、独自のスクロール動作が実装されています。その場合、このプロパティは無視されます。
setUnitIncrement、インタフェースAdjustableunitIncrement - ユニット増分値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の値と等しい場合、ほとんどのルック・アンド・フィールでは右または下へのスクロールはできません。
ルック・アンド・フィールによっては、独自のスクロール動作が実装されています。その場合、このプロパティは無視されます。
setBlockIncrement、インタフェースAdjustableblockIncrement - ブロック増分値getBlockIncrement()public int getUnitIncrement()
getUnitIncrement、インタフェースAdjustableAdjustable.getUnitIncrement(), getUnitIncrement(int)public int getBlockIncrement()
getBlockIncrement、インタフェースAdjustableAdjustable.getBlockIncrement(), getBlockIncrement(int)public int getValue()
getValue、インタフェースAdjustablesetValue(int)public void setValue(int value)
setValue、インタフェースAdjustablevalue - 現在の値。範囲はminimumからmaximum - visibleAmountまでgetValue(), BoundedRangeModel.setValue(int)public int getVisibleAmount()
getVisibleAmount、インタフェースAdjustablesetVisibleAmount(int)public void setVisibleAmount(int extent)
setVisibleAmount、インタフェースAdjustableextent - インジケータの長さgetVisibleAmount(), BoundedRangeModel.setExtent(int)public int getMinimum()
getMinimum、インタフェースAdjustablesetMinimum(int)public void setMinimum(int minimum)
setMinimum、インタフェースAdjustableminimum - 最小値getMinimum(), BoundedRangeModel.setMinimum(int)public int getMaximum()
getMaximum、インタフェースAdjustablesetMaximum(int)public void setMaximum(int maximum)
setMaximum、インタフェースAdjustablemaximum - 最大値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、インタフェースAdjustablel - 追加するAdjustmentListenerremoveAdjustmentListener(java.awt.event.AdjustmentListener), BoundedRangeModel.addChangeListener(javax.swing.event.ChangeListener)public void removeAdjustmentListener(AdjustmentListener l)
removeAdjustmentListener、インタフェースAdjustablel - 削除するAdjustmentListeneraddAdjustmentListener(java.awt.event.AdjustmentListener)public AdjustmentListener[] getAdjustmentListeners()
AdjustmentListenerの配列を返します。AdjustmentListener。リスナーが追加されていない場合は空の配列protected void fireAdjustmentValueChanged(int id,
int type,
int value)
public Dimension getMinimumSize()
getMinimumSize、クラスJComponentminimumSizeプロパティの値JComponent.setMinimumSize(java.awt.Dimension), ComponentUIpublic Dimension getMaximumSize()
getMaximumSize、クラスJComponentmaximumSizeプロパティの値JComponent.setMaximumSize(java.awt.Dimension), ComponentUIpublic void setEnabled(boolean x)
setEnabled、クラスJComponentx - boolean値。trueの場合はコンポーネントは使用可能で、falseの場合は使用不可Component.isEnabled(), Component.isLightweight()protected String paramString()
nullにはなりません。 paramString、クラスJComponentpublic AccessibleContext getAccessibleContext()
getAccessibleContext、インタフェースAccessiblegetAccessibleContext、クラスComponent バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。