javax.swing
클래스 JScrollPane

java.lang.Object 
  java.awt.Component 
      java.awt.Container 
          javax.swing.JComponent 
              javax.swing.JScrollPane

모든 구현된 인터페이스:

ImageObserver , MenuContainer , Serializable , Accessible , ScrollPaneConstants

public class JScrollPane
extends JComponent 
implements ScrollPaneConstants , Accessible 

경량 컴퍼넌트의 스크롤 가능한 뷰를 제공합니다. JScrollPane 는, 뷰포트, 옵션의 수직 스크롤 바와 수평 스크롤 바, 및 옵션의 행 헷다뷰포트와 열헷다뷰포트를 관리합니다. 자세한 것은, 「The Java Tutorial」의「How to Use Scroll Panes」에 있는 JScrollPane 의 태스크 지향의 문서를 참조해 주세요. JScrollPane 는, 중량 컴퍼넌트를 지원하고 있지 않는 것에 주의해 주세요.

JViewport 는, 예를 들어, 텍스트 파일 등, 데이터 소스에의 윈도우 또는 「뷰포트」를 제공합니다. 데이터 소스는 JViewport 의 뷰에 의해 표시되는 「스크롤 가능한 클라이언트」(데이터 모델)입니다. JScrollPane 는, 오른쪽의 그림에 나타내도록(듯이), 기본적으로 JScrollBar,JViewport, 및 그러한 접속으로부터 구성됩니다.

스크롤 바와 뷰포트 외에,JScrollPane 에는 열헤더와 행 헤더가 있는 경우도 있습니다. 이것들은 각각 setRowHeaderView 와 setColumnHeaderView 를 사용해 지정하는 JViewport 객체입니다. 열헷다뷰포트는 자동적으로 좌우에 스크롤 해, 메인뷰포트의 좌우에의 스크롤을 추적합니다. 수직에는 스크롤 하지 않습니다. 행 헤더도 똑같이 동작합니다.

2 개의 스크롤 바가 접하는 곳(중), 행 헤더가 열헤더에 접하는 곳(중), 또는 스크롤 바가 한편의 헤더에 접하는 (곳)중에, 양쪽 모두의 컴퍼넌트는 구석에 이르기 전에 정지합니다. 이 때문에, 구형의 스페이스 (디폴트에서는 빈 상태(empty)의 스페이스)가 남습니다. 이러한 스페이스는, 네 귀퉁이의 어느 코너에도 존재할 수가 있습니다. 전술의 그림에서는, 네 귀퉁이의 우상에 스페이스가 존재해, 「코너 컴퍼넌트」라고 하는 라벨을 붙일 수 있고 있습니다.

setCorner 메소드를 사용해 코너에 컴퍼넌트를 추가하는 것으로써, 이러한 빈 상태(empty)의 스페이스를 몇개에서도 옮겨놓을 수가 있습니다. (주:같은 컴퍼넌트를 복수의 코너에 추가할 수 없습니다. ) 이 기능은, 스크롤 구획에 장식이나 기능을 추가하는 경우에 도움이 됩니다. 각 코너 컴퍼넌트의 사이즈는, 헤더 및 그 주위의 스크롤 바의 사이즈, 또는 그 어느 쪽인가의 사이즈에 의해 정해집니다.

코너 컴퍼넌트는, 그것이 존재하기 위한 빈 상태(empty)의 스페이스가 있는 경우에 한정해 가시가 됩니다. 예를 들어, 열헤더를 가지는 스크롤 구획의 우상구석에 컴퍼넌트가 있는 경우에 대해 생각해 봅시다. 뷰콘포넨트가 그만큼 크지 않은등의 이유로써, 스크롤 구획에 수직 스크롤 바가 존재하지 않는 경우, 코너 컴퍼넌트는 표시되지 않습니다. 이것은, 헤더와 수직 스크롤 바가 접하는 곳(중)에 빈 상태(empty)의 스페이스를 할 수 없기 때문입니다. setVerticalScrollBarPolicy(VERTICAL_SCROLLBAR_ALWAYS) 를 사용해, 스크롤 바를 강제적으로 표시하는 설정으로 하면(자), 코너 컴퍼넌트용의 스페이스를 항상 확보할 수가 있습니다.

메인뷰포트의 주위에 경계를 추가하려면 ,setViewportBorder 를 사용할 수 있습니다. 물론,setBorder 를 사용해 스크롤 구획 전체에 경계를 추가할 수도 있습니다.

메인의 뷰포트의 뷰가 그 뷰포트보다 작은지, 또는 불투명한 경우, 실시할 필요가 있는 공통의 조작은, 사용되는 백그라운드 칼라를 설정하는 것입니다. 이 조작을 실행하려면 ,scrollPane.getViewport(). setBackground() 를 사용해, 뷰포트의 백그라운드 칼라를 설정합니다. 뷰포트의 색을 설정해, 스크롤 구획의 색을 설정하지 않는 것은, 디폴트로 JViewport 가 불투명하기 때문에입니다. 특히, 불투명하다면, 그 백그라운드를 백그라운드 칼라를 사용해 완전하게 전부 칠하게 됩니다. 따라서,JScrollPane 가 그 백그라운드를 draw 할 때, 뷰포트는 일반적으로, 같은 백그라운드 위로부터 draw 하게 됩니다.

