JavaTM Platform
Standard Ed. 6

javax.swing
クラス JViewport

java.lang.Object
  上位を拡張 java.awt.Component
      上位を拡張 java.awt.Container
          上位を拡張 javax.swing.JComponent
              上位を拡張 javax.swing.JViewport
すべての実装されたインタフェース:
ImageObserver, MenuContainer, Serializable, Accessible

public class JViewport
extends JComponent
implements Accessible

基本となる情報を見るために使用する「ビューポート (窓)」です。スクロールするときに移動するのがビューポートです。これは、カメラのファインダーを覗くことに似ています。ファインダーを上に向かって動かすと、新しいものが視野の一番上に入り、一番下にあったものが視野から消えます。

デフォルトでは、JViewport は不透明です。これを変更する場合は、setOpaque メソッドを使用します。

注: 描画する際にバッファーを必要としない高速スクロールアルゴリズムを実装しました。アルゴリズムの機能は次のとおりです。

  1. ビューと親のビューをみて、JComponents かどうかを調べる。そうでない場合は中止して、ビューポート全体をペイントし直す
  2. ビューポートがほかの上位クラスによって隠されている場合は、中止してビューポート全体をペイントし直す
  3. 表示可能になる領域を計算する。ビューポートとサイズが同じ場合は、中止して領域全体をペイントし直す
  4. 上位クラスの Window グラフィックスを取得して、スクロールした領域の copyArea をペイントし直す
  5. ビューに新しく表示された領域をペイントし直すようメッセージを送る
  6. 次にビューポートにペイントが呼び出されたときに、クリッピング領域がビューポートサイズより小さい場合には、タイマーが開始され全体をペイントし直す
通常、この方法のほうが格段に速くできます。バッキングストア法と比較すると、この方法はオフスクリーンバッファーを維持するオーバーヘッドと copyArea を 2 回実行することを避けることができます。 バッキングストア以外の場合と比較すると、ペイント領域を大幅に削減できます。

この方法は、ビューポートがほかのウィンドウで隠されたり、部分的にオフスクリーンとなると、バッキングストア法よりも速度が遅くなります。ほかのウィンドウでビューポートが隠されると、copyArea はガベージをコピーしシステムがペイントイベントを生成して、新たに出現した領域をペイントする必要があることを知らせます。これを処理する唯一の方法は、ビューポート全体をペイントし直すことです。 ただし、バッキングストアの場合に比較してパフォーマンスが低下することがあります。非常にまれではありますが、ビューポートがほかのウィンドウで隠されているときにユーザーがスクロールすることがあるため、ほとんどのアプリケーションでこの最適化機能は、ビューポートが隠された場合に有効となります。

警告: Swing はスレッドに対して安全ではありません。詳細は、「Swing's Threading Policy」を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK Version 1.4 以降、すべての JavaBeans の長期間の運用サポートは、java.beans パッケージに追加されています。詳細は、XMLEncoder を参照してください。

関連項目:
JScrollPane

入れ子のクラスの概要
protected  class JViewport.AccessibleJViewport
          このクラスは JViewport クラス用のアクセシビリティーサポートを実装しています。
protected  class JViewport.ViewListener
          ビューのリスナーです。
 
クラス javax.swing.JComponent から継承された入れ子のクラス/インタフェース
JComponent.AccessibleJComponent
 
クラス java.awt.Container から継承された入れ子のクラス/インタフェース
Container.AccessibleAWTContainer
 
クラス java.awt.Component から継承された入れ子のクラス/インタフェース
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
フィールドの概要
protected  boolean backingStore
          推奨されていません。 Java 2 プラットフォーム v1.3 以降
static int BACKINGSTORE_SCROLL_MODE
          ビューポートのコンテンツをオフスクリーンイメージに描画します。
protected  Image backingStoreImage
          バッキングストアに使用されるビューイメージです。
static int BLIT_SCROLL_MODE
          graphics.copyArea() を使用してスクロールを実装します。
protected  boolean isViewSizeSet
          ビューポートの寸法が決められている場合に true を返します。
protected  Point lastPaintPosition
          最後にペイントされた viewPosition です。
protected  boolean scrollUnderway
          scrollUnderway フラグは、JList などのコンポーネントで使用されます。
static int SIMPLE_SCROLL_MODE
          このモードはスクロール区画をスクロールするたびに全コンテンツを再描画するという非常に簡単なメソッドを使用します。
 
クラス javax.swing.JComponent から継承されたフィールド
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
 
