JViewport (Java SE 15 & JDK 15) (original) (raw)

All Implemented Interfaces:

[ImageObserver](../../java/awt/image/ImageObserver.html "interface in java.awt.image"), [MenuContainer](../../java/awt/MenuContainer.html "interface in java.awt"), [Serializable](../../../java.base/java/io/Serializable.html "interface in java.io"), [Accessible](../accessibility/Accessible.html "interface in javax.accessibility")

public class JViewport extends JComponent implements Accessible

The "viewport" or "porthole" through which you see the underlying information. When you scroll, what moves is the viewport. It is like peering through a camera's viewfinder. Moving the viewfinder upwards brings new things into view at the top of the picture and loses things that were at the bottom.

By default, JViewport is opaque. To change this, use thesetOpaque method.

**NOTE:**We have implemented a faster scrolling algorithm that does not require a buffer to draw in. The algorithm works as follows:

1. The view and parent view are checked to see if they areJComponents, if they aren't, stop and repaint the whole viewport.
2. If the viewport is obscured by an ancestor, stop and repaint the whole viewport.
3. Compute the region that will become visible, if it is as big as the viewport, stop and repaint the whole view region.
4. Obtain the ancestor Window's graphics and do a copyArea on the scrolled region.
5. Message the view to repaint the newly visible region.
6. The next time paint is invoked on the viewport, if the clip region is smaller than the viewport size a timer is kicked off to repaint the whole region.

In general this approach is much faster. Compared to the backing store approach this avoids the overhead of maintaining an offscreen buffer and having to do two copyAreas. Compared to the non backing store case this approach will greatly reduce the painted region.

This approach can cause slower times than the backing store approach when the viewport is obscured by another window, or partially offscreen. When another window obscures the viewport the copyArea will copy garbage and a paint event will be generated by the system to inform us we need to paint the newly exposed region. The only way to handle this is to repaint the whole viewport, which can cause slower performance than the backing store case. In most applications very rarely will the user be scrolling while the viewport is obscured by another window or offscreen, so this optimization is usually worth the performance hit when obscured.

Warning: Swing is not thread safe. For more information see Swing's Threading Policy.

Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeans has been added to the java.beans package. Please see XMLEncoder.

Since:

1.2

See Also:

JScrollPane

• Nested Class Summary

• Field Summary

Fields

• Constructor Summary

Constructors

• Method Summary

Methods declared in class javax.swing.JComponent