디폴트로,JScrollPane 은 ScrollPaneLayout 를 사용해 그 아이 Components 의 레이아웃을 처리합니다. ScrollPaneLayout 는, 다음의 몇개의 방법으로 뷰포트의 뷰를 작성하는 사이즈를 결정합니다.

1. 뷰가 Scrollable 를 구현하는 경우는,getPreferredScrollableViewportSize,getScrollableTracksViewportWidth, 및 getScrollableTracksViewportHeight 의 편성이 사용된다
2. 그렇지 않은 경우는,getPreferredSize 가 사용된다

경고: Swing 는 thread에 대해서 안전하지는 않습니다. 자세한 것은,「Swing's Threading Policy」를 참조해 주세요.

경고: 이 클래스의 직렬화 된 객체는, 향후의 Swing 릴리스와 호환은 아니게 될 예정입니다. 현재의 직렬화의 지원는, 단기간의 운용이나, 같은 버젼의 Swing 를 실행하는 어플리케이션간의 RMI 에 적절하고 있습니다. JDK Version 1.4 이후, 모든 JavaBeans^™ 의 장기간의 운용 지원는,java.beans 패키지에 추가되고 있습니다. 자세한 것은,XMLEncoder 를 참조해 주세요.

관련 항목:

JScrollBar , JViewport , ScrollPaneLayout , Scrollable , Component.getPreferredSize() , setViewportView(java.awt.Component) , setRowHeaderView(java.awt.Component) , setColumnHeaderView(java.awt.Component) , setCorner(java.lang.String, java.awt.Component) , setViewportBorder(javax.swing.border.Border)

상자의 클래스의 개요

protected class	JScrollPane.AccessibleJScrollPane 이 클래스는 JScrollPane 클래스용의 접근성? 지원를 구현하고 있습니다.
protected class	JScrollPane.ScrollBar 디폴트에서는,JScrollPane 는, 이 클래스의 인스턴스인 스크롤 바를 작성합니다.

클래스 javax.swing. JComponent 로부터 상속된 상자의 클래스/인터페이스

JComponent.AccessibleJComponent

클래스 java.awt. Container 로부터 상속된 상자의 클래스/인터페이스

Container.AccessibleAWTContainer

클래스 java.awt. Component 로부터 상속된 상자의 클래스/인터페이스

Component.AccessibleAWTComponent , Component.BaselineResizeBehavior , Component.BltBufferStrategy , Component.FlipBufferStrategy

필드의 개요

protected JViewport	columnHeader 열헤더의 아이입니다.
protected JScrollBar	horizontalScrollBar 스크롤 구획의 수평 스크롤 바의 아이입니다.
protected int	horizontalScrollBarPolicy 수평 스크롤 바의 표시 정책입니다.
protected Component	lowerLeft 왼쪽 하단 모서리에 표시하는 컴퍼넌트입니다.
protected Component	lowerRight 우하구석에 표시하는 컴퍼넌트입니다.
protected JViewport	rowHeader 행 헤더의 아이입니다.
protected Component	upperLeft 좌상구석에 표시하는 컴퍼넌트입니다.
protected Component	upperRight 우상구석에 표시하는 컴퍼넌트입니다.
protected JScrollBar	verticalScrollBar 스크롤 구획의 수직 스크롤 바의 아이입니다.
protected int	verticalScrollBarPolicy 수직 스크롤 바의 표시 정책입니다.
protected JViewport	viewport 스크롤 구획의 뷰포트의 아이입니다.

클래스 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

인터페이스 javax.swing. ScrollPaneConstants 로부터 상속된 필드

COLUMN_HEADER , HORIZONTAL_SCROLLBAR , HORIZONTAL_SCROLLBAR_ALWAYS , HORIZONTAL_SCROLLBAR_AS_NEEDED , HORIZONTAL_SCROLLBAR_NEVER , HORIZONTAL_SCROLLBAR_POLICY , LOWER_LEADING_CORNER , LOWER_LEFT_CORNER , LOWER_RIGHT_CORNER , LOWER_TRAILING_CORNER , ROW_HEADER , UPPER_LEADING_CORNER , UPPER_LEFT_CORNER , UPPER_RIGHT_CORNER , UPPER_TRAILING_CORNER , VERTICAL_SCROLLBAR , VERTICAL_SCROLLBAR_ALWAYS , VERTICAL_SCROLLBAR_AS_NEEDED , VERTICAL_SCROLLBAR_NEVER , VERTICAL_SCROLLBAR_POLICY , VIEWPORT

인터페이스 java.awt.image. ImageObserver 로부터 상속된 필드

ABORT , ALLBITS , ERROR , FRAMEBITS , HEIGHT , PROPERTIES , SOMEBITS , WIDTH

생성자 의 개요

JScrollPane ()
필요에 따라서 수평 및 수직의 양쪽 모두의 스크롤 바가 표시되는 빈 상태(empty)의 (관점(전망)의 뷰가 없다) JScrollPane 를 작성합니다.

JScrollPane (Component view)
지정된 컴퍼넌트의 컨텐츠를 표시하는 JScrollPane 를 작성합니다.

JScrollPane (Component view, int vsbPolicy, int hsbPolicy)
뷰의 위치를 1 조의 스크롤 바를 사용해 제어할 수 있는 뷰포트내에 뷰콘포넨트를 표시하는 JScrollPane 를 작성합니다.