クラス java.awt.Component から継承されたフィールド
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
インタフェース java.awt.image.ImageObserver から継承されたフィールド
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
コンストラクタの概要
JViewport()
          JViewport を生成します。
 
メソッドの概要
 void addChangeListener(ChangeListener l)
          ビューのサイズ、位置、またはビューポートの長さが変更されるたびに通知されるリストに ChangeListener を追加します。
protected  void addImpl(Component child, Object constraints, int index)
          JViewport の 1 つの軽量な子を設定します。
protected  boolean computeBlit(int dx, int dy, Point blitFrom, Point blitTo, Dimension blitSize, Rectangle blitPaint)
          Blit のパラメータを計算します。
protected  LayoutManager createLayoutManager()
          サブクラサがこのメソッドをオーバーライドすると、コンストラクタで別のレイアウトマネージャー (または null) をインストールできます。
protected  JViewport.ViewListener createViewListener()
          ビューのリスナーを生成します。
protected  void firePropertyChange(String propertyName, Object oldValue, Object newValue)
          リスナーにプロパティーの変更を通知します。
protected  void fireStateChanged()
          ビューのサイズ、位置、またはビューポートの長さが変更されると、すべての ChangeListeners に通知します。
 AccessibleContext getAccessibleContext()
          この JViewport に関連した AccessibleContext を返します。
 ChangeListener[] getChangeListeners()
          addChangeListener() によってこの JViewport に追加されたすべての ChangeListener の配列を返します。
 Dimension getExtentSize()
          ビューの可視部分のサイズをビューの座標で返します。
 Insets getInsets()
          JViewport ではボーダーがサポートされていないので、インセット (ボーダー) の寸法を (0,0,0,0) として返します。
 Insets getInsets(Insets insets)
          この JViewport のインセット値を格納する Insets オブジェクトを返します。
 int getScrollMode()
          現在のスクロールモードを返します。
 ViewportUI getUI()
          このコンポーネントを描画する L&F オブジェクトを返します。
 String getUIClassID()
          このコンポーネントを描画する L&F クラスの名前を文字列で返します。
 Component getView()
          JViewport の 1 つの子または null を返します。
 Point getViewPosition()
          ビューポートの左上隅に表示されるビューの座標を返します。
 Rectangle getViewRect()
          起点が getViewPosition、サイズが getExtentSize である矩形を返します。
 Dimension getViewSize()
          ビューのサイズが明示的に設定されていない場合は、適切なサイズを返します。
 boolean isBackingStoreEnabled()
          推奨されていません。 Java 2 プラットフォーム 1.3 以降、getScrollMode() に置き換えられました。
 boolean isOptimizedDrawingEnabled()
          JViewport は (JComponent で) このメソッドのデフォルト実装をオーバーライドし、false を返します。
 void paint(Graphics g)
          backingStore が使用可能かどうかに応じて、バッキングストアを介してイメージをペイントするか、または現在表示されている部分だけをペイントし、バッキングストアを使用して残りの部分を「Blit」します。
protected  String paramString()
          この JViewport の文字列表現を返します。
 void remove(Component child)
          Viewport の 1 つの軽量な子を削除します。
 void removeChangeListener(ChangeListener l)
          ビューのサイズ、位置、またはビューポートの長さが変更されるたびに通知されるリストから ChangeListener を削除します。
 void repaint(long tm, int x, int y, int w, int h)
          RepaintManager によって paint が 1 回だけ実行されるように、常に親の座標系で再ペイントします。
 void reshape(int x, int y, int w, int h)
          このビューポートの境界を設定します。
 void scrollRectToVisible(Rectangle contentRect)
          ビュー内の Rectangle が可視になるようにビューをスクロールします。
 void setBackingStoreEnabled(boolean enabled)
          推奨されていません。 Java 2 プラットフォーム 1.3 以降、setScrollMode() に置き換えられました。
 void setBorder(Border border)
          ビューポートは、通常の親または子のクリッピングでその子 (「ビュー」と呼ばれる) を「スクロール」します。
 void setExtentSize(Dimension newExtent)
          ビューの座標を使用してビューの可視部分のサイズを設定します。
 void setScrollMode(int mode)
          ビューポートコンテンツのスクロールメソッドを制御するために使用します。
 void setUI(ViewportUI ui)
          このコンポーネントを描画する L&F オブジェクトを設定します。
 void setView(Component view)
          JViewport の 1 つの軽量な子 (view) を設定します。
 void setViewPosition(Point p)
          ビューポートの左上隅に表示されるビューの座標を設定します。
 void setViewSize(Dimension newSize)
          ビューのサイズを設定します。
 Dimension toViewCoordinates(Dimension size)
          ピクセル座標のサイズをビューの座標に変換します。
 Point toViewCoordinates(Point p)
          ピクセル座標のポイントをビューの座標に変換します。
 void updateUI()
          現在の Look & Feel からの値に UI プロパティーをリセットします。
 
