개요   패키지    클래스  사용   계층 트리   비추천 API   색인   헬프  
JavaTM 2 Platform
Standard Ed. 5.0
 이전 클래스    다음 클래스 프레임으로    프레임 없이    
개요:  NESTED  | 필드  | constructor  | 메서드 상세:  필드  | 생성자  | 메서드

javax.swing
클래스 JViewport

java.lang.Object 
  상위를 확장 java.awt.Component 
      상위를 확장 java.awt.Container 
          상위를 확장 javax.swing.JComponent 
              상위를 확장 javax.swing.JViewport
모든 구현된 인터페이스:
ImageObserver, MenuContainer, Serializable, Accessible 
public class JViewport
extends JComponent 
implements Accessible

기본이 되는 정보를 보기 위해서 사용하는 「뷰포트 (창)」입니다. 스크롤 할 경우에 이동하는 것이 뷰포트입니다. 이것은 카메라의 파인더를 들여다 보는 것에 닮았습니다. 파인더를 위로 향해 움직이면, 새로운 것이 시야의 맨 위에 들어가 맨 밑에 있던 것이 시야로부터 사라집니다.

디폴트에서는 JViewport는 불투명합니다. 이것을 변경하는 경우는 setOpaque 메서드를 사용합니다.

주: 렌더링 할 때에 버퍼를 필요로 하지 않는 고속 스크롤 알고리즘을 구현했습니다. 알고리즘의 기능은 다음과 같습니다.

  1. 뷰와 부모의 뷰를 봐, JComponents 화도인지를 조사한다. 그렇지 않은 경우는 중지해, 뷰포트 전체를 페인트 다시 한다
  2. 뷰포트가 다른 상위 클래스에 의해 숨겨지고 있는 경우는 중지해 뷰포트 전체를 페인트 다시 한다
  3. 표시 가능하게 되는 영역을 계산한다. 뷰포트와 사이즈가 같은 경우는 중지해 영역 전체를 페인트 다시 한다
  4. 상위 클래스의 Window 그래픽를 취득해, 스크롤 한 영역의 copyArea를 페인트 다시 한다
  5. 뷰에 새롭게 표시된 영역을 페인트 다시 하도록 메세지를 보낸다
  6. 다음에 뷰포트에 페인트가 불려 갔을 때에 클리핑 영역이 뷰포트사이즈보다 작은 경우에는 타이머가 개시되고 전체를 페인트 다시 하는
보통, 이 방법 쪽이 현격히 빠르게 할 수 있습니다. 배킹 스토어법과 비교하면, 이 방법은 오프 스크린 버퍼를 유지하는 오버헤드와 copyArea를 2회 실행하는 것을 피할 수 있습니다 . 배킹 스토어 이외의 경우와 비교하면, 페인트 영역을 큰폭으로 삭감할 수 있습니다.

이 방법은 뷰포트가 다른 윈도우로 숨겨지거나 부분적으로 오프 스크린이 되면, 배킹 스토어법보다 속도가 늦어집니다. 다른 윈도우로 뷰포트가 숨겨지면, copyArea는 가비지를 복사해 시스템이 페인트 이벤트를 생성해, 새롭게 출현한 영역을 페인트 할 필요가 있는 것을 알립니다. 이것을 처리하는 유일한 방법은 뷰포트 전체를 페인트 다시 하는 것 입니다. 다만, 배킹 스토어의 경우와 비교해 퍼포먼스가 저하하는 일이 있습니다. 매우 보기 드문 것은 않습니다만, 뷰포트가 다른 윈도우로 숨겨지고 있을 때 사용자가 스크롤 하는 일이 있기 때문에 대부분의 어플리케이션으로 이 최적화 기능은 뷰포트가 숨겨졌을 경우에 유효가 됩니다.

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

관련 항목:
JScrollPane

중첩(Nested) 클래스 개요
protected  class JViewport.AccessibleJViewport
          이 클래스는 JViewport 클래스용의 사용자 보조 기능의 지원를 구현하고 있습니다.
protected  class JViewport.ViewListener
          뷰의 리스너입니다.
 