JScrollPane (int vsbPolicy, int hsbPolicy)
스크롤 바의 정책를 지정해 빈 상태(empty)의 (뷰포트의 뷰가 없다) JScrollPane 를 작성합니다.

메소드의 개요

JScrollBar	createHorizontalScrollBar () 디폴트로 JScrollPane.ScrollBar 를 돌려줍니다.
JScrollBar	createVerticalScrollBar () 디폴트로 JScrollPane.ScrollBar 를 돌려줍니다.
protected JViewport	createViewport () 디폴트로 새로운 JViewport 를 돌려줍니다.
AccessibleContext	getAccessibleContext () 이 JScrollPane 에 관련한 AccessibleContext 를 돌려줍니다.
JViewport	getColumnHeader () 열헤더를 돌려줍니다.
Component	getCorner (String key) 지정된 코너에 있는 컴퍼넌트를 돌려줍니다.
JScrollBar	getHorizontalScrollBar () 뷰포트의 수평의 뷰 위치를 제어하는 수평 스크롤 바를 돌려줍니다.
int	getHorizontalScrollBarPolicy () 수평 스크롤 바의 정책의 값을 돌려줍니다.
JViewport	getRowHeader () 행 헤더를 돌려줍니다.
ScrollPaneUI	getUI () 이 컴퍼넌트를 draw 하는 Look & Feel (L&F) 객체를 돌려줍니다.
String	getUIClassID () Look & Feel 클래스의 이름의 구축에 사용된 접미사(suffix)을 돌려줍니다.
JScrollBar	getVerticalScrollBar () 뷰포트의 수직의 뷰 위치를 제어하는 수직 스크롤 바를 돌려줍니다.
int	getVerticalScrollBarPolicy () 수직 스크롤 바의 정책의 값을 돌려줍니다.
JViewport	getViewport () 현재의 JViewport 를 돌려줍니다.
Border	getViewportBorder () 뷰포트를 둘러싸는 Border 객체를 돌려줍니다.
Rectangle	getViewportBorderBounds () 뷰포트의 경계의 경계를 돌려줍니다.
boolean	isValidateRoot () 이 메소드를 오버라이드(override) 하면(자), true 가 돌려주어져 이 JScrollPane 의 하위 객체에 대한 revalidate 의 호출에 의해, 이 JScrollPane 로 시작되는 트리 전체가 검증됩니다.
boolean	isWheelScrollingEnabled () 마우스 휠에 응답해 스크롤을 할지 어떨지를 나타냅니다.
protected String	paramString () 이 JScrollPane 의 캐릭터 라인 표현을 돌려줍니다.
void	setColumnHeader (JViewport columnHeader) 이전의 열헤더가 있는 경우는 그것을 삭제합니다.
void	setColumnHeaderView (Component view) 필요에 따라서 열헤더의 뷰포트를 작성해, 뷰를 설정하고 나서, 열헤더의 뷰포트를 스크롤 구획에 추가합니다.
void	setComponentOrientation (ComponentOrientation co) 수직 및 수평 스크롤 바의 방향을,ComponentOrientation 인수로 지정된 것으로 설정합니다.
void	setCorner (String key, Component corner) 스크롤 구획의 코너에 표시되는 아이를 추가합니다 (스페이스가 있는 경우).
void	setHorizontalScrollBar (JScrollBar horizontalScrollBar) 스크롤 구획에 뷰포트의 수평의 뷰 위치를 제어하는 스크롤 바를 추가합니다.
void	setHorizontalScrollBarPolicy (int policy) 수평 스크롤 바가 스크롤 구획에 언제 표시되는지를 설정합니다.
void	setLayout (LayoutManager layout) 이 JScrollPane 의 레이아웃 매니저를 설정합니다.
void	setRowHeader (JViewport rowHeader) 이전의 행 헤더가 있는 경우는 그것을 삭제합니다.
void	setRowHeaderView (Component view) 필요에 따라서 행 헤더의 뷰포트를 작성해, 뷰를 설정하고 나서, 행 헤더의 뷰포트를 스크롤 구획에 추가합니다.
void	setUI (ScrollPaneUI ui) 컴퍼넌트의 Look & Feel (L&F)를 제공하는 ScrollPaneUI 객체를 설정합니다.
void	setVerticalScrollBar (JScrollBar verticalScrollBar) 스크롤 구획에 뷰포트의 수직의 뷰 위치를 제어하는 스크롤 바를 추가합니다.
void	setVerticalScrollBarPolicy (int policy) 수직 스크롤 바가 스크롤 구획에 언제 표시되는지를 설정합니다.
void	setViewport (JViewport viewport) 이전의 뷰포트가 있는 경우는 그것을 삭제해, 새로운 뷰포트의 뷰 위치를 +x, +y 4분 구간내로 설정해, 행 및 열헤더 (존재하는 경우)와 새로운 뷰포트를 동기시켜, 결과적으로 스크롤 바와 헤더와 새로운 뷰포트를 동기 시킵니다.
void	setViewportBorder (Border viewportBorder) 뷰포트의 경계를 추가합니다.
void	setViewportView (Component view) 필요에 따라서 뷰포트를 작성하고 나서, 뷰를 설정합니다.
void	setWheelScrollingEnabled (boolean handleWheel) 마우스 휠의 이동에 응답해 스크롤을 유효 또는 무효로 합니다.
void	updateUI () 현재의 ScrollPaneUI 객체를 현재의 디폴트의 Look & Feel 의 버젼으로 옮겨놓습니다.