クラス javax.swing.JComponent から継承されたメソッド
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, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, revalidate, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
 
クラス java.awt.Container から継承されたメソッド
add, add, add, add, add, addContainerListener, 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, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree
 
クラス java.awt.Component から継承されたメソッド
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, 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, hide, 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, transferFocusUpCycle
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

isViewSizeSet

protected boolean isViewSizeSet
ビューポートの寸法が決められている場合に true を返します。デフォルトは false です。


lastPaintPosition

protected Point lastPaintPosition
最後にペイントされた viewPosition です。バッキングストアイメージがどのくらい有効かを知ることができます。


backingStore

@Deprecated
protected boolean backingStore
推奨されていません。 Java 2 プラットフォーム v1.3 以降
このビューポートがその内容のオフスクリーンイメージを維持している場合に true を返します。 維持されている場合、表示を構築するためにビューオブジェクトにアクセスするのではなく、高速の「ビット Blit」処理を使用してスクロールを実行できます。デフォルト値は false です。

関連項目:
setScrollMode(int)

backingStoreImage

protected transient Image backingStoreImage
バッキングストアに使用されるビューイメージです。


scrollUnderway

protected boolean scrollUnderway
scrollUnderway フラグは、JList などのコンポーネントで使用されます。JList で下矢印キーが押され、選択されているセルがリストの最後のセルである場合、scrollpane はオートスクロールします。ここで、選択されていたセルはペイントし直す必要があるため、setViewPosition(Point) の明示的な呼び出しがある場合にだけ、ビューポートが最適化されたペイントをするためにフラグが必要になります。setBounds がほかのルートを介して呼び出される場合、フラグはオフになり、ビューは普通にペイントし直されます。これとは別に、JViewport クラスからこれを削除し、setBackingStoreEnabled を使用して JList にこの場合の制御をさせる方法もあります。デフォルト値は false です。


BLIT_SCROLL_MODE

public static final int BLIT_SCROLL_MODE
graphics.copyArea() を使用してスクロールを実装します。この方法がほとんどのアプリケーションにとってもっとも速い方法です。

導入されたバージョン:
1.3
関連項目:
setScrollMode(int), 定数フィールド値

BACKINGSTORE_SCROLL_MODE

public static final int BACKINGSTORE_SCROLL_MODE
ビューポートのコンテンツをオフスクリーンイメージに描画します。この方法は以前は、JTable のデフォルトでした。この方法は、場合によっては「Blit モード」には有用かもしれませんが、かなりの量の余分な RAM が必要となります。

導入されたバージョン:
1.3
関連項目:
setScrollMode(int), 定数フィールド値

SIMPLE_SCROLL_MODE

public static final int SIMPLE_SCROLL_MODE
このモードはスクロール区画をスクロールするたびに全コンテンツを再描画するという非常に簡単なメソッドを使用します。これは Swing 1.0 および Swing 1.1 のデフォルト動作でした。たいていの場合、ほかの 2 つのオプション (モード) はどちらも良いパフォーマンスを提供します。

導入されたバージョン:
1.3
関連項目:
setScrollMode(int), 定数フィールド値
コンストラクタの詳細

JViewport

public JViewport()
JViewport を生成します。

メソッドの詳細

getUI

public ViewportUI getUI()
このコンポーネントを描画する L&F オブジェクトを返します。

戻り値:
ViewportUI オブジェクト
導入されたバージョン:
1.3

setUI

public void setUI(ViewportUI ui)
このコンポーネントを描画する L&F オブジェクトを設定します。

パラメータ:
ui - ViewportUI L&F オブジェクト
導入されたバージョン:
1.3
関連項目:
UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()
現在の Look & Feel からの値に UI プロパティーをリセットします。

オーバーライド:
クラス JComponent 内の updateUI
関連項目:
JComponent.updateUI()

getUIClassID

public String getUIClassID()
このコンポーネントを描画する L&F クラスの名前を文字列で返します。