클래스 javax.swing. JComponent 로부터 상속된 중첩(Nested) 클래스/인터페이스
JComponent.AccessibleJComponent
 
클래스 java.awt. Container 로부터 상속된 중첩(Nested) 클래스/인터페이스
Container.AccessibleAWTContainer
 
클래스 java.awt. Component 로부터 상속된 중첩(Nested) 클래스/인터페이스
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
필드 개요
protected  boolean backingStore
          추천하지 않습니다.  Java 2 플랫폼 v1. 3 이후
static int BACKINGSTORE_SCROLL_MODE
          뷰포트의 컨텐츠를 오프 스크린 이미지에 렌더링 합니다.
protected  Image backingStoreImage
          배킹 스토어에 사용되는 뷰이메이지입니다.
static int BLIT_SCROLL_MODE
          graphics.copyArea()를 사용해 스크롤을 구현합니다.
protected  boolean isViewSizeSet
          뷰포트의 크기가 결정되어 있는 경우에 true를 리턴합니다.
protected  Point lastPaintPosition
          마지막에 페인트 된 viewPosition 입니다.
protected  boolean scrollUnderway
          scrollUnderway 플래그는 JList 등의 컴퍼넌트로 사용됩니다.
static int SIMPLE_SCROLL_MODE
          이 모드는 스크롤 구획을 스크롤 할 때마다 전컨텐츠를 재렌더링 한다고 하는 매우 간단한 메서드를 사용합니다.
 
클래스 javax.swing. JComponent 로부터 상속된 필드
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
 
클래스 java.awt. Component 로부터 상속된 필드
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
인터페이스 java.awt.image. ImageObserver 로부터 상속된 필드
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
생성자 개요
JViewport ()
          JViewport를 생성합니다.
 
메서드 개요
 void addChangeListener (ChangeListener  l)
          뷰의 사이즈, 위치, 또는 뷰포트의 길이가 변경될 때마다 통지되는 리스트에 ChangeListener를 추가합니다.
protected  void addImpl (Component  child, Object  constraints, int index)
          JViewport 1개의 경량인 자식을 설정합니다.
protected  boolean computeBlit (int dx, int dy, Point  blitFrom, Point  blitTo, Dimension  blitSize, Rectangle  blitPaint)
          Blit 파라미터를 계산합니다.
protected  LayoutManager createLayoutManager ()
          사브크라사가 이 메서드를 오버라이드(override) 하면, 생성자 으로 다른 레이아웃 매니저 (또는 null)를 인스톨 할 수 있습니다.
protected  JViewport.ViewListener createViewListener ()
          뷰의 리스너를 생성합니다.
protected  void firePropertyChange (String  propertyName, Object  oldValue, Object  newValue)
          리스너로 프로퍼티의 변경을 통지합니다.
protected  void fireStateChanged ()
          뷰의 사이즈, 위치, 또는 뷰포트의 길이가 변경되면, 모든 ChangeListeners에 통지합니다.
 AccessibleContext getAccessibleContext ()
          이 JViewport에 관련한 AccessibleContext를 리턴합니다.
 ChangeListener [] getChangeListeners ()
          addChangeListener()에 의해 이 JViewport에 추가된 모든 ChangeListener 배열을 리턴합니다.
 Dimension getExtentSize ()
          뷰의 가시 부분의 사이즈를 뷰의 좌표로 리턴합니다.
 Insets getInsets ()
          JViewport에 서는 보더가 지원 되어 있지 않기 때문에 인 세트 (보더)의 크기를 (0,0,0,0)로서 리턴합니다.
 Insets getInsets (Insets  insets)
          이 JViewport 인 세트치를 포함하는 Insets 객체를 리턴합니다.
 int getScrollMode ()
          현재의 스크롤 모드를 리턴합니다.
 ViewportUI getUI ()
          이 컴퍼넌트를 렌더링 하는 L&F 객체를 리턴합니다.
 String getUIClassID ()
          이 컴퍼넌트를 렌더링 하는 L&F 클래스의 이름을 캐릭터 라인으로 리턴합니다.
 Component getView ()
          JViewport 1개의 자식 또는 null을 리턴합니다.
 Point getViewPosition ()
          뷰포트의 좌상구석에 표시되는 뷰의 좌표를 리턴합니다.
 Rectangle getViewRect ()
          기점이 getViewPosition, 사이즈가 getExtentSize인 구형을 리턴합니다.
 Dimension getViewSize ()
          뷰의 사이즈가 명시적으로 설정되어 있지 않은 경우는 적절한 사이즈를 리턴합니다.
 boolean isBackingStoreEnabled ()
          추천하지 않습니다.  Java 2 플랫폼 v1. 3 이후, getScrollMode()로 옮겨졌습니다.
 boolean isOptimizedDrawingEnabled ()
          JViewport는 (JComponent로) 이 메서드의 디폴트 구현을 오버라이드(override) 해, false를 리턴합니다.
 void paint (Graphics  g)
          backingStore가 사용 가능한가 어떤가에 응해, 배킹 스토어를 개입시켜 이미지를 페인트 하는지, 또는 현재 표시되고 있는 부분만큼을 페인트 해, 배킹 스토어를 사용해 나머지의 부분을 「Blit」합니다.