클래스 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 , getInsets , getInsets , 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 , isOptimizedDrawingEnabled , isPaintingForPrint , isPaintingTile , isRequestFocusEnabled , paint , paintBorder , paintChildren , paintComponent , paintImmediately , paintImmediately , print , printAll , printBorder , printChildren , printComponent , processComponentKeyEvent , processKeyBinding , processKeyEvent , processMouseEvent , processMouseMotionEvent , putClientProperty , registerKeyboardAction , registerKeyboardAction , removeAncestorListener , removeNotify , removeVetoableChangeListener , repaint , repaint , requestDefaultFocus , requestFocus , requestFocus , requestFocusInWindow , requestFocusInWindow , resetKeyboardActions , reshape , revalidate , scrollRectToVisible , setActionMap , setAlignmentX , setAlignmentY , setAutoscrolls , setBackground , setBorder , setComponentPopupMenu , setDebugGraphicsOptions , setDefaultLocale , setDoubleBuffered , 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 , addImpl , addPropertyChangeListener , addPropertyChangeListener , applyComponentOrientation , areFocusTraversalKeysSet , countComponents , deliverEvent , doLayout , findComponentAt , findComponentAt , getComponent , getComponentAt , getComponentAt , getComponentCount , getComponents , getComponentZOrder , getContainerListeners , getFocusTraversalKeys , getFocusTraversalPolicy , getLayout , getMousePosition , insets , invalidate , isAncestorOf , isFocusCycleRoot , isFocusCycleRoot , isFocusTraversalPolicyProvider , isFocusTraversalPolicySet , layout , list , list , locate , minimumSize , paintComponents , preferredSize , printComponents , processContainerEvent , processEvent , remove , remove , removeAll , removeContainerListener , setComponentZOrder , setFocusCycleRoot , setFocusTraversalPolicy , setFocusTraversalPolicyProvider , 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 , 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 , 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

필드의 상세

verticalScrollBarPolicy

protected int verticalScrollBarPolicy

수직 스크롤 바의 표시 정책입니다. 디폴트는 ScrollPaneConstants.VERTICAL_SCROLLBAR_AS_NEEDED 입니다.

관련 항목:

setVerticalScrollBarPolicy(int)

horizontalScrollBarPolicy

protected int horizontalScrollBarPolicy

수평 스크롤 바의 표시 정책입니다. 디폴트는 ScrollPaneConstants.HORIZONTAL_SCROLLBAR_AS_NEEDED 입니다.

관련 항목:

setHorizontalScrollBarPolicy(int)

viewport

protected JViewport  viewport

스크롤 구획의 뷰포트의 아이입니다. 디폴트는 빈 상태(empty)의 JViewport 입니다.

관련 항목:

setViewport(javax.swing.JViewport)

verticalScrollBar

protected JScrollBar  verticalScrollBar

스크롤 구획의 수직 스크롤 바의 아이입니다. 디폴트는 JScrollBar 입니다.

관련 항목:

setVerticalScrollBar(javax.swing.JScrollBar)

horizontalScrollBar

protected JScrollBar  horizontalScrollBar

스크롤 구획의 수평 스크롤 바의 아이입니다. 디폴트는 JScrollBar 입니다.

관련 항목:

setHorizontalScrollBar(javax.swing.JScrollBar)

rowHeader

protected JViewport  rowHeader

행 헤더의 아이입니다. 디폴트는 null 입니다.

관련 항목:

setRowHeader(javax.swing.JViewport)

columnHeader

protected JViewport  columnHeader

열헤더의 아이입니다. 디폴트는 null 입니다.

관련 항목:

setColumnHeader(javax.swing.JViewport)

lowerLeft

protected Component  lowerLeft

왼쪽 하단 모서리에 표시하는 컴퍼넌트입니다. 디폴트는 null 입니다.

관련 항목:

setCorner(java.lang.String, java.awt.Component)

lowerRight

protected Component  lowerRight

우하구석에 표시하는 컴퍼넌트입니다. 디폴트는 null 입니다.

관련 항목:

setCorner(java.lang.String, java.awt.Component)

upperLeft

protected Component  upperLeft

좌상구석에 표시하는 컴퍼넌트입니다. 디폴트는 null 입니다.

관련 항목:

setCorner(java.lang.String, java.awt.Component)

upperRight

protected Component  upperRight

우상구석에 표시하는 컴퍼넌트입니다. 디폴트는 null 입니다.

관련 항목:

setCorner(java.lang.String, java.awt.Component)

생성자 의 상세

JScrollPane

public JScrollPane(Component  view,
                   int vsbPolicy,
                   int hsbPolicy)