オーバーライド:
クラス JComponent 内の getUIClassID
戻り値:
文字列「ViewportUI」
関連項目:
JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

addImpl

protected void addImpl(Component child,
                       Object constraints,
                       int index)
JViewport の 1 つの軽量な子を設定します。 null も指定できます。ビューポート全体を占める子は 1 つだけなので、引数 constraints および index は無視されます。

オーバーライド:
クラス Container 内の addImpl
パラメータ:
child - ビューポートの軽量な child
constraints - 遵守されるべき constraints
index - インデックス
関連項目:
setView(java.awt.Component)

remove

public void remove(Component child)
Viewport の 1 つの軽量な子を削除します。

オーバーライド:
クラス Container 内の remove
パラメータ:
child - 削除されるコンポーネント
関連項目:
setView(java.awt.Component)

scrollRectToVisible

public void scrollRectToVisible(Rectangle contentRect)
ビュー内の Rectangle が可視になるようにビューをスクロールします。

このメソッドは、スクロールの前にビューを検証します。ビューが現在無効な場合、isValid が false を返します。包含関係の階層を作成しているときに過剰な検証を避けるため、このメソッドは、ピアを持たない上位クラスの有無、有効なルートクラスの有無、および Window または Applet のどちらかでない上位クラスの有無については検証しません。

このメソッドは、有効なビューポートの範囲外のスクロールは行いません。contentRect がビューポートより大きい場合、スクロールはビューポート境界の範囲内に限定されます。

オーバーライド:
クラス JComponent 内の scrollRectToVisible
パラメータ:
contentRect - 表示する Rectangle
関連項目:
JComponent.isValidateRoot(), Component.isValid(), Component.getPeer()

setBorder

public final void setBorder(Border border)
ビューポートは、通常の親または子のクリッピングでその子 (「ビュー」と呼ばれる) を「スクロール」します。 通常、ビューはスクロールとは反対の方向に移動します。null 以外のボーダー (または 0 以外のインセット) は、サポートされていません。 それは、サブクラス化を難しくするほどこのコンポーネントのジオメトリが複雑になるのを防ぐためです。ボーダー付きの JViewport を生成するには、ボーダーを持つ JPanel にそれを追加します。 

注:bordernull 以外の場合、このメソッドは境界が JViewPort ではサポートされていないため例外をスローします。

オーバーライド:
クラス JComponent 内の setBorder
パラメータ:
border - 設定する Border
例外:
IllegalArgumentException - このメソッドは実装されていない
関連項目:
Border, CompoundBorder

getInsets

public final Insets getInsets()
JViewport ではボーダーがサポートされていないので、インセット (ボーダー) の寸法を (0,0,0,0) として返します。

オーバーライド:
クラス JComponent 内の getInsets
戻り値:
大きさゼロ、原点ゼロの Rectange
関連項目:
setBorder(javax.swing.border.Border)

getInsets

public final Insets getInsets(Insets insets)
この JViewport のインセット値を格納する Insets オブジェクトを返します。渡された Insets オブジェクトは再び初期化され、このオブジェクト内のすべての既存の値は上書きされます。

オーバーライド:
クラス JComponent 内の getInsets
パラメータ:
insets - 再利用できる Insets オブジェクト
戻り値:
このビューポートのインセット値
関連項目:
getInsets()

isOptimizedDrawingEnabled

public boolean isOptimizedDrawingEnabled()
JViewport は (JComponent で) このメソッドのデフォルト実装をオーバーライドし、false を返します。その結果、描画装置は JViewport の子に直接メッセージを送るのではなく、Viewportpaint の実装を呼び出します。

オーバーライド:
クラス JComponent 内の isOptimizedDrawingEnabled
戻り値:
false

paint

public void paint(Graphics g)
backingStore が使用可能かどうかに応じて、バッキングストアを介してイメージをペイントするか、または現在表示されている部分だけをペイントし、バッキングストアを使用して残りの部分を「Blit」します。
「Blit」は、PDP-10 BLT (BLock Transfer) 命令のことであり、ビットのブロックをコピーします。

オーバーライド:
クラス JComponent 内の paint
パラメータ:
g - ペイントする Graphics コンテキスト
関連項目:
JComponent.paintComponent(java.awt.Graphics), JComponent.paintBorder(java.awt.Graphics), JComponent.paintChildren(java.awt.Graphics), JComponent.getComponentGraphics(java.awt.Graphics), JComponent.repaint(long, int, int, int, int)

reshape

public void reshape(int x,
                    int y,
                    int w,
                    int h)