protected  String paramString ()
          이 JViewport 캐릭터 라인 표현을 리턴합니다.
 void remove (Component  child)
          Viewport 1개의 경량인 자식을 삭제합니다.
 void removeChangeListener (ChangeListener  l)
          뷰의 사이즈, 위치, 또는 뷰포트의 길이가 변경될 때마다 통지되는 리스트로부터 ChangeListener를 삭제합니다.
 void repaint (long tm, int x, int y, int w, int h)
          RepaintManager에 의해 paint가 1회 만 실행되도록, 항상 부모의 좌표계로 페인트 다시 합니다.
 void reshape (int x, int y, int w, int h)
          이 뷰포트의 경계를 설정합니다.
 void scrollRectToVisible (Rectangle  contentRect)
          뷰내의 Rectangle가 가시가 되도록 뷰를 스크롤 합니다.
 void setBackingStoreEnabled (boolean enabled)
          추천하지 않습니다.  Java 2 플랫폼 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)를 설정합니다.
 void setViewPosition (Point  p)
          뷰포트의 좌상구석에 표시되는 뷰의 좌표를 설정합니다.
 void setViewSize (Dimension  newSize)
          뷰의 사이즈를 설정합니다.
 Dimension toViewCoordinates (Dimension  size)
          픽셀 좌표의 사이즈를 뷰의 좌표로 변환합니다.
 Point toViewCoordinates (Point  p)
          픽셀 좌표의 포인트를 뷰의 좌표로 변환합니다.
 void updateUI ()
          현재의 Look & Feel 로부터의 값에 UI 프로퍼티를 리셋 합니다.
 
클래스 javax.swing. JComponent 로부터 상속된 메서드
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, revalidate, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
 
클래스 java.awt. Container 로부터 상속된 메서드
add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree
 
클래스 java.awt. Component 로부터 상속된 메서드
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle
 
클래스 java.lang. Object 로부터 상속된 메서드
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

필드의 상세

isViewSizeSet

protected boolean isViewSizeSet
뷰포트의 크기가 결정되어 있는 경우에 true를 리턴합니다. 디폴트는 false 입니다.

lastPaintPosition

protected Point  lastPaintPosition
마지막에 페인트 된 viewPosition 입니다. 배킹 스토어 이미지가 어느 정도 유효한가를 알 수 있습니다.

backingStore

@Deprecated 
protected boolean backingStore
추천하지 않습니다.  Java 2 플랫폼 v1. 3 이후
이 뷰포트가 그 내용의 오프 스크린 이미지를 유지하고 있는 경우에 true를 리턴합니다. 유지되고 있는 경우, 표시를 구축하기 위해서 뷰오브제크트에 액세스 하는 것이 아니라, 고속의 「비트 Blit」처리를 사용해 스크롤을 실행할 수 있습니다. 디폴트는 false 입니다.

관련 항목:
setScrollMode(int)

backingStoreImage

protected transient Image  backingStoreImage
배킹 스토어에 사용되는 뷰이메이지입니다.

scrollUnderway