뷰의 위치를 1 조의 스크롤 바를 사용해 제어할 수 있는 뷰포트내에 뷰콘포넨트를 표시하는 JScrollPane 를 작성합니다. 스크롤 바의 정책는, 스크롤 바가 언제 표시되는지를 지정합니다. 예를 들어,vsbPolicy 가 VERTICAL_SCROLLBAR_AS_NEEDED 이면, 수직 스크롤 바는 뷰가 수직 방향으로 들어가지 않는 경우에만 표시됩니다. 이용 가능한 정책의 설정은 setVerticalScrollBarPolicy(int) 및 setHorizontalScrollBarPolicy(int) 에 리스트 되고 있습니다.

파라미터:

view - 스크롤 구획의 뷰포트에 표시하는 컴퍼넌트

vsbPolicy - 수직 스크롤 바의 정책를 지정하는 정수

hsbPolicy - 수평 스크롤 바의 정책를 지정하는 정수

관련 항목:

setViewportView(java.awt.Component)

JScrollPane

public JScrollPane(Component  view)

지정된 컴퍼넌트의 컨텐츠를 표시하는 JScrollPane 를 작성합니다. 컴퍼넌트의 컨텐츠가 뷰보다 큰 경우는, 항상 수평 및 수직 스크롤 바의 양쪽 모두가 표시됩니다.

파라미터:

view - 스크롤 구획의 뷰포트에 표시하는 컴퍼넌트

관련 항목:

setViewportView(java.awt.Component)

JScrollPane

public JScrollPane(int vsbPolicy,
                   int hsbPolicy)

스크롤 바의 정책를 지정해 빈 상태(empty)의 (뷰포트의 뷰가 없다) JScrollPane 를 작성합니다. 이용 가능한 정책의 설정은 setVerticalScrollBarPolicy(int) 및 setHorizontalScrollBarPolicy(int) 에 리스트 되고 있습니다.

파라미터:

vsbPolicy - 수직 스크롤 바의 정책를 지정하는 정수

hsbPolicy - 수평 스크롤 바의 정책를 지정하는 정수

관련 항목:

setViewportView(java.awt.Component)

JScrollPane

public JScrollPane()

필요에 따라서 수평 및 수직의 양쪽 모두의 스크롤 바가 표시되는 빈 상태(empty)의 (관점(전망)의 뷰가 없다) JScrollPane 를 작성합니다.

메소드의 상세

getUI

public ScrollPaneUI  getUI()

이 컴퍼넌트를 draw 하는 Look & Feel (L&F) 객체를 돌려줍니다.

반환값:

이 컴퍼넌트를 draw 하는 ScrollPaneUI 객체

관련 항목:

setUI(javax.swing.plaf.ScrollPaneUI)

setUI

public void setUI(ScrollPaneUI  ui)

컴퍼넌트의 Look & Feel (L&F)를 제공하는 ScrollPaneUI 객체를 설정합니다.

파라미터:

ui - ScrollPaneUI L&F 객체

관련 항목:

getUI()

updateUI

public void updateUI()

현재의 ScrollPaneUI 객체를 현재의 디폴트의 Look & Feel 의 버젼으로 옮겨놓습니다. 디폴트의 Look & Feel 가 변경되었을 때에 불려 갑니다.

오버라이드(override):

클래스 JComponent 내의 updateUI

관련 항목:

JComponent.updateUI() , UIManager.getUI(javax.swing.JComponent)

getUIClassID

public String  getUIClassID()

Look & Feel 클래스의 이름의 구축에 사용된 접미사(suffix)을 돌려줍니다. 이 클래스는, 이 컴퍼넌트를 draw 하는데 사용됩니다.

오버라이드(override):

클래스 JComponent 내의 getUIClassID

반환값:

캐릭터 라인 「ScrollPaneUI」

관련 항목:

JComponent.getUIClassID() , UIDefaults.getUI(javax.swing.JComponent)

setLayout

public void setLayout(LayoutManager  layout)

이 JScrollPane 의 레이아웃 매니저를 설정합니다. 이 메소드는,java.awt.Container 의 setLayout 를 오버라이드(override) 해,ScrollPaneLayout 의 서브 클래스인 LayoutManager 만이 JScrollPane 로 사용할 수 있는 것이 보증되도록(듯이) 합니다. layout 가 null 가 아닌 경우는, 이 메소드는 그 위에 syncWithScrollPane 를 호출합니다.

오버라이드(override):

클래스 Container 내의 setLayout

파라미터:

layout - 지정된 레이아웃 매니저

예외:

ClassCastException - 레이아웃이 ScrollPaneLayout 가 아닌 경우

관련 항목:

Container.getLayout() , Container.setLayout(java.awt.LayoutManager)

isValidateRoot

public boolean isValidateRoot()

이 메소드를 오버라이드(override) 하면(자), true 가 돌려주어져 이 JScrollPane 의 하위 객체에 대한 revalidate 의 호출에 의해, 이 JScrollPane 로 시작되는 트리 전체가 검증됩니다.

오버라이드(override):

클래스 JComponent 내의 isValidateRoot

반환값:

true

관련 항목:

Container.validate() , JComponent.revalidate() , JComponent.isValidateRoot()

getVerticalScrollBarPolicy

public int getVerticalScrollBarPolicy()

수직 스크롤 바의 정책의 값을 돌려줍니다.

반환값:

verticalScrollBarPolicy 프로퍼티

관련 항목:

setVerticalScrollBarPolicy(int)

setVerticalScrollBarPolicy

public void setVerticalScrollBarPolicy(int policy)