このビューポートの境界を設定します。ビューポートの幅または高さが変更された場合は、StateChanged イベントをトリガーします。

オーバーライド:
クラス JComponent 内の reshape
パラメータ:
x - 起点の左端
y - 起点の上端
w - ピクセル単位の幅
h - ピクセル単位の高さ
関連項目:
JComponent.reshape(int, int, int, int)

setScrollMode

public void setScrollMode(int mode)
ビューポートコンテンツのスクロールメソッドを制御するために使用します。このモードを変更して最高のパフォーマンスを得ることをお勧めします。

パラメータ:
mode - 次の値のいずれか。
  • JViewport.BLIT_SCROLL_MODE
  • JViewport.BACKINGSTORE_SCROLL_MODE
  • JViewport.SIMPLE_SCROLL_MODE
導入されたバージョン:
1.3
関連項目:
BLIT_SCROLL_MODE, BACKINGSTORE_SCROLL_MODE, SIMPLE_SCROLL_MODE

getScrollMode

public int getScrollMode()
現在のスクロールモードを返します。

戻り値:
scrollMode プロパティー
導入されたバージョン:
1.3
関連項目:
setScrollMode(int)

isBackingStoreEnabled

@Deprecated
public boolean isBackingStoreEnabled()
推奨されていません。 Java 2 プラットフォーム 1.3 以降、getScrollMode() に置き換えられました。

このビューポートがその内容のオフスクリーンイメージを維持している場合に true を返します。

戻り値:
scrollModeBACKINGSTORE_SCROLL_MODE の場合は true

setBackingStoreEnabled

@Deprecated
public void setBackingStoreEnabled(boolean enabled)
推奨されていません。 Java 2 プラットフォーム 1.3 以降、setScrollMode() に置き換えられました。

true の場合、このビューポートはその内容のオフスクリーンイメージを維持します。このイメージは、viewPosition に対する一方向のわずかな変更に対するコストを削減するために使用されます。ビューポート全体をペイントし直すのではなく、Graphics.copyArea を使用してスクロールを実行します。

パラメータ:
enabled - true の場合、オフスクリーンバッキングストアを維持する

getView

public Component getView()
JViewport の 1 つの子または null を返します。

戻り値:
ビューポートの子。存在しない場合は null
関連項目:
setView(java.awt.Component)

setView

public void setView(Component view)
JViewport の 1 つの軽量な子 (view) を設定します。null も指定できます。

パラメータ:
view - ビューポートの新しい軽量な子
関連項目:
getView()

getViewSize

public Dimension getViewSize()
ビューのサイズが明示的に設定されていない場合は、適切なサイズを返します。 設定されている場合は、ビューの現在のサイズを返します。ビューがない場合は、0,0 を返します。

戻り値:
ビューのサイズを指定する Dimension オブジェクト

setViewSize

public void setViewSize(Dimension newSize)
ビューのサイズを設定します。状態変更イベントがトリガーされます。

パラメータ:
newSize - ビューの新しいサイズを指定する Dimension オブジェクト

getViewPosition

public Point getViewPosition()
ビューポートの左上隅に表示されるビューの座標を返します。ビューがない場合は 0,0 を返します。

戻り値:
左上の座標を示す Point オブジェクト

setViewPosition

public void setViewPosition(Point p)
ビューポートの左上隅に表示されるビューの座標を設定します。ビューがない場合は何も行いません。

パラメータ:
p - 左上の座標を示す Point オブジェクト

getViewRect

public Rectangle getViewRect()
起点が getViewPosition、サイズが getExtentSize である矩形を返します。これは、ビューの座標で示されたビューの可視部分です。

戻り値:
ビューの座標を使用してビューの可視部分を示す Rectangle

computeBlit

protected boolean computeBlit(int dx,
                              int dy,
                              Point blitFrom,
                              Point blitTo,
                              Dimension blitSize,
                              Rectangle blitPaint)
Blit のパラメータを計算します。 バッキングストアイメージは現在左上隅に oldLoc を保持していて、これから newLoc にスクロールします。パラメータは、Blit で要求される値を返すために変更されます。

パラメータ:
dx - 水平方向のデルタ
dy - 垂直方向のデルタ
blitFrom - Blit 元の Point
blitTo - Blit 先の Point
blitSize - Blit する領域の Dimension
blitPaint - Blit 先の領域
戻り値:
パラメータが変更され Blit の準備ができた場合は true、そうでない場合は false

getExtentSize