protected boolean scrollUnderway
scrollUnderway 플래그는 JList 등의 컴퍼넌트로 사용됩니다. JList로 하 커서 키가 밀려 선택되고 있는 셀이 리스트의 마지막 셀인 경우, scrollpane는 오토 스크롤 합니다. 여기서, 선택되고 있던 셀은 페인트 다시 할 필요가 있기 때문에 setViewPosition(Point) 명시적인 호출이 있는 경우에만, 뷰포트가 최적화된 페인트를 하기 위해서 플래그가 필요하게 됩니다. setBounds가 다른 루트를 개입시켜 호출되는 경우, 플래그는 오프가 되어, 뷰는 보통으로 페인트 다시 합니다. 이것과는 별도로JViewport 클래스로부터 이것을 삭제해, setBackingStoreEnabled를 사용해 JList에 이 경우의 제어를 시키는 방법도 있습니다. 디폴트는 false 입니다.

BLIT_SCROLL_MODE

public static final int BLIT_SCROLL_MODE
graphics.copyArea()를 사용해 스크롤을 구현합니다. 이 방법이 대부분의 어플리케이션에 있어 가장 빠른 방법입니다.

도입된 버전 :
1.3
관련 항목:
setScrollMode(int), 정수 필드값

BACKINGSTORE_SCROLL_MODE

public static final int BACKINGSTORE_SCROLL_MODE
뷰포트의 컨텐츠를 오프 스크린 이미지에 렌더링 합니다. 이 방법은 이전에는 JTable 디폴트였습니다. 이 방법은 경우에 따라서는 「Blit 모드」에는 유용할지도 모릅니다만, 상당한 양의 여분의 RAM가 필요합니다.

도입된 버전 :
1.3
관련 항목:
setScrollMode(int), 정수 필드값

SIMPLE_SCROLL_MODE

public static final int SIMPLE_SCROLL_MODE
이 모드는 스크롤 구획을 스크롤 할 때마다 전컨텐츠를 재렌더링 한다고 하는 매우 간단한 메서드를 사용합니다. 이것은 Swing 1.0 및 Swing 1.1 디폴트 동작이었습니다. 대부분의 경우, 다른 2개의 옵션 (모드)은 어느쪽이나 좋은 퍼포먼스를 제공합니다.

도입된 버전 :
1.3
관련 항목:
setScrollMode(int), 정수 필드값
생성자 상세

JViewport

public JViewport()
JViewport를 생성합니다.

메서드의 상세

getUI

public ViewportUI  getUI()
이 컴퍼넌트를 렌더링 하는 L&F 객체를 리턴합니다.

반환값:
ViewportUI 객체

setUI

public void setUI(ViewportUI  ui)
이 컴퍼넌트를 렌더링 하는 L&F 객체를 설정합니다.

파라미터:
ui - ViewportUI L&F 객체
관련 항목:
UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()
현재의 Look & Feel 로부터의 값에 UI 프로퍼티를 리셋 합니다.

오버라이드(override):
클래스 JComponent 내의 updateUI
관련 항목:
JComponent.updateUI()

getUIClassID

public String  getUIClassID()
이 컴퍼넌트를 렌더링 하는 L&F 클래스의 이름을 캐릭터 라인으로 리턴합니다.

오버라이드(override):
클래스 JComponent 내의 getUIClassID
반환값:
캐릭터 라인 「ViewportUI」
관련 항목:
JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

addImpl

protected void addImpl(Component  child,
                       Object  constraints,
                       int index)
JViewport 1개의 경량인 자식을 설정합니다. null도 지정할 수 있습니다. 뷰포트 전체를 차지하는자식는 1개 뿐이므로 인수 constraints 및 index는 무시됩니다.

오버라이드(override):
클래스 Container 내의 addImpl
파라미터:
child - 뷰포트의 경량인 child
constraints - 준수되어야 할 constraints
index - 인덱스
관련 항목:
setView(java.awt.Component)

remove

public void remove(Component  child)
Viewport 1개의 경량인 자식을 삭제합니다.

오버라이드(override):
클래스 Container 내의 remove
파라미터:
child - 삭제되는 컴퍼넌트
관련 항목:
setView(java.awt.Component)

scrollRectToVisible