[addAncestorListener](JComponent.html#addAncestorListener%28javax.swing.event.AncestorListener%29), [addNotify](JComponent.html#addNotify%28%29), [addVetoableChangeListener](JComponent.html#addVetoableChangeListener%28java.beans.VetoableChangeListener%29), [computeVisibleRect](JComponent.html#computeVisibleRect%28java.awt.Rectangle%29), [contains](JComponent.html#contains%28int,int%29), [createToolTip](JComponent.html#createToolTip%28%29), [disable](JComponent.html#disable%28%29), [enable](JComponent.html#enable%28%29), [firePropertyChange](JComponent.html#firePropertyChange%28java.lang.String,boolean,boolean%29), [firePropertyChange](JComponent.html#firePropertyChange%28java.lang.String,int,int%29), [fireVetoableChange](JComponent.html#fireVetoableChange%28java.lang.String,java.lang.Object,java.lang.Object%29), [getActionForKeyStroke](JComponent.html#getActionForKeyStroke%28javax.swing.KeyStroke%29), [getActionMap](JComponent.html#getActionMap%28%29), [getAlignmentX](JComponent.html#getAlignmentX%28%29), [getAlignmentY](JComponent.html#getAlignmentY%28%29), [getAncestorListeners](JComponent.html#getAncestorListeners%28%29), [getAutoscrolls](JComponent.html#getAutoscrolls%28%29), [getBaseline](JComponent.html#getBaseline%28int,int%29), [getBaselineResizeBehavior](JComponent.html#getBaselineResizeBehavior%28%29), [getBorder](JComponent.html#getBorder%28%29), [getBounds](JComponent.html#getBounds%28java.awt.Rectangle%29), [getClientProperty](JComponent.html#getClientProperty%28java.lang.Object%29), [getComponentGraphics](JComponent.html#getComponentGraphics%28java.awt.Graphics%29), [getComponentPopupMenu](JComponent.html#getComponentPopupMenu%28%29), [getConditionForKeyStroke](JComponent.html#getConditionForKeyStroke%28javax.swing.KeyStroke%29), [getDebugGraphicsOptions](JComponent.html#getDebugGraphicsOptions%28%29), [getDefaultLocale](JComponent.html#getDefaultLocale%28%29), [getFontMetrics](JComponent.html#getFontMetrics%28java.awt.Font%29), [getGraphics](JComponent.html#getGraphics%28%29), [getHeight](JComponent.html#getHeight%28%29), [getInheritsPopupMenu](JComponent.html#getInheritsPopupMenu%28%29), [getInputMap](JComponent.html#getInputMap%28%29), [getInputMap](JComponent.html#getInputMap%28int%29), [getInputVerifier](JComponent.html#getInputVerifier%28%29), [getListeners](JComponent.html#getListeners%28java.lang.Class%29), [getLocation](JComponent.html#getLocation%28java.awt.Point%29), [getMaximumSize](JComponent.html#getMaximumSize%28%29), [getMinimumSize](JComponent.html#getMinimumSize%28%29), [getNextFocusableComponent](JComponent.html#getNextFocusableComponent%28%29), [getPopupLocation](JComponent.html#getPopupLocation%28java.awt.event.MouseEvent%29), [getPreferredSize](JComponent.html#getPreferredSize%28%29), [getRegisteredKeyStrokes](JComponent.html#getRegisteredKeyStrokes%28%29), [getRootPane](JComponent.html#getRootPane%28%29), [getSize](JComponent.html#getSize%28java.awt.Dimension%29), [getToolTipLocation](JComponent.html#getToolTipLocation%28java.awt.event.MouseEvent%29), [getToolTipText](JComponent.html#getToolTipText%28%29), [getToolTipText](JComponent.html#getToolTipText%28java.awt.event.MouseEvent%29), [getTopLevelAncestor](JComponent.html#getTopLevelAncestor%28%29), [getTransferHandler](JComponent.html#getTransferHandler%28%29), [getVerifyInputWhenFocusTarget](JComponent.html#getVerifyInputWhenFocusTarget%28%29), [getVetoableChangeListeners](JComponent.html#getVetoableChangeListeners%28%29), [getVisibleRect](JComponent.html#getVisibleRect%28%29), [getWidth](JComponent.html#getWidth%28%29), [getX](JComponent.html#getX%28%29), [getY](JComponent.html#getY%28%29), [grabFocus](JComponent.html#grabFocus%28%29), [hide](JComponent.html#hide%28%29), [isDoubleBuffered](JComponent.html#isDoubleBuffered%28%29), [isLightweightComponent](JComponent.html#isLightweightComponent%28java.awt.Component%29), [isManagingFocus](JComponent.html#isManagingFocus%28%29), [isOpaque](JComponent.html#isOpaque%28%29), [isPaintingForPrint](JComponent.html#isPaintingForPrint%28%29), [isPaintingTile](JComponent.html#isPaintingTile%28%29), [isRequestFocusEnabled](JComponent.html#isRequestFocusEnabled%28%29), [isValidateRoot](JComponent.html#isValidateRoot%28%29), [paintBorder](JComponent.html#paintBorder%28java.awt.Graphics%29), [paintChildren](JComponent.html#paintChildren%28java.awt.Graphics%29), [paintComponent](JComponent.html#paintComponent%28java.awt.Graphics%29), [paintImmediately](JComponent.html#paintImmediately%28int,int,int,int%29), [paintImmediately](JComponent.html#paintImmediately%28java.awt.Rectangle%29), [print](JComponent.html#print%28java.awt.Graphics%29), [printAll](JComponent.html#printAll%28java.awt.Graphics%29), [printBorder](JComponent.html#printBorder%28java.awt.Graphics%29), [printChildren](JComponent.html#printChildren%28java.awt.Graphics%29), [printComponent](JComponent.html#printComponent%28java.awt.Graphics%29), [processComponentKeyEvent](JComponent.html#processComponentKeyEvent%28java.awt.event.KeyEvent%29), [processKeyBinding](JComponent.html#processKeyBinding%28javax.swing.KeyStroke,java.awt.event.KeyEvent,int,boolean%29), [processKeyEvent](JComponent.html#processKeyEvent%28java.awt.event.KeyEvent%29), [processMouseEvent](JComponent.html#processMouseEvent%28java.awt.event.MouseEvent%29), [processMouseMotionEvent](JComponent.html#processMouseMotionEvent%28java.awt.event.MouseEvent%29), [putClientProperty](JComponent.html#putClientProperty%28java.lang.Object,java.lang.Object%29), [registerKeyboardAction](JComponent.html#registerKeyboardAction%28java.awt.event.ActionListener,java.lang.String,javax.swing.KeyStroke,int%29), [registerKeyboardAction](JComponent.html#registerKeyboardAction%28java.awt.event.ActionListener,javax.swing.KeyStroke,int%29), [removeAncestorListener](JComponent.html#removeAncestorListener%28javax.swing.event.AncestorListener%29), [removeNotify](JComponent.html#removeNotify%28%29), [removeVetoableChangeListener](JComponent.html#removeVetoableChangeListener%28java.beans.VetoableChangeListener%29), [repaint](JComponent.html#repaint%28java.awt.Rectangle%29), [requestDefaultFocus](JComponent.html#requestDefaultFocus%28%29), [requestFocus](JComponent.html#requestFocus%28%29), [requestFocus](JComponent.html#requestFocus%28boolean%29), [requestFocusInWindow](JComponent.html#requestFocusInWindow%28%29), [requestFocusInWindow](JComponent.html#requestFocusInWindow%28boolean%29), [resetKeyboardActions](JComponent.html#resetKeyboardActions%28%29), [revalidate](JComponent.html#revalidate%28%29), [setActionMap](JComponent.html#setActionMap%28javax.swing.ActionMap%29), [setAlignmentX](JComponent.html#setAlignmentX%28float%29), [setAlignmentY](JComponent.html#setAlignmentY%28float%29), [setAutoscrolls](JComponent.html#setAutoscrolls%28boolean%29), [setBackground](JComponent.html#setBackground%28java.awt.Color%29), [setComponentPopupMenu](JComponent.html#setComponentPopupMenu%28javax.swing.JPopupMenu%29), [setDebugGraphicsOptions](JComponent.html#setDebugGraphicsOptions%28int%29), [setDefaultLocale](JComponent.html#setDefaultLocale%28java.util.Locale%29), [setDoubleBuffered](JComponent.html#setDoubleBuffered%28boolean%29), [setEnabled](JComponent.html#setEnabled%28boolean%29), [setFocusTraversalKeys](JComponent.html#setFocusTraversalKeys%28int,java.util.Set%29), [setFont](JComponent.html#setFont%28java.awt.Font%29), [setForeground](JComponent.html#setForeground%28java.awt.Color%29), [setInheritsPopupMenu](JComponent.html#setInheritsPopupMenu%28boolean%29), [setInputMap](JComponent.html#setInputMap%28int,javax.swing.InputMap%29), [setInputVerifier](JComponent.html#setInputVerifier%28javax.swing.InputVerifier%29), [setMaximumSize](JComponent.html#setMaximumSize%28java.awt.Dimension%29), [setMinimumSize](JComponent.html#setMinimumSize%28java.awt.Dimension%29), [setNextFocusableComponent](JComponent.html#setNextFocusableComponent%28java.awt.Component%29), [setOpaque](JComponent.html#setOpaque%28boolean%29), [setPreferredSize](JComponent.html#setPreferredSize%28java.awt.Dimension%29), [setRequestFocusEnabled](JComponent.html#setRequestFocusEnabled%28boolean%29), [setToolTipText](JComponent.html#setToolTipText%28java.lang.String%29), [setTransferHandler](JComponent.html#setTransferHandler%28javax.swing.TransferHandler%29), [setUI](JComponent.html#setUI%28javax.swing.plaf.ComponentUI%29), [setVerifyInputWhenFocusTarget](JComponent.html#setVerifyInputWhenFocusTarget%28boolean%29), [setVisible](JComponent.html#setVisible%28boolean%29), [unregisterKeyboardAction](JComponent.html#unregisterKeyboardAction%28javax.swing.KeyStroke%29), [update](JComponent.html#update%28java.awt.Graphics%29)

Methods declared in class java.awt.Container

[add](../../java/awt/Container.html#add%28java.awt.Component%29), [add](../../java/awt/Container.html#add%28java.awt.Component,int%29), [add](../../java/awt/Container.html#add%28java.awt.Component,java.lang.Object%29), [add](../../java/awt/Container.html#add%28java.awt.Component,java.lang.Object,int%29), [add](../../java/awt/Container.html#add%28java.lang.String,java.awt.Component%29), [addContainerListener](../../java/awt/Container.html#addContainerListener%28java.awt.event.ContainerListener%29), [addPropertyChangeListener](../../java/awt/Container.html#addPropertyChangeListener%28java.beans.PropertyChangeListener%29), [addPropertyChangeListener](../../java/awt/Container.html#addPropertyChangeListener%28java.lang.String,java.beans.PropertyChangeListener%29), [applyComponentOrientation](../../java/awt/Container.html#applyComponentOrientation%28java.awt.ComponentOrientation%29), [areFocusTraversalKeysSet](../../java/awt/Container.html#areFocusTraversalKeysSet%28int%29), [countComponents](../../java/awt/Container.html#countComponents%28%29), [deliverEvent](../../java/awt/Container.html#deliverEvent%28java.awt.Event%29), [doLayout](../../java/awt/Container.html#doLayout%28%29), [findComponentAt](../../java/awt/Container.html#findComponentAt%28int,int%29), [findComponentAt](../../java/awt/Container.html#findComponentAt%28java.awt.Point%29), [getComponent](../../java/awt/Container.html#getComponent%28int%29), [getComponentAt](../../java/awt/Container.html#getComponentAt%28int,int%29), [getComponentAt](../../java/awt/Container.html#getComponentAt%28java.awt.Point%29), [getComponentCount](../../java/awt/Container.html#getComponentCount%28%29), [getComponents](../../java/awt/Container.html#getComponents%28%29), [getComponentZOrder](../../java/awt/Container.html#getComponentZOrder%28java.awt.Component%29), [getContainerListeners](../../java/awt/Container.html#getContainerListeners%28%29), [getFocusTraversalKeys](../../java/awt/Container.html#getFocusTraversalKeys%28int%29), [getFocusTraversalPolicy](../../java/awt/Container.html#getFocusTraversalPolicy%28%29), [getLayout](../../java/awt/Container.html#getLayout%28%29), [getMousePosition](../../java/awt/Container.html#getMousePosition%28boolean%29), [insets](../../java/awt/Container.html#insets%28%29), [invalidate](../../java/awt/Container.html#invalidate%28%29), [isAncestorOf](../../java/awt/Container.html#isAncestorOf%28java.awt.Component%29), [isFocusCycleRoot](../../java/awt/Container.html#isFocusCycleRoot%28%29), [isFocusCycleRoot](../../java/awt/Container.html#isFocusCycleRoot%28java.awt.Container%29), [isFocusTraversalPolicyProvider](../../java/awt/Container.html#isFocusTraversalPolicyProvider%28%29), [isFocusTraversalPolicySet](../../java/awt/Container.html#isFocusTraversalPolicySet%28%29), [layout](../../java/awt/Container.html#layout%28%29), [list](../../java/awt/Container.html#list%28java.io.PrintStream,int%29), [list](../../java/awt/Container.html#list%28java.io.PrintWriter,int%29), [locate](../../java/awt/Container.html#locate%28int,int%29), [minimumSize](../../java/awt/Container.html#minimumSize%28%29), [paintComponents](../../java/awt/Container.html#paintComponents%28java.awt.Graphics%29), [preferredSize](../../java/awt/Container.html#preferredSize%28%29), [printComponents](../../java/awt/Container.html#printComponents%28java.awt.Graphics%29), [processContainerEvent](../../java/awt/Container.html#processContainerEvent%28java.awt.event.ContainerEvent%29), [processEvent](../../java/awt/Container.html#processEvent%28java.awt.AWTEvent%29), [remove](../../java/awt/Container.html#remove%28int%29), [removeAll](../../java/awt/Container.html#removeAll%28%29), [removeContainerListener](../../java/awt/Container.html#removeContainerListener%28java.awt.event.ContainerListener%29), [setComponentZOrder](../../java/awt/Container.html#setComponentZOrder%28java.awt.Component,int%29), [setFocusCycleRoot](../../java/awt/Container.html#setFocusCycleRoot%28boolean%29), [setFocusTraversalPolicy](../../java/awt/Container.html#setFocusTraversalPolicy%28java.awt.FocusTraversalPolicy%29), [setFocusTraversalPolicyProvider](../../java/awt/Container.html#setFocusTraversalPolicyProvider%28boolean%29), [setLayout](../../java/awt/Container.html#setLayout%28java.awt.LayoutManager%29), [transferFocusDownCycle](../../java/awt/Container.html#transferFocusDownCycle%28%29), [validate](../../java/awt/Container.html#validate%28%29), [validateTree](../../java/awt/Container.html#validateTree%28%29)

Methods declared in class java.awt.Component

[action](../../java/awt/Component.html#action%28java.awt.Event,java.lang.Object%29), [add](../../java/awt/Component.html#add%28java.awt.PopupMenu%29), [addComponentListener](../../java/awt/Component.html#addComponentListener%28java.awt.event.ComponentListener%29), [addFocusListener](../../java/awt/Component.html#addFocusListener%28java.awt.event.FocusListener%29), [addHierarchyBoundsListener](../../java/awt/Component.html#addHierarchyBoundsListener%28java.awt.event.HierarchyBoundsListener%29), [addHierarchyListener](../../java/awt/Component.html#addHierarchyListener%28java.awt.event.HierarchyListener%29), [addInputMethodListener](../../java/awt/Component.html#addInputMethodListener%28java.awt.event.InputMethodListener%29), [addKeyListener](../../java/awt/Component.html#addKeyListener%28java.awt.event.KeyListener%29), [addMouseListener](../../java/awt/Component.html#addMouseListener%28java.awt.event.MouseListener%29), [addMouseMotionListener](../../java/awt/Component.html#addMouseMotionListener%28java.awt.event.MouseMotionListener%29), [addMouseWheelListener](../../java/awt/Component.html#addMouseWheelListener%28java.awt.event.MouseWheelListener%29), [bounds](../../java/awt/Component.html#bounds%28%29), [checkImage](../../java/awt/Component.html#checkImage%28java.awt.Image,int,int,java.awt.image.ImageObserver%29), [checkImage](../../java/awt/Component.html#checkImage%28java.awt.Image,java.awt.image.ImageObserver%29), [coalesceEvents](../../java/awt/Component.html#coalesceEvents%28java.awt.AWTEvent,java.awt.AWTEvent%29), [contains](../../java/awt/Component.html#contains%28java.awt.Point%29), [createImage](../../java/awt/Component.html#createImage%28int,int%29), [createImage](../../java/awt/Component.html#createImage%28java.awt.image.ImageProducer%29), [createVolatileImage](../../java/awt/Component.html#createVolatileImage%28int,int%29), [createVolatileImage](../../java/awt/Component.html#createVolatileImage%28int,int,java.awt.ImageCapabilities%29), [disableEvents](../../java/awt/Component.html#disableEvents%28long%29), [dispatchEvent](../../java/awt/Component.html#dispatchEvent%28java.awt.AWTEvent%29), [enable](../../java/awt/Component.html#enable%28boolean%29), [enableEvents](../../java/awt/Component.html#enableEvents%28long%29), [enableInputMethods](../../java/awt/Component.html#enableInputMethods%28boolean%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String,byte,byte%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String,char,char%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String,double,double%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String,float,float%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String,long,long%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String,short,short%29), [getBackground](../../java/awt/Component.html#getBackground%28%29), [getBounds](../../java/awt/Component.html#getBounds%28%29), [getColorModel](../../java/awt/Component.html#getColorModel%28%29), [getComponentListeners](../../java/awt/Component.html#getComponentListeners%28%29), [getComponentOrientation](../../java/awt/Component.html#getComponentOrientation%28%29), [getCursor](../../java/awt/Component.html#getCursor%28%29), [getDropTarget](../../java/awt/Component.html#getDropTarget%28%29), [getFocusCycleRootAncestor](../../java/awt/Component.html#getFocusCycleRootAncestor%28%29), [getFocusListeners](../../java/awt/Component.html#getFocusListeners%28%29), [getFocusTraversalKeysEnabled](../../java/awt/Component.html#getFocusTraversalKeysEnabled%28%29), [getFont](../../java/awt/Component.html#getFont%28%29), [getForeground](../../java/awt/Component.html#getForeground%28%29), [getGraphicsConfiguration](../../java/awt/Component.html#getGraphicsConfiguration%28%29), [getHierarchyBoundsListeners](../../java/awt/Component.html#getHierarchyBoundsListeners%28%29), [getHierarchyListeners](../../java/awt/Component.html#getHierarchyListeners%28%29), [getIgnoreRepaint](../../java/awt/Component.html#getIgnoreRepaint%28%29), [getInputContext](../../java/awt/Component.html#getInputContext%28%29), [getInputMethodListeners](../../java/awt/Component.html#getInputMethodListeners%28%29), [getInputMethodRequests](../../java/awt/Component.html#getInputMethodRequests%28%29), [getKeyListeners](../../java/awt/Component.html#getKeyListeners%28%29), [getLocale](../../java/awt/Component.html#getLocale%28%29), [getLocation](../../java/awt/Component.html#getLocation%28%29), [getLocationOnScreen](../../java/awt/Component.html#getLocationOnScreen%28%29), [getMouseListeners](../../java/awt/Component.html#getMouseListeners%28%29), [getMouseMotionListeners](../../java/awt/Component.html#getMouseMotionListeners%28%29), [getMousePosition](../../java/awt/Component.html#getMousePosition%28%29), [getMouseWheelListeners](../../java/awt/Component.html#getMouseWheelListeners%28%29), [getName](../../java/awt/Component.html#getName%28%29), [getParent](../../java/awt/Component.html#getParent%28%29), [getPropertyChangeListeners](../../java/awt/Component.html#getPropertyChangeListeners%28%29), [getPropertyChangeListeners](../../java/awt/Component.html#getPropertyChangeListeners%28java.lang.String%29), [getSize](../../java/awt/Component.html#getSize%28%29), [getToolkit](../../java/awt/Component.html#getToolkit%28%29), [getTreeLock](../../java/awt/Component.html#getTreeLock%28%29), [gotFocus](../../java/awt/Component.html#gotFocus%28java.awt.Event,java.lang.Object%29), [handleEvent](../../java/awt/Component.html#handleEvent%28java.awt.Event%29), [hasFocus](../../java/awt/Component.html#hasFocus%28%29), [imageUpdate](../../java/awt/Component.html#imageUpdate%28java.awt.Image,int,int,int,int,int%29), [inside](../../java/awt/Component.html#inside%28int,int%29), [isBackgroundSet](../../java/awt/Component.html#isBackgroundSet%28%29), [isCursorSet](../../java/awt/Component.html#isCursorSet%28%29), [isDisplayable](../../java/awt/Component.html#isDisplayable%28%29), [isEnabled](../../java/awt/Component.html#isEnabled%28%29), [isFocusable](../../java/awt/Component.html#isFocusable%28%29), [isFocusOwner](../../java/awt/Component.html#isFocusOwner%28%29), [isFocusTraversable](../../java/awt/Component.html#isFocusTraversable%28%29), [isFontSet](../../java/awt/Component.html#isFontSet%28%29), [isForegroundSet](../../java/awt/Component.html#isForegroundSet%28%29), [isLightweight](../../java/awt/Component.html#isLightweight%28%29), [isMaximumSizeSet](../../java/awt/Component.html#isMaximumSizeSet%28%29), [isMinimumSizeSet](../../java/awt/Component.html#isMinimumSizeSet%28%29), [isPreferredSizeSet](../../java/awt/Component.html#isPreferredSizeSet%28%29), [isShowing](../../java/awt/Component.html#isShowing%28%29), [isValid](../../java/awt/Component.html#isValid%28%29), [isVisible](../../java/awt/Component.html#isVisible%28%29), [keyDown](../../java/awt/Component.html#keyDown%28java.awt.Event,int%29), [keyUp](../../java/awt/Component.html#keyUp%28java.awt.Event,int%29), [list](../../java/awt/Component.html#list%28%29), [list](../../java/awt/Component.html#list%28java.io.PrintStream%29), [list](../../java/awt/Component.html#list%28java.io.PrintWriter%29), [location](../../java/awt/Component.html#location%28%29), [lostFocus](../../java/awt/Component.html#lostFocus%28java.awt.Event,java.lang.Object%29), [mouseDown](../../java/awt/Component.html#mouseDown%28java.awt.Event,int,int%29), [mouseDrag](../../java/awt/Component.html#mouseDrag%28java.awt.Event,int,int%29), [mouseEnter](../../java/awt/Component.html#mouseEnter%28java.awt.Event,int,int%29), [mouseExit](../../java/awt/Component.html#mouseExit%28java.awt.Event,int,int%29), [mouseMove](../../java/awt/Component.html#mouseMove%28java.awt.Event,int,int%29), [mouseUp](../../java/awt/Component.html#mouseUp%28java.awt.Event,int,int%29), [move](../../java/awt/Component.html#move%28int,int%29), [nextFocus](../../java/awt/Component.html#nextFocus%28%29), [paintAll](../../java/awt/Component.html#paintAll%28java.awt.Graphics%29), [postEvent](../../java/awt/Component.html#postEvent%28java.awt.Event%29), [prepareImage](../../java/awt/Component.html#prepareImage%28java.awt.Image,int,int,java.awt.image.ImageObserver%29), [prepareImage](../../java/awt/Component.html#prepareImage%28java.awt.Image,java.awt.image.ImageObserver%29), [processComponentEvent](../../java/awt/Component.html#processComponentEvent%28java.awt.event.ComponentEvent%29), [processFocusEvent](../../java/awt/Component.html#processFocusEvent%28java.awt.event.FocusEvent%29), [processHierarchyBoundsEvent](../../java/awt/Component.html#processHierarchyBoundsEvent%28java.awt.event.HierarchyEvent%29), [processHierarchyEvent](../../java/awt/Component.html#processHierarchyEvent%28java.awt.event.HierarchyEvent%29), [processInputMethodEvent](../../java/awt/Component.html#processInputMethodEvent%28java.awt.event.InputMethodEvent%29), [processMouseWheelEvent](../../java/awt/Component.html#processMouseWheelEvent%28java.awt.event.MouseWheelEvent%29), [remove](../../java/awt/Component.html#remove%28java.awt.MenuComponent%29), [removeComponentListener](../../java/awt/Component.html#removeComponentListener%28java.awt.event.ComponentListener%29), [removeFocusListener](../../java/awt/Component.html#removeFocusListener%28java.awt.event.FocusListener%29), [removeHierarchyBoundsListener](../../java/awt/Component.html#removeHierarchyBoundsListener%28java.awt.event.HierarchyBoundsListener%29), [removeHierarchyListener](../../java/awt/Component.html#removeHierarchyListener%28java.awt.event.HierarchyListener%29), [removeInputMethodListener](../../java/awt/Component.html#removeInputMethodListener%28java.awt.event.InputMethodListener%29), [removeKeyListener](../../java/awt/Component.html#removeKeyListener%28java.awt.event.KeyListener%29), [removeMouseListener](../../java/awt/Component.html#removeMouseListener%28java.awt.event.MouseListener%29), [removeMouseMotionListener](../../java/awt/Component.html#removeMouseMotionListener%28java.awt.event.MouseMotionListener%29), [removeMouseWheelListener](../../java/awt/Component.html#removeMouseWheelListener%28java.awt.event.MouseWheelListener%29), [removePropertyChangeListener](../../java/awt/Component.html#removePropertyChangeListener%28java.beans.PropertyChangeListener%29), [removePropertyChangeListener](../../java/awt/Component.html#removePropertyChangeListener%28java.lang.String,java.beans.PropertyChangeListener%29), [repaint](../../java/awt/Component.html#repaint%28%29), [repaint](../../java/awt/Component.html#repaint%28int,int,int,int%29), [repaint](../../java/awt/Component.html#repaint%28long%29), [requestFocus](../../java/awt/Component.html#requestFocus%28boolean,java.awt.event.FocusEvent.Cause%29), [requestFocus](../../java/awt/Component.html#requestFocus%28java.awt.event.FocusEvent.Cause%29), [requestFocusInWindow](../../java/awt/Component.html#requestFocusInWindow%28java.awt.event.FocusEvent.Cause%29), [resize](../../java/awt/Component.html#resize%28int,int%29), [resize](../../java/awt/Component.html#resize%28java.awt.Dimension%29), [setBounds](../../java/awt/Component.html#setBounds%28int,int,int,int%29), [setBounds](../../java/awt/Component.html#setBounds%28java.awt.Rectangle%29), [setComponentOrientation](../../java/awt/Component.html#setComponentOrientation%28java.awt.ComponentOrientation%29), [setCursor](../../java/awt/Component.html#setCursor%28java.awt.Cursor%29), [setDropTarget](../../java/awt/Component.html#setDropTarget%28java.awt.dnd.DropTarget%29), [setFocusable](../../java/awt/Component.html#setFocusable%28boolean%29), [setFocusTraversalKeysEnabled](../../java/awt/Component.html#setFocusTraversalKeysEnabled%28boolean%29), [setIgnoreRepaint](../../java/awt/Component.html#setIgnoreRepaint%28boolean%29), [setLocale](../../java/awt/Component.html#setLocale%28java.util.Locale%29), [setLocation](../../java/awt/Component.html#setLocation%28int,int%29), [setLocation](../../java/awt/Component.html#setLocation%28java.awt.Point%29), [setMixingCutoutShape](../../java/awt/Component.html#setMixingCutoutShape%28java.awt.Shape%29), [setName](../../java/awt/Component.html#setName%28java.lang.String%29), [setSize](../../java/awt/Component.html#setSize%28int,int%29), [setSize](../../java/awt/Component.html#setSize%28java.awt.Dimension%29), [show](../../java/awt/Component.html#show%28%29), [show](../../java/awt/Component.html#show%28boolean%29), [size](../../java/awt/Component.html#size%28%29), [toString](../../java/awt/Component.html#toString%28%29), [transferFocus](../../java/awt/Component.html#transferFocus%28%29), [transferFocusBackward](../../java/awt/Component.html#transferFocusBackward%28%29), [transferFocusUpCycle](../../java/awt/Component.html#transferFocusUpCycle%28%29)

• Field Details

  • isViewSizeSet

  protected boolean isViewSizeSet
  True when the viewport dimensions have been determined. The default is false.

  • lastPaintPosition

  protected Point lastPaintPosition
  The last viewPosition that we've painted, so we know how much of the backing store image is valid.

  • backingStore

  True when this viewport is maintaining an offscreen image of its contents, so that some scrolling can take place using fast "bit-blit" operations instead of by accessing the view object to construct the display. The default is false.
  See Also:
  setScrollMode(int)

  • backingStoreImage

  protected transient Image backingStoreImage
  The view image used for a backing store.

  • scrollUnderway

  protected boolean scrollUnderway
  The scrollUnderway flag is used for components likeJList. When the downarrow key is pressed on aJList and the selected cell is the last in the list, the scrollpane autoscrolls. Here, the old selected cell needs repainting and so we need a flag to make the viewport do the optimized painting only when there is an explicit call tosetViewPosition(Point). When setBounds is called through other routes, the flag is off and the view repaints normally. Another approach would be to remove this from the JViewport class and have the JList manage this case by usingsetBackingStoreEnabled. The default isfalse.

  • BLIT_SCROLL_MODE

  public static final int BLIT_SCROLL_MODE
  Use graphics.copyArea to implement scrolling. This is the fastest for most applications.
  Since:
  1.3
  See Also:
  setScrollMode(int), Constant Field Values

  • BACKINGSTORE_SCROLL_MODE

  public static final int BACKINGSTORE_SCROLL_MODE
  Draws viewport contents into an offscreen image. This was previously the default mode for JTable. This mode may offer advantages over "blit mode" in some cases, but it requires a large chunk of extra RAM.
  Since:
  1.3
  See Also:
  setScrollMode(int), Constant Field Values

  • SIMPLE_SCROLL_MODE

  public static final int SIMPLE_SCROLL_MODE
  This mode uses the very simple method of redrawing the entire contents of the scrollpane each time it is scrolled. This was the default behavior in Swing 1.0 and Swing 1.1. Either of the other two options will provide better performance in most cases.
  Since:
  1.3
  See Also:
  setScrollMode(int), Constant Field Values

• Constructor Details

  • JViewport

  public JViewport()
  Creates a JViewport.

• Method Details

  • getUI

  Returns the L&F object that renders this component.
  Overrides:
  [getUI](JComponent.html#getUI%28%29) in class [JComponent](JComponent.html "class in javax.swing")
  Returns:
  a ViewportUI object
  Since:
  1.3

  • setUI

  Sets the L&F object that renders this component.
  Parameters:
  ui - the ViewportUI L&F object
  Since:
  1.3
  See Also:
  UIDefaults.getUI(javax.swing.JComponent)

  • updateUI

  public void updateUI()
  Resets the UI property to a value from the current look and feel.
  Overrides:
  [updateUI](JComponent.html#updateUI%28%29) in class [JComponent](JComponent.html "class in javax.swing")
  See Also:
  JComponent.updateUI()

  • getUIClassID

  public String getUIClassID()
  Returns a string that specifies the name of the L&F class that renders this component.
  Overrides:
  [getUIClassID](JComponent.html#getUIClassID%28%29) in class [JComponent](JComponent.html "class in javax.swing")
  Returns:
  the string "ViewportUI"
  See Also:
  JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

  • addImpl

  protected void addImpl​(Component child,Object constraints, int index)
  Sets the JViewport's one lightweight child, which can be null. (Since there is only one child which occupies the entire viewport, the constraints and index arguments are ignored.)
  Overrides:
  [addImpl](../../java/awt/Container.html#addImpl%28java.awt.Component,java.lang.Object,int%29) in class [Container](../../java/awt/Container.html "class in java.awt")
  Parameters:
  child - the lightweight child of the viewport
  constraints - the constraints to be respected
  index - the index
  See Also:
  setView(java.awt.Component)

  • remove

  Removes the Viewports one lightweight child.
  Overrides:
  [remove](../../java/awt/Container.html#remove%28java.awt.Component%29) in class [Container](../../java/awt/Container.html "class in java.awt")
  Parameters:
  child - the component to be removed
  See Also:
  setView(java.awt.Component)

  • scrollRectToVisible

  public void scrollRectToVisible​(Rectangle contentRect)
  Scrolls the view so that Rectangle within the view becomes visible.
  This attempts to validate the view before scrolling if the view is currently not valid - isValid returns false. To avoid excessive validation when the containment hierarchy is being created this will not validate if one of the ancestors does not have a peer, or there is no validate root ancestor, or one of the ancestors is not a Window or Applet.
  Note that this method will not scroll outside of the valid viewport; for example, if contentRect is larger than the viewport, scrolling will be confined to the viewport's bounds.
  Overrides:
  [scrollRectToVisible](JComponent.html#scrollRectToVisible%28java.awt.Rectangle%29) in class [JComponent](JComponent.html "class in javax.swing")
  Parameters:
  contentRect - the Rectangle to display
  See Also:
  JComponent.isValidateRoot(), Component.isValid()

  • setBorder

  public final void setBorder​(Border border)
  The viewport "scrolls" its child (called the "view") by the normal parent/child clipping (typically the view is moved in the opposite direction of the scroll). A non-null border, or non-zero insets, isn't supported, to prevent the geometry of this component from becoming complex enough to inhibit subclassing. To create a JViewport with a border, add it to a JPanel that has a border.
  Note: If border is non-null, this method will throw an exception as borders are not supported on a JViewPort.
  Overrides:
  [setBorder](JComponent.html#setBorder%28javax.swing.border.Border%29) in class [JComponent](JComponent.html "class in javax.swing")
  Parameters:
  border - the Border to set
  Throws:
  [IllegalArgumentException](../../../java.base/java/lang/IllegalArgumentException.html "class in java.lang") - this method is not implemented
  See Also:
  Border, CompoundBorder

  • getInsets

  public final Insets getInsets()
  Returns the insets (border) dimensions as (0,0,0,0), since borders are not supported on a JViewport.
  Overrides:
  [getInsets](JComponent.html#getInsets%28%29) in class [JComponent](JComponent.html "class in javax.swing")
  Returns:
  a Rectangle of zero dimension and zero origin
  See Also:
  setBorder(javax.swing.border.Border)

  • getInsets

  Returns an Insets object containing thisJViewports inset values. The passed-inInsets object will be reinitialized, and all existing values within this object are overwritten.
  Overrides:
  [getInsets](JComponent.html#getInsets%28java.awt.Insets%29) in class [JComponent](JComponent.html "class in javax.swing")
  Parameters:
  insets - the Insets object which can be reused
  Returns:
  this viewports inset values
  See Also:
  getInsets()

  • isOptimizedDrawingEnabled

  public boolean isOptimizedDrawingEnabled()
  The JViewport overrides the default implementation of this method (in JComponent) to return false. This ensures that the drawing machinery will call the Viewport'spaint implementation rather than messaging the JViewport's children directly.
  Overrides:
  [isOptimizedDrawingEnabled](JComponent.html#isOptimizedDrawingEnabled%28%29) in class [JComponent](JComponent.html "class in javax.swing")
  Returns:
  false

  • isPaintingOrigin

  protected boolean isPaintingOrigin()
  Returns true if scroll mode is a BACKINGSTORE_SCROLL_MODE to cause painting to originate from JViewport, or one of its ancestors. Otherwise returns false.
  Overrides:
  [isPaintingOrigin](JComponent.html#isPaintingOrigin%28%29) in class [JComponent](JComponent.html "class in javax.swing")
  Returns:
  true if scroll mode is a BACKINGSTORE_SCROLL_MODE.
  See Also:
  JComponent.isPaintingOrigin()

  • paint

  Depending on whether the backingStore is enabled, either paint the image through the backing store or paint just the recently exposed part, using the backing store to "blit" the remainder.

  The term "blit" is the pronounced version of the PDP-10 BLT (BLock Transfer) instruction, which copied a block of bits. (In case you were curious.)
  Overrides:
  [paint](JComponent.html#paint%28java.awt.Graphics%29) in class [JComponent](JComponent.html "class in javax.swing")
  Parameters:
  g - the Graphics context within which to paint
  See Also:
  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)
  Sets the bounds of this viewport. If the viewport's width or height has changed, fire a StateChanged event.
  Overrides:
  [reshape](JComponent.html#reshape%28int,int,int,int%29) in class [JComponent](JComponent.html "class in javax.swing")
  Parameters:
  x - left edge of the origin
  y - top edge of the origin
  w - width in pixels
  h - height in pixels
  See Also:
  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)
  Used to control the method of scrolling the viewport contents. You may want to change this mode to get maximum performance for your use case.
  Parameters:
  mode - one of the following values:
  * JViewport.BLIT_SCROLL_MODE
  * JViewport.BACKINGSTORE_SCROLL_MODE
  * JViewport.SIMPLE_SCROLL_MODE
  Since:
  1.3
  See Also:
  BLIT_SCROLL_MODE, BACKINGSTORE_SCROLL_MODE, SIMPLE_SCROLL_MODE

  • getScrollMode

  public int getScrollMode()
  Returns the current scrolling mode.
  Returns:
  the scrollMode property
  Since:
  1.3
  See Also:
  setScrollMode(int)

  • isBackingStoreEnabled

  @Deprecated public boolean isBackingStoreEnabled()
  Returns true if this viewport is maintaining an offscreen image of its contents.
  Returns:
  true if scrollMode isBACKINGSTORE_SCROLL_MODE

  • setBackingStoreEnabled

  @Deprecated public void setBackingStoreEnabled​(boolean enabled)
  If true if this viewport will maintain an offscreen image of its contents. The image is used to reduce the cost of small one dimensional changes to the viewPosition. Rather than repainting the entire viewport we useGraphics.copyArea to effect some of the scroll.
  Parameters:
  enabled - if true, maintain an offscreen backing store

  • getView

  Returns the JViewport's one child or null.
  Returns:
  the viewports child, or null if none exists
  See Also:
  setView(java.awt.Component)

  • setView

  Sets the JViewport's one lightweight child (view), which can be null.
  Parameters:
  view - the viewport's new lightweight child
  See Also:
  getView()

  • getViewSize

  If the view's size hasn't been explicitly set, return the preferred size, otherwise return the view's current size. If there is no view, return 0,0.
  Returns:
  a Dimension object specifying the size of the view

  • setViewSize

  public void setViewSize​(Dimension newSize)
  Sets the size of the view. A state changed event will be fired.
  Parameters:
  newSize - a Dimension object specifying the new size of the view

  • getViewPosition

  public Point getViewPosition()
  Returns the view coordinates that appear in the upper left hand corner of the viewport, or 0,0 if there's no view.
  Returns:
  a Point object giving the upper left coordinates

  • setViewPosition

  public void setViewPosition​(Point p)
  Sets the view coordinates that appear in the upper left hand corner of the viewport, does nothing if there's no view.
  Parameters:
  p - a Point object giving the upper left coordinates

  • getViewRect

  Returns a rectangle whose origin is getViewPosition and size is getExtentSize. This is the visible part of the view, in view coordinates.
  Returns:
  a Rectangle giving the visible part of the view using view coordinates.

  • computeBlit

  protected boolean computeBlit​(int dx, int dy,Point blitFrom,Point blitTo,Dimension blitSize,Rectangle blitPaint)
  Computes the parameters for a blit where the backing store image currently contains oldLoc in the upper left hand corner and we're scrolling to newLoc. The parameters are modified to return the values required for the blit.
  Parameters:
  dx - the horizontal delta
  dy - the vertical delta
  blitFrom - the Point we're blitting from
  blitTo - the Point we're blitting to
  blitSize - the Dimension of the area to blit
  blitPaint - the area to blit
  Returns:
  true if the parameters are modified and we're ready to blit; false otherwise

  • getExtentSize

  Returns the size of the visible part of the view in view coordinates.
  Returns:
  a Dimension object giving the size of the view

  • toViewCoordinates

  Converts a size in pixel coordinates to view coordinates. Subclasses of viewport that support "logical coordinates" will override this method.
  Parameters:
  size - a Dimension object using pixel coordinates
  Returns:
  a Dimension object converted to view coordinates

  • toViewCoordinates

  Converts a point in pixel coordinates to view coordinates. Subclasses of viewport that support "logical coordinates" will override this method.
  Parameters:
  p - a Point object using pixel coordinates
  Returns:
  a Point object converted to view coordinates

  • setExtentSize

  public void setExtentSize​(Dimension newExtent)
  Sets the size of the visible part of the view using view coordinates.
  Parameters:
  newExtent - a Dimension object specifying the size of the view

  • createViewListener

  Creates a listener for the view.
  Returns:
  a ViewListener

  • createLayoutManager

  Subclassers can override this to install a different layout manager (or null) in the constructor. Returns the LayoutManager to install on the JViewport.
  Returns:
  a LayoutManager

  • addChangeListener

  Adds a ChangeListener to the list that is notified each time the view's size, position, or the viewport's extent size has changed.
  Parameters:
  l - the ChangeListener to add
  See Also:
  removeChangeListener(javax.swing.event.ChangeListener), setViewPosition(java.awt.Point), setViewSize(java.awt.Dimension), setExtentSize(java.awt.Dimension)

  • removeChangeListener

  Removes a ChangeListener from the list that's notified each time the views size, position, or the viewports extent size has changed.
  Parameters:
  l - the ChangeListener to remove
  See Also:
  addChangeListener(javax.swing.event.ChangeListener)

  • getChangeListeners

  Returns an array of all the ChangeListeners added to this JViewport with addChangeListener().
  Returns:
  all of the ChangeListeners added or an empty array if no listeners have been added
  Since:
  1.4

  • fireStateChanged

  protected void fireStateChanged()
  Notifies all ChangeListeners when the views size, position, or the viewports extent size has changed.
  See Also:
  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)
  Always repaint in the parents coordinate system to make sure only one paint is performed by the RepaintManager.
  Overrides:
  [repaint](JComponent.html#repaint%28long,int,int,int,int%29) in class [JComponent](JComponent.html "class in javax.swing")
  Parameters:
  tm - maximum time in milliseconds before update
  x - the x coordinate (pixels over from left)
  y - the y coordinate (pixels down from top)
  w - the width
  h - the height
  See Also:
  Component.update(java.awt.Graphics)

  • paramString

  protected String paramString()
  Returns a string representation of this JViewport. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not be null.
  Overrides:
  [paramString](JComponent.html#paramString%28%29) in class [JComponent](JComponent.html "class in javax.swing")
  Returns:
  a string representation of this JViewport

  • firePropertyChange

  protected void firePropertyChange​(String propertyName,Object oldValue,Object newValue)
  Notifies listeners of a property change. This is subclassed to update the windowBlit property. (The putClientProperty property is final).
  Overrides:
  [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String,java.lang.Object,java.lang.Object%29) in class [Component](../../java/awt/Component.html "class in java.awt")
  Parameters:
  propertyName - a string containing the property name
  oldValue - the old value of the property
  newValue - the new value of the property

  • getAccessibleContext

  Gets the AccessibleContext associated with this JViewport. For viewports, the AccessibleContext takes the form of an AccessibleJViewport. A new AccessibleJViewport instance is created if necessary.
  Specified by:
  [getAccessibleContext](../accessibility/Accessible.html#getAccessibleContext%28%29) in interface [Accessible](../accessibility/Accessible.html "interface in javax.accessibility")
  Overrides:
  [getAccessibleContext](../../java/awt/Component.html#getAccessibleContext%28%29) in class [Component](../../java/awt/Component.html "class in java.awt")
  Returns:
  an AccessibleJViewport that serves as the AccessibleContext of this JViewport