- 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
メソッドを使用します。注:描画する際にバッファを必要としない高速スクロール・アルゴリズムを実装しました。 アルゴリズムの機能は次のとおりです。
- ビューと親ビューが、
JComponents
でない場合は、ビューと親ビューがチェックされて、ビューポート全体が停止および再描画されます。 - ビュー・ポートがほかの上位クラスによって隠されている場合は、中止してビュー・ポート全体をペイントし直す。
- 表示可能になる領域を計算する。ビュー・ポートとサイズが同じ場合は、中止して領域全体をペイントし直す。
- 上位クラスの
Window
グラフィックスを取得して、スクロールした領域のcopyArea
をペイントし直す。 - ビューに新しく表示された領域をペイントし直すようメッセージを送る。
- 次にビュー・ポートにペイントが呼び出されたときに、クリッピング領域がビューポート・サイズより小さい場合には、タイマーが開始され全体をペイントし直す。
copyArea
を2回実行することを避けることができます。 バッキング・ストア以外の場合と比較すると、ペイント領域を大幅に削減できます。この方法は、ビューポートが他のウィンドウで隠されるか、または部分的にオフスクリーンである場合、バッキング・ストア法よりも速度が遅くなります。 他のウィンドウでビューポートが隠されると、copyAreaがガベージをコピーし、システムがペイント・イベントを生成して、新たに出現した領域をペイントする必要があることを通知します。 これを処理する唯一の方法は、ビューポート全体をペイントしなおすことです。ただし、バッキング・ストアの場合に比べてパフォーマンスが低下することがあります。 ほとんどのアプリケーションでは、ごくまれに、ビューポートが他のウィンドウで隠されている、またはオフスクリーンであるときにユーザーがスクロールすることがあるため、この最適化機能はビューポートが隠された場合のパフォーマンス・ヒットとして多くの場合価値があります。
警告: Swingはスレッドに対して安全ではありません。 詳細は、「Swing's Threading Policy」を参照してください。
警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。 現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。 1.4以降、すべてのJavaBeans™用の長期間の格納サポートが
java.beans
パッケージに追加されています。XMLEncoder
を参照してください。- 導入されたバージョン:
- 1.2
- 関連項目:
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プラットフォーム1.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で宣言されたフィールド
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
-
クラス java.awt.Componentで宣言されたフィールド
accessibleContext, 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つの軽量な子を設定します。null
も指定できます。protected boolean
computeBlit(int dx, int dy, Point blitFrom, Point blitTo, Dimension blitSize, Rectangle blitPaint)
バッキング・ストア・イメージの左上隅に現在oldLoc
が含まれており、newLoc
にスクロールしている場合の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()
ビュー・ポートの左上隅に表示されるビューの座標を返します。ビューがない場合は0,0を返します。Rectangle
getViewRect()
始点がgetViewPosition
、サイズがgetExtentSize
である矩形を返します。Dimension
getViewSize()
ビューのサイズが明示的に設定されていない場合は、適切なサイズを返します。設定されている場合は、ビューの現在のサイズを返します。boolean
isBackingStoreEnabled()
非推奨。Java 2プラットフォームv1.3以降は、getScrollMode()
に置き換えられています。boolean
isOptimizedDrawingEnabled()
JViewport
は(JComponent
の)このメソッドのデフォルト実装をオーバーライドし、falseを返します。protected boolean
isPaintingOrigin()
スクロール・モードがBACKINGSTORE_SCROLL_MODE
で、JViewport
またはその上位オブジェクトからペイントが実行される場合は、trueを返します。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プラットフォームv1.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
)を設定します。null
も指定できます。void
setViewPosition(Point p)
ビュー・ポートの左上隅に表示されるビューの座標を設定します。ビューがない場合は何も行いません。void
setViewSize(Dimension newSize)
ビューのサイズを設定します。Dimension
toViewCoordinates(Dimension size)
ピクセル座標のサイズをビュー座標に変換します。Point
toViewCoordinates(Point p)
ピクセル座標の点をビューの座標に変換します。void
updateUI()
現在のルック・アンド・フィールからの値にUIプロパティをリセットします。-
クラス javax.swing.JComponentで宣言されたメソッド
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, 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, hide, 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, 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, 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, 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, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
-
-
-
フィールドの詳細
-
isViewSizeSet
protected boolean isViewSizeSet
ビュー・ポートの寸法が決められている場合にtrueを返します。 デフォルトはfalseです。
-
lastPaintPosition
protected Point lastPaintPosition
最後にペイントされたviewPosition
です。バッキング・ストア・イメージがどのくらい有効かを知ることができます。
-
backingStore
@Deprecated protected boolean backingStore
非推奨。Java 2プラットフォーム1.3以降使われていませんこのビューポートでその内容のオフスクリーン・イメージが維持されている場合に、trueを返します。維持されている場合は、表示を構築するためにビュー・オブジェクトにアクセスするのではなく、高速の「Bit 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)
、定数フィールド値
-
-
メソッドの詳細
-
getUI
public ViewportUI getUI()
このコンポーネントを描画するL&Fオブジェクトを返します。- オーバーライド:
- クラス
JComponent
のgetUI
- 戻り値:
ViewportUI
オブジェクト- 導入されたバージョン:
- 1.3
-
setUI
@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the Component\'s LookAndFeel.") public void setUI(ViewportUI ui)
このコンポーネントを描画するL&Fオブジェクトを設定します。- パラメータ:
ui
-ViewportUI
L&Fオブジェクト- 導入されたバージョン:
- 1.3
- 関連項目:
UIDefaults.getUI(javax.swing.JComponent)
-
updateUI
public void updateUI()
現在のルック・アンド・フィールからの値にUIプロパティをリセットします。- オーバーライド:
updateUI
、クラス:JComponent
- 関連項目:
JComponent.updateUI()
-
getUIClassID
public String getUIClassID()
このコンポーネントをレンダリングするL&Fクラスの名前を指定する文字列を返します。- オーバーライド:
getUIClassID
、クラス:JComponent
- 戻り値:
- 文字列「ViewportUI」
- 関連項目:
JComponent.getUIClassID()
,UIDefaults.getUI(javax.swing.JComponent)
-
addImpl
protected void addImpl(Component child, Object constraints, int index)
JViewport
の1つの軽量な子を設定します。null
も指定できます。 (ビューポート全体を占める子は1つのみなので、constraints
およびindex
引数は無視されます。)- オーバーライド:
addImpl
、クラス:Container
- パラメータ:
child
- ビュー・ポートの軽量なchild
constraints
- 遵守されるべきconstraints
index
- インデックス- 関連項目:
setView(java.awt.Component)
-
remove
public void remove(Component child)
Viewport
の1つの軽量な子を削除します。- オーバーライド:
remove
、クラス:Container
- パラメータ:
child
- 削除されるコンポーネント- 関連項目:
setView(java.awt.Component)
-
scrollRectToVisible
public void scrollRectToVisible(Rectangle contentRect)
ビュー内のRectangle
が可視になるようにビューをスクロールします。このメソッドは、スクロールの前にビューを検証します。ビューが現在無効な場合は、
isValid
がfalseを返します。 包含関係の階層を作成しているときに過剰な検証を避けるため、このメソッドは、ピアを持たない上位クラスの有無、有効なルート・クラスの有無、およびWindow
またはApplet
のどちらかでない上位クラスの有無については検証しません。このメソッドは、有効なビュー・ポートの範囲外のスクロールは行いません。
contentRect
がビュー・ポートより大きい場合、スクロールはビュー・ポート境界の範囲内に限定されます。- オーバーライド:
scrollRectToVisible
、クラス:JComponent
- パラメータ:
contentRect
- 表示するRectangle
- 関連項目:
JComponent.isValidateRoot()
,Component.isValid()
-
setBorder
public final void setBorder(Border border)
ビュー・ポートは、通常の親または子のクリッピングでその子(「ビュー」と呼ばれる)を「スクロール」します。通常、ビューはスクロールとは反対の方向に移動します。null
以外のボーダー(または0以外のインセット)は、サポートされていません。これは、このコンポーネントのジオメトリが、サブクラス化を難しくするほど複雑になるのを防ぐためです。 ボーダー付きのJViewport
を生成するには、ボーダーを持つJPanel
にそれを追加します。注:
border
がnull
以外の場合、ボーダーがJViewPort
ではサポートされていないためこのメソッドは例外をスローします。- オーバーライド:
setBorder
、クラス:JComponent
- パラメータ:
border
- 設定するBorder
- 例外:
IllegalArgumentException
- このメソッドは実装されていない- 関連項目:
Border
,CompoundBorder
-
getInsets
public final Insets getInsets()
JViewport
ではボーダーがサポートされていないため、イン・セット(ボーダー)の寸法を(0,0,0,0)として返します。- オーバーライド:
getInsets
、クラス:JComponent
- 戻り値:
- 大きさゼロ、原点ゼロの
Rectangle
- 関連項目:
setBorder(javax.swing.border.Border)
-
getInsets
@BeanProperty(expert=true) public final Insets getInsets(Insets insets)
このJViewport
のイン・セット値を含むInsets
オブジェクトを返します。 渡されたInsets
オブジェクトはふたたび初期化され、このオブジェクト内のすべての既存の値は上書きされます。- オーバーライド:
getInsets
、クラス:JComponent
- パラメータ:
insets
- 再利用できるInsets
オブジェクト- 戻り値:
- このビュー・ポートのイン・セット値
- 関連項目:
getInsets()
-
isOptimizedDrawingEnabled
public boolean isOptimizedDrawingEnabled()
JViewport
は(JComponent
の)このメソッドのデフォルト実装をオーバーライドし、falseを返します。 その結果、描画機構はJViewport
子に直接メッセージを送るのではなく、Viewport
のpaint
の実装を呼び出します。- オーバーライド:
isOptimizedDrawingEnabled
、クラス:JComponent
- 戻り値:
- false
-
isPaintingOrigin
protected boolean isPaintingOrigin()
スクロール・モードがBACKINGSTORE_SCROLL_MODE
で、JViewport
またはその上位オブジェクトからペイントが実行される場合は、trueを返します。 それ以外の場合はfalse
を返します。- オーバーライド:
isPaintingOrigin
、クラス:JComponent
- 戻り値:
- スクロール・モードが
BACKINGSTORE_SCROLL_MODE
の場合はtrue。 - 関連項目:
JComponent.isPaintingOrigin()
-
paint
public void paint(Graphics g)
backingStore
が使用可能かどうかに応じて、バッキング・ストアを介してイメージをペイントするか、または現在表示されている部分だけをペイントし、バッキング・ストアを使用して残りの部分を「Blit」します。「Blit」は、PDP-10 BLT (BLock Transfer)命令のことであり、ビットのブロックをコピーします。 (参考のため。)
- オーバーライド:
paint
、クラス:JComponent
- パラメータ:
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
イベントをトリガーします。- オーバーライド:
reshape
、クラス:JComponent
- パラメータ:
x
- 起点の左端y
- 起点の上端w
- ピクセル単位の幅h
- ピクセル単位の高さ- 関連項目:
JComponent.reshape(int, int, int, int)
-
setScrollMode
@BeanProperty(bound=false, enumerationValues={"JViewport.BLIT_SCROLL_MODE","JViewport.BACKINGSTORE_SCROLL_MODE","JViewport.SIMPLE_SCROLL_MODE"}, description="Method of moving contents for incremental scrolls.") 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プラットフォームv1.3以降は、getScrollMode()
に置き換えられています。このビュー・ポートがその内容のオフスクリーン・イメージを維持している場合にtrue
を返します。- 戻り値:
scrollMode
がBACKINGSTORE_SCROLL_MODE
の場合はtrue
-
setBackingStoreEnabled
@Deprecated public void setBackingStoreEnabled(boolean enabled)
非推奨。Java 2プラットフォームv1.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)
バッキング・ストア・イメージの左上隅に現在oldLoc
が含まれており、newLoc
にスクロールしている場合のBlitのパラメータを計算します。 パラメータは、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
に通知します。
-
repaint
public void repaint(long tm, int x, int y, int w, int h)
RepaintManager
によってpaintが1回だけ実行されるように、常に親の座標系で再ペイントします。- オーバーライド:
repaint
、クラス:JComponent
- パラメータ:
tm
- 更新までの最大時間(ミリ秒単位)x
-x
座標(左からのピクセル数)y
-y
座標(上からのピクセル数)w
- 幅h
- 高さ- 関連項目:
Component.update(java.awt.Graphics)
-
paramString
protected String paramString()
このJViewport
の文字列表現を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。 返される文字列は空の場合がありますが、null
にはなりません。- オーバーライド:
paramString
、クラス:JComponent
- 戻り値:
- この
JViewport
の文字列表現
-
firePropertyChange
protected void firePropertyChange(String propertyName, Object oldValue, Object newValue)
リスナーにプロパティの変更を通知します。 これをサブクラス化してwindowBlit
プロパティを更新します。putClientProperty
プロパティはfinalです。- オーバーライド:
firePropertyChange
、クラス:Component
- パラメータ:
propertyName
- プロパティ名が格納されている文字列oldValue
- プロパティの古い値newValue
- プロパティの新しい値
-
getAccessibleContext
public AccessibleContext getAccessibleContext()
このJViewportに関連付けられたAccessibleContextを取得します。 ビュー・ポートの場合、AccessibleContextはAccessibleJViewportの形式を取ります。 必要に応じて新規のAccessibleJViewportインスタンスが作成されます。- 定義:
getAccessibleContext
、インタフェース:Accessible
- オーバーライド:
getAccessibleContext
、クラス:Component
- 戻り値:
- このJViewportのAccessibleContextとして機能するAccessibleJViewport
-
-