public void scrollRectToVisible(Rectangle  contentRect)
뷰내의 Rectangle가 가시가 되도록 뷰를 스크롤 합니다.

이 메서드는 스크롤의 전에 뷰를 검증합니다. 뷰가 현재 무효인 경우, isValid가 false를 리턴합니다. 포함 관계의 계층을 작성할 때 과잉인 검증을 피하기 때문에 이 메서드는 피어를 가지지 않는 상위 클래스의 유무, 유효한 루트 클래스의 유무 및 Window 또는 Applet 어느 쪽인지 나오지 않는 상위 클래스의 유무에 대해서는 검증하지 않습니다.

이 메서드는 유효한 뷰포트의 범위외의 스크롤은 실시하지 않습니다. contentRect이 뷰포트보다 큰 경우, 스크롤은 뷰포트 경계의 범위내로 한정됩니다.

오버라이드(override):
클래스 JComponent 내의 scrollRectToVisible
파라미터:
contentRect - 표시하는 Rectangle
관련 항목:
JComponent.isValidateRoot(), Component.isValid(), Component.getPeer()

setBorder

public final void setBorder(Border  border)
뷰포트는 보통 의 부모 또는자식 의 클리핑으로 그자식 ( 「뷰」라고 불린다)를 「스크롤」합니다. 보통, 뷰는 스크롤과는 반대의 방향으로 이동합니다. null 이외의 보더 (또는 0 이외의 인 세트)는 지원 되지 않습니다. 그것은 상속 어렵게 하는 만큼 이 컴퍼넌트의 지오메트리?? 복잡하게 되는 것을 막기 위해입니다. 보더 첨부의 JViewport를 생성하려면, 보더를 가지는 JPanel에 그것을 추가합니다.

주: border가 null 이외의 경우, 이 메서드는 경계가 JViewPort에 서는 지원 되어 있지 않기 때문에 예외를 Throw 합니다.

오버라이드(override):
클래스 JComponent 내의 setBorder
파라미터:
border - 설정하는 Border
예외:
IllegalArgumentException - 이 메서드가 구현되지 않는 경우
관련 항목:
Border, CompoundBorder

getInsets

public final Insets  getInsets()
JViewport에 서는 보더가 지원 되어 있지 않기 때문에 인 세트 (보더)의 크기를 (0,0,0,0)로서 리턴합니다.

오버라이드(override):
클래스 JComponent 내의 getInsets
반환값:
크기 제로 원점 제로의 Rectange
관련 항목:
setBorder(javax.swing.border.Border)

getInsets

public final Insets  getInsets(Insets  insets)
이 JViewport 인 세트치를 포함하는 Insets 객체를 리턴합니다. 건네받은 Insets객체는 다시 초기화되어 이 객체내의 모든 기존의 값은 덧쓰기됩니다.

오버라이드(override):
클래스 JComponent 내의 getInsets
파라미터:
insets - 재이용할 수 있는 Insets 객체
반환값:
이 뷰포트의 인 세트치
관련 항목:
getInsets()

isOptimizedDrawingEnabled

public boolean isOptimizedDrawingEnabled()
JViewport는 (JComponent로) 이 메서드의 디폴트 구현을 오버라이드(override) 해, false를 리턴합니다. 그 결과, 렌더링 장치는 JViewport 자식에 게 직접 메세지를 보내는 것이 아니라, Viewport paint 구현을 호출합니다.

오버라이드(override):
클래스 JComponent 내의 isOptimizedDrawingEnabled
반환값:
false

paint

public void paint(Graphics  g)
backingStore가 사용 가능한가 어떤가에 응해, 배킹 스토어를 개입시켜 이미지를 페인트 하는지, 또는 현재 표시되고 있는 부분만큼을 페인트 해, 배킹 스토어를 사용해 나머지의 부분을 「Blit」합니다.
「Blit」는 PDP-10 BLT (BLock Transfer) 명령여, 비트의 블록을 카피합니다.