수직 스크롤 바가 스크롤 구획에 언제 표시되는지를 설정합니다. 다음에 유효한 값을 나타냅니다.

• ScrollPaneConstants.VERTICAL_SCROLLBAR_AS_NEEDED
• ScrollPaneConstants.VERTICAL_SCROLLBAR_NEVER
• ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS

파라미터:

policy - 상기의 3 개의 값의 언젠가

예외:

IllegalArgumentException - policy 가 상기의 정당한 값의 어떤 것인가가 아닌 경우

관련 항목:

getVerticalScrollBarPolicy()

getHorizontalScrollBarPolicy

public int getHorizontalScrollBarPolicy()

수평 스크롤 바의 정책의 값을 돌려줍니다.

반환값:

horizontalScrollBarPolicy 프로퍼티

관련 항목:

setHorizontalScrollBarPolicy(int)

setHorizontalScrollBarPolicy

public void setHorizontalScrollBarPolicy(int policy)

수평 스크롤 바가 스크롤 구획에 언제 표시되는지를 설정합니다. 옵션은 다음과 같습니다.

• ScrollPaneConstants.HORIZONTAL_SCROLLBAR_AS_NEEDED
• ScrollPaneConstants.HORIZONTAL_SCROLLBAR_NEVER
• ScrollPaneConstants.HORIZONTAL_SCROLLBAR_ALWAYS

파라미터:

policy - 상기의 3 개의 값의 언젠가

예외:

IllegalArgumentException - policy 가 상기의 정당한 값의 어떤 것인가가 아닌 경우

관련 항목:

getHorizontalScrollBarPolicy()

getViewportBorder

public Border  getViewportBorder()

뷰포트를 둘러싸는 Border 객체를 돌려줍니다.

반환값:

viewportBorder 프로퍼티

관련 항목:

setViewportBorder(javax.swing.border.Border)

setViewportBorder

public void setViewportBorder(Border  viewportBorder)

뷰포트의 경계를 추가합니다. 경계가 뷰포트로 직접 설정되지 않는 것에 주의해 주세요. JViewport 는 JComponent 의 경계 프로퍼티을 지원하지 않습니다. 같이JScrollPane 의 뷰포트를 설정해도,viewportBorder 프로퍼티에는 영향을 주지 않습니다.

이 프로퍼티의 디폴트 값는 Look & Feel 의 구현에 의해 산출됩니다.

파라미터:

viewportBorder - 추가되는 경계

관련 항목:

getViewportBorder() , setViewport(javax.swing.JViewport)

getViewportBorderBounds

public Rectangle  getViewportBorderBounds()

뷰포트의 경계의 경계를 돌려줍니다.

반환값:

뷰포트의 경계를 지정하는 Rectangle 객체

createHorizontalScrollBar

public JScrollBar  createHorizontalScrollBar()

디폴트로 JScrollPane.ScrollBar 를 돌려줍니다. 서브 클래스는 이 메소드를 오버라이드(override) 해 ScrollPaneUI 의 구현에 대해서 JScrollBar 서브 클래스를 강제적으로 사용할 수도 있습니다. 수평 스크롤 바를 작성하기 위해서 ScrollPaneUI 의 구현에 의해 사용됩니다.

반환값:

수평 방향의 JScrollBar

관련 항목:

JScrollBar

getHorizontalScrollBar

public JScrollBar  getHorizontalScrollBar()

뷰포트의 수평의 뷰 위치를 제어하는 수평 스크롤 바를 돌려줍니다.

반환값:

horizontalScrollBar 프로퍼티

관련 항목:

setHorizontalScrollBar(javax.swing.JScrollBar)

setHorizontalScrollBar

public void setHorizontalScrollBar(JScrollBar  horizontalScrollBar)

스크롤 구획에 뷰포트의 수평의 뷰 위치를 제어하는 스크롤 바를 추가합니다. JScrollPane 는 디폴트로 수평 및 수직 스크롤 바를 작성하므로, 이 메소드는 일반적으로 불필요합니다.

파라미터:

horizontalScrollBar - 추가되는 수평 스크롤 바

관련 항목:

createHorizontalScrollBar() , getHorizontalScrollBar()

createVerticalScrollBar

public JScrollBar  createVerticalScrollBar()

디폴트로 JScrollPane.ScrollBar 를 돌려줍니다. 서브 클래스는 이 메소드를 오버라이드(override) 해 ScrollPaneUI 의 구현에 대해서 JScrollBar 서브 클래스를 강제적으로 사용할 수도 있습니다. 수직 스크롤 바를 작성하기 위해서 ScrollPaneUI 의 구현에 의해 사용됩니다.

반환값:

수직 방향의 JScrollBar

관련 항목:

JScrollBar

getVerticalScrollBar

public JScrollBar  getVerticalScrollBar()

뷰포트의 수직의 뷰 위치를 제어하는 수직 스크롤 바를 돌려줍니다.

반환값:

verticalScrollBar 프로퍼티

관련 항목:

setVerticalScrollBar(javax.swing.JScrollBar)

setVerticalScrollBar

public void setVerticalScrollBar(JScrollBar  verticalScrollBar)

스크롤 구획에 뷰포트의 수직의 뷰 위치를 제어하는 스크롤 바를 추가합니다. JScrollPane 는 디폴트로 수평 및 수직 스크롤 바를 작성하므로, 이 메소드는 일반적으로 불필요합니다.