public Dimension getExtentSize()
ビューの可視部分のサイズをビューの座標で返します。

戻り値:
ビューのサイズを指定する Dimension オブジェクト

toViewCoordinates

public Dimension toViewCoordinates(Dimension size)
ピクセル座標のサイズをビューの座標に変換します。「論理座標」をサポートするビューポートのサブクラスは、このメソッドをオーバーライドします。

パラメータ:
size - ピクセル座標を使用する Dimension オブジェクト
戻り値:
ビューの座標に変換された Dimension オブジェクト

toViewCoordinates

public Point toViewCoordinates(Point p)
ピクセル座標のポイントをビューの座標に変換します。「論理座標」をサポートするビューポートのサブクラスは、このメソッドをオーバーライドします。

パラメータ:
p - ピクセル座標を使用する Point オブジェクト
戻り値:
ビューの座標に変換された Point オブジェクト

setExtentSize

public void setExtentSize(Dimension newExtent)
ビューの座標を使用してビューの可視部分のサイズを設定します。

パラメータ:
newExtent - ビューのサイズを指定する Dimension オブジェクト

createViewListener

protected JViewport.ViewListener createViewListener()
ビューのリスナーを生成します。

戻り値:
ViewListener

createLayoutManager

protected LayoutManager createLayoutManager()
サブクラサがこのメソッドをオーバーライドすると、コンストラクタで別のレイアウトマネージャー (または null) をインストールできます。JViewport でインストールする LayoutManager を返します。

戻り値:
LayoutManager

addChangeListener

public void addChangeListener(ChangeListener l)
ビューのサイズ、位置、またはビューポートの長さが変更されるたびに通知されるリストに ChangeListener を追加します。

パラメータ:
l - 追加する ChangeListener
関連項目:
removeChangeListener(javax.swing.event.ChangeListener), setViewPosition(java.awt.Point), setViewSize(java.awt.Dimension), setExtentSize(java.awt.Dimension)

removeChangeListener

public void removeChangeListener(ChangeListener l)
ビューのサイズ、位置、またはビューポートの長さが変更されるたびに通知されるリストから ChangeListener を削除します。

パラメータ:
l - 削除する ChangeListener
関連項目:
addChangeListener(javax.swing.event.ChangeListener)

getChangeListeners

public ChangeListener[] getChangeListeners()
addChangeListener() によってこの JViewport に追加されたすべての ChangeListener の配列を返します。

戻り値:
追加されたすべての ChangeListener。リスナーが追加されていない場合は空の配列
導入されたバージョン:
1.4

fireStateChanged

protected void fireStateChanged()
ビューのサイズ、位置、またはビューポートの長さが変更されると、すべての ChangeListeners に通知します。

関連項目:
addChangeListener(javax.swing.event.ChangeListener), removeChangeListener(javax.swing.event.ChangeListener), EventListenerList

repaint

public void repaint(long tm,
                    int x,
                    int y,
                    int w,
                    int h)
RepaintManager によって paint が 1 回だけ実行されるように、常に親の座標系で再ペイントします。

オーバーライド:
クラス JComponent 内の repaint
パラメータ:
tm - 更新までの最大時間 (ミリ秒)
x - x 座標 (左からのピクセル数)
y - y 座標 (上からのピクセル数)
w - 幅
h - 高さ
関連項目:
Component.update(java.awt.Graphics)

paramString

protected String paramString()
この JViewport の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。

オーバーライド:
クラス JComponent 内の paramString
戻り値:
この JViewport の文字列表現

firePropertyChange

protected void firePropertyChange(String propertyName,
                                  Object oldValue,
                                  Object newValue)
リスナーにプロパティーの変更を通知します。これをサブクラス化して windowBlit プロパティーを更新します。putClientProperty プロパティーは final です。

オーバーライド:
クラス Component 内の firePropertyChange
パラメータ:
propertyName - プロパティー名が格納されている文字列
oldValue - プロパティーの変更前の値
newValue - プロパティーの変更後の値

getAccessibleContext

public AccessibleContext getAccessibleContext()
この JViewport に関連した AccessibleContext を返します。ビューポートの場合、AccessibleContext は AccessibleJViewport の形式を取ります。必要に応じて新規の AccessibleJViewport インスタンスが作成されます。

定義:
インタフェース Accessible 内の getAccessibleContext
オーバーライド:
クラス JComponent 内の getAccessibleContext
戻り値:
この JViewport の AccessibleContext として 機能する AccessibleJViewport

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。