오버라이드(override):
클래스 JComponent 내의 paint
파라미터:
g - 페인트 하는 Graphics 컨텍스트
관련 항목:
JComponent.paintComponent(java.awt.Graphics), JComponent.paintBorder(java.awt.Graphics), JComponent.paintChildren(java.awt.Graphics), JComponent.getComponentGraphics(java.awt.Graphics), JComponent.repaint(long, int, int, int, int)

reshape

public void reshape(int x,
                    int y,
                    int w,
                    int h)
이 뷰포트의 경계를 설정합니다. 뷰포트의높이 또는 높이가 변경되었을 경우는 StateChanged 이벤트를 트리거 합니다.

오버라이드(override):
클래스 JComponent 내의 reshape
파라미터:
x - 기점의 좌단
y - 기점의 상단
w - 픽셀 단위의 폭
h - 픽셀 단위의 높이
관련 항목:
JComponent.reshape(int, int, int, int)

setScrollMode

public void setScrollMode(int mode)
뷰포트콘텐트의 스크롤 메서드를 제어하기 위해서 사용합니다. 이 모드를 변경해 최고의 퍼포먼스를 얻는 것을 추천합니다.

파라미터:
mode - 다음의 값의 어떤 것인가
  • JViewport.BLIT_SCROLL_MODE
  • JViewport.BACKINGSTORE_SCROLL_MODE
  • JViewport.SIMPLE_SCROLL_MODE
도입된 버전 :
1.3
관련 항목:
BLIT_SCROLL_MODE, BACKINGSTORE_SCROLL_MODE, SIMPLE_SCROLL_MODE

getScrollMode

public int getScrollMode()
현재의 스크롤 모드를 리턴합니다.

반환값:
scrollMode 프로퍼티
도입된 버전 :
1.3
관련 항목:
setScrollMode(int)

isBackingStoreEnabled

@Deprecated 
public boolean isBackingStoreEnabled()
추천하지 않습니다.  Java 2 플랫폼 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)
Blit 파라미터를 계산합니다. 배킹 스토어 이미지는 현재 좌상구석에 oldLoc를 보관 유지하고 있어, 지금부터 newLoc에 스크롤 합니다. 파라미터는 Blit 로 요구되는 값을 돌려주기 위해서 변경됩니다.

파라미터:
dx - 수평 방향의 델타
dy - 수직 방향의 델타
blitFrom - Blit 원의 Point
blitTo - Blit 처의 Point
blitSize - Blit 하는 영역의 Dimension
blitPaint - Blit 처의 영역
반환값:
파라미터가 변경되고 Blit 준비를 할 수 있었을 경우는 true, 그렇지 않은 경우는 false

getExtentSize

public Dimension  getExtentSize()
뷰의 가시 부분의 사이즈를 뷰의 좌표로 리턴합니다.

반환값:
뷰의 사이즈를 지정하는 Dimension 객체

toViewCoordinates

public Dimension  toViewCoordinates(Dimension  size)
픽셀 좌표의 사이즈를 뷰의 좌표로 변환합니다. 「논리 좌표」를 지원하는 뷰포트의 서브 클래스는 이 메서드를 오버라이드(override) 합니다.

파라미터:
size - 픽셀 좌표를 사용하는 Dimension 객체
반환값:
뷰의 좌표에 변환된 Dimension 객체

toViewCoordinates

public Point  toViewCoordinates(Point  p)
픽셀 좌표의 포인트를 뷰의 좌표로 변환합니다. 「논리 좌표」를 지원하는 뷰포트의 서브 클래스는 이 메서드를 오버라이드(override) 합니다.

파라미터:
p - 픽셀 좌표를 사용하는 Point 객체
반환값:
뷰의 좌표에 변환된 Point 객체

setExtentSize

public void setExtentSize(Dimension  newExtent)
뷰의 좌표를 사용해 뷰의 가시 부분의 사이즈를 설정합니다.

파라미터:
newExtent - 뷰의 사이즈를 지정하는 Dimension 객체

createViewListener

protected JViewport.ViewListener  createViewListener()
뷰의 리스너를 생성합니다.

반환값:
ViewListener

createLayoutManager

protected LayoutManager  createLayoutManager()
사브크라사가 이 메서드를 오버라이드(override) 하면, 생성자 으로 다른 레이아웃 매니저 (또는 null)를 인스톨 할 수 있습니다. JViewport로 인스톨 하는 LayoutManager를 리턴합니다.