파라미터:

verticalScrollBar - 추가되는 신규의 수직 스크롤 바

관련 항목:

createVerticalScrollBar() , getVerticalScrollBar()

createViewport

protected JViewport  createViewport()

디폴트로 새로운 JViewport 를 돌려줍니다. setViewportView,setRowHeaderView, 및 setColumnHeaderView 에 필요에 따라서 뷰포트를 작성하는데 사용합니다. 서브 클래스는,JViewport 의 서브 클래스를 돌려주도록(듯이) 이 메소드를 오버라이드(override) 할 수도 있습니다.

반환값:

새로운 JViewport

getViewport

public JViewport  getViewport()

현재의 JViewport 를 돌려줍니다.

반환값:

viewport 프로퍼티

관련 항목:

setViewport(javax.swing.JViewport)

setViewport

public void setViewport(JViewport  viewport)

이전의 뷰포트가 있는 경우는 그것을 삭제해, 새로운 뷰포트의 뷰 위치를 +x, +y 4분 구간내로 설정해, 행 및 열헤더 (존재하는 경우)와 새로운 뷰포트를 동기시켜, 결과적으로 스크롤 바와 헤더와 새로운 뷰포트를 동기 시킵니다.

대부분의 어플리케이션의 경우, 뷰포트와 스크롤 구획에의 뷰의 추가에는 setViewportView 를 사용하는 편이 편리합니다.

파라미터:

viewport - 사용되는 새로운 뷰포트. 뷰포트가 null 의 경우, 이전의 뷰포트는 삭제되어 새로운 뷰포트가 null 로 설정되는

관련 항목:

createViewport() , getViewport() , setViewportView(java.awt.Component)

setViewportView

public void setViewportView(Component  view)

필요에 따라서 뷰포트를 작성하고 나서, 뷰를 설정합니다. 직접 JScrollPane 의 생성자 에 뷰를 제공하지 않는 어플리케이션은, 이 메소드를 사용해, 다음과 같이 해, 스크롤 구획에 표시되는 스크롤 가능한 아이를 지정할 필요가 있습니다. 다음에 예를 나타냅니다.

JScrollPane scrollpane = new JScrollPane();
scrollpane.setViewportView(myBigComponentToScroll);
 

어플리케이션은 직접 스크롤 구획에 아이를 추가해야 해 나무 없습니다.

파라미터:

view - 뷰포트에 추가하는 컴퍼넌트

관련 항목:

setViewport(javax.swing.JViewport) , JViewport.setView(java.awt.Component)

getRowHeader

public JViewport  getRowHeader()

행 헤더를 돌려줍니다.

반환값:

rowHeader 프로퍼티

관련 항목:

setRowHeader(javax.swing.JViewport)

setRowHeader

public void setRowHeader(JViewport  rowHeader)

이전의 행 헤더가 있는 경우는 그것을 삭제합니다. 새로운 행 헤더가 null 가 아닌 경우는, 뷰 위치의 y 좌표와 뷰포트 (존재하는 경우)를 동기 시키고 나서 스크롤 구획에 추가합니다.

대부분의 어플리케이션의 경우, 스크롤 구획에의 행 헤더 컴퍼넌트와 뷰포트의 추가에는 setRowHeaderView 를 사용하는 편이 편리합니다.

파라미터:

rowHeader - 사용되는 새로운 행 헤더. null 의 경우, 이전의 행 헤더는 삭제되어 새로운 행 헤더가 null 로 설정되는

관련 항목:

getRowHeader() , setRowHeaderView(java.awt.Component)

setRowHeaderView

public void setRowHeaderView(Component  view)

필요에 따라서 행 헤더의 뷰포트를 작성해, 뷰를 설정하고 나서, 행 헤더의 뷰포트를 스크롤 구획에 추가합니다. 다음에 예를 나타냅니다.

JScrollPane scrollpane = new JScrollPane();
scrollpane.setViewportView(myBigComponentToScroll);
scrollpane.setRowHeaderView(myBigComponentsRowHeader);
 

파라미터:

view - 행 헤더로서 표시하는 컴퍼넌트

관련 항목:

setRowHeader(javax.swing.JViewport) , JViewport.setView(java.awt.Component)

getColumnHeader

public JViewport  getColumnHeader()

열헤더를 돌려줍니다.

반환값:

columnHeader 프로퍼티

관련 항목:

setColumnHeader(javax.swing.JViewport)

setColumnHeader

public void setColumnHeader(JViewport  columnHeader)

이전의 열헤더가 있는 경우는 그것을 삭제합니다. 새로운 열헤더가 null 가 아닌 경우는, 뷰 위치의 x 좌표와 뷰포트 (존재하는 경우)를 동기 시키고 나서 스크롤 구획에 추가합니다.

대부분의 어플리케이션의 경우, 스크롤 구획에의 열헤더 컴퍼넌트와 뷰포트의 추가에는 setColumnHeaderView 를 사용하는 편이 편리합니다.

관련 항목:

getColumnHeader() , setColumnHeaderView(java.awt.Component)

setColumnHeaderView

public void setColumnHeaderView(Component  view)