반환값:
LayoutManager

addChangeListener

public void addChangeListener(ChangeListener  l)
뷰의 사이즈, 위치, 또는 뷰포트의 길이가 변경될 때마다 통지되는 리스트에 ChangeListener를 추가합니다.

파라미터:
l - 추가하는 ChangeListener
관련 항목:
removeChangeListener(javax.swing.event.ChangeListener), setViewPosition(java.awt.Point), setViewSize(java.awt.Dimension), setExtentSize(java.awt.Dimension)

removeChangeListener

public void removeChangeListener(ChangeListener  l)
뷰의 사이즈, 위치, 또는 뷰포트의 길이가 변경될 때마다 통지되는 리스트로부터 ChangeListener를 삭제합니다.

파라미터:
l - 삭제하는 ChangeListener
관련 항목:
addChangeListener(javax.swing.event.ChangeListener)

getChangeListeners

public ChangeListener [] getChangeListeners()
addChangeListener()에 의해 이 JViewport에 추가된 모든 ChangeListener 배열을 리턴합니다.

반환값:
추가된 모든 ChangeListener, 또는 리스너가 추가되어 있지 않은 경우는 비어있는 배열
도입된 버전 :
1.4

fireStateChanged

protected void fireStateChanged()
뷰의 사이즈, 위치, 또는 뷰포트의 길이가 변경되면, 모든 ChangeListeners에 통지합니다.

관련 항목:
addChangeListener(javax.swing.event.ChangeListener), removeChangeListener(javax.swing.event.ChangeListener), EventListenerList

repaint

public void repaint(long tm,
                    int x,
                    int y,
                    int w,
                    int h)
RepaintManager에 의해 paint가 1회 만 실행되도록, 항상 부모의 좌표계로 페인트 다시 합니다.

오버라이드(override):
클래스 JComponent 내의 repaint
파라미터:
tm - 갱신까지의 최대 시간 (밀리 세컨드)
x - x 좌표 (왼쪽으로부터의 픽셀수)
y - y 좌표 (위로부터의 픽셀수)
w - 폭
h - 높이
관련 항목:
Component.update(java.awt.Graphics)

paramString

protected String  paramString()
이 JViewport 캐릭터 라인 표현을 리턴합니다. 이 메서드는 디버그 전용이며, 리턴된 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 리턴된 캐릭터 라인은 비어있는 경우가 있습니다만, null로는 되지 않습니다.

오버라이드(override):
클래스 JComponent 내의 paramString
반환값:
이 JViewport 캐릭터 라인 표현

firePropertyChange

protected void firePropertyChange(String  propertyName,
                                  Object  oldValue,
                                  Object  newValue)
리스너로 프로퍼티의 변경을 통지합니다. 이것을 상속해 windowBlit 프로퍼티를 갱신합니다. putClientProperty 프로퍼티는 final 입니다.

오버라이드(override):
클래스 Component 내의 firePropertyChange
파라미터:
propertyName - 프로퍼티명이 포함되고 있는 캐릭터 라인
oldValue - 프로퍼티의 변경전의 값
newValue - 프로퍼티의 변경 후의 값

getAccessibleContext

public AccessibleContext  getAccessibleContext()
이 JViewport에 관련한 AccessibleContext를 리턴합니다. 뷰포트의 경우, AccessibleContext는 AccessibleJViewport 형식을 취합니다. 필요에 따라서 새로운의 AccessibleJViewport 인스턴스가 작성됩니다.

정의:
인터페이스 Accessible 내의 getAccessibleContext
오버라이드(override):
클래스 JComponent 내의 getAccessibleContext
반환값:
이 JViewport AccessibleContext 로서 기능하는 AccessibleJViewport
개요   패키지    클래스  사용   계층 트리   비추천 API   색인   헬프  
JavaTM 2 Platform
Standard Ed. 5.0
 이전 클래스    다음 클래스 프레임으로    프레임 없이    
개요:  NESTED  | 필드  | constructor  | 메서드 상세:  필드  | 생성자  | 메서드

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조하십시오.