필요에 따라서 열헤더의 뷰포트를 작성해, 뷰를 설정하고 나서, 열헤더의 뷰포트를 스크롤 구획에 추가합니다. 다음에 예를 나타냅니다.

JScrollPane scrollpane = new JScrollPane();
scrollpane.setViewportView(myBigComponentToScroll);
scrollpane.setColumnHeaderView(myBigComponentsColumnHeader);
 

파라미터:

view - 열헤더로서 표시하는 컴퍼넌트

관련 항목:

setColumnHeader(javax.swing.JViewport) , JViewport.setView(java.awt.Component)

getCorner

public Component  getCorner(String  key)

지정된 코너에 있는 컴퍼넌트를 돌려줍니다. 코너를 지정하는 key 치를 다음에 나타냅니다.

• ScrollPaneConstants.LOWER_LEFT_CORNER
• ScrollPaneConstants.LOWER_RIGHT_CORNER
• ScrollPaneConstants.UPPER_LEFT_CORNER
• ScrollPaneConstants.UPPER_RIGHT_CORNER
• ScrollPaneConstants.LOWER_LEADING_CORNER
• ScrollPaneConstants.LOWER_TRAILING_CORNER
• ScrollPaneConstants.UPPER_LEADING_CORNER
• ScrollPaneConstants.UPPER_TRAILING_CORNER

파라미터:

key - 상기의 값의 언젠가

반환값:

지정된 키로 식별되는 코너 컴퍼넌트 (null 의 경우도 있다). 키가 무효인 경우는 null

관련 항목:

setCorner(java.lang.String, java.awt.Component)

setCorner

public void setCorner(String  key,
                      Component  corner)

스크롤 구획의 코너에 표시되는 아이를 추가합니다 (스페이스가 있는 경우). 예를 들어, 양쪽 모두의 스크롤 바가 표시되고 있으면 (스크롤 구획의 우단 및 하단에), 왼쪽 하단 모서리의 컴퍼넌트가 2 개의 스크롤 바의 양단의 사이의 스페이스에 표시됩니다. 키의 유효한 값은 다음과 같습니다.

• ScrollPaneConstants.LOWER_LEFT_CORNER
• ScrollPaneConstants.LOWER_RIGHT_CORNER
• ScrollPaneConstants.UPPER_LEFT_CORNER
• ScrollPaneConstants.UPPER_RIGHT_CORNER
• ScrollPaneConstants.LOWER_LEADING_CORNER
• ScrollPaneConstants.LOWER_TRAILING_CORNER
• ScrollPaneConstants.UPPER_LEADING_CORNER
• ScrollPaneConstants.UPPER_TRAILING_CORNER

「코너」는 어느 beans 프로파티시그니챠와도 일치합니다만, 프로퍼티명을 코너 키로 설정하면(자) PropertyChange 이벤트가 생성됩니다.

파라미터:

key - 컴퍼넌트를 표시하는 코너를 식별하는

corner - 다음의 컴퍼넌트의 언젠가

• lowerLeft
• lowerRight
• upperLeft
• upperRight

예외:

IllegalArgumentException - 키가 무효인 경우

setComponentOrientation

public void setComponentOrientation(ComponentOrientation  co)

수직 및 수평 스크롤 바의 방향을,ComponentOrientation 인수로 지정된 것으로 설정합니다.

오버라이드(override):

클래스 Component 내의 setComponentOrientation

파라미터:

co - 다음의 값의 언젠가.

• java.awt.ComponentOrientation.LEFT_TO_RIGHT
• java.awt.ComponentOrientation.RIGHT_TO_LEFT
• java.awt.ComponentOrientation.UNKNOWN

관련 항목:

ComponentOrientation

isWheelScrollingEnabled

public boolean isWheelScrollingEnabled()

마우스 휠에 응답해 스크롤을 할지 어떨지를 나타냅니다. 휠 스크롤은 디폴트로 유효합니다.

도입된 버젼:

1.4

관련 항목:

setWheelScrollingEnabled(boolean)

setWheelScrollingEnabled

public void setWheelScrollingEnabled(boolean handleWheel)

마우스 휠의 이동에 응답해 스크롤을 유효 또는 무효로 합니다. 휠 스크롤은 디폴트로 유효합니다.

파라미터:

handleWheel - MouseWheelEvent 에 대해서 스크롤이 자동적으로 행해지는 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

1.4

관련 항목:

isWheelScrollingEnabled() , MouseWheelEvent , MouseWheelListener

paramString

protected String  paramString()

이 JScrollPane 의 캐릭터 라인 표현을 돌려줍니다. 이 메소드는 디버그 전용이며, 반환되는 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 반환되는 캐릭터 라인은 빈 상태(empty)의 경우가 있습니다만,null 로는 되지 않습니다.

오버라이드(override):

클래스 JComponent 내의 paramString

반환값:

이 JScrollPane 의 캐릭터 라인 표현

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 JScrollPane 에 관련한 AccessibleContext 를 돌려줍니다. 스크롤 구획의 경우, AccessibleContext 은 AccessibleJScrollPane 의 형식을 취합니다. 필요에 따라서 신규의 AccessibleJScrollPane 인스턴스가 작성됩니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 JComponent 내의 getAccessibleContext

반환값:

이 JScrollPane 의 AccessibleContext 로서 기능하는 AccessibleJScrollPane