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

javax.swing
클래스 JEditorPane

java.lang.Object 
  상위를 확장 java.awt.Component 
      상위를 확장 java.awt.Container 
          상위를 확장 javax.swing.JComponent 
              상위를 확장 javax.swing.text.JTextComponent 
                  상위를 확장 javax.swing.JEditorPane
모든 구현된 인터페이스:
ImageObserver, MenuContainer, Serializable, Accessible, Scrollable
알려진 직계 서브 클래스:
JTextPane 
public class JEditorPane
extends JTextComponent

다양한 종류의 컨텐츠를 편집하기 위한 텍스트 컴퍼넌트입니다. 사용 방법 및 에디터 구획의 예에 대해서는 「The Java Tutorial」의 「Using Text Components」를 참조하십시오.

이 컴퍼넌트는 EditorKit 구현을 사용해 동작합니다. 지정된 컨텐츠의 종류에 대응해 적절한 종류의 텍스트 편집기로서 동작합니다. 어떤 시점에 에디터로 설정되는 컨텐츠형은 현재 인스톨 되고 있는 EditorKit에 의해 정해집니다. 컨텐츠가 새로운 URL 로 설정되었을 경우, 그 형태를 사용해, 그 컨텐츠를 로드하는데 어느 EditorKit를 사용할 필요가 있을지가 판정됩니다.

이 컴퍼넌트에는 다음과 같은 방법으로 컨텐츠를 로드할 수 있습니다.

  1. setText 메서드를 사용하면, 캐릭터 라인으로부터 컴퍼넌트를 초기화할 수 있다. 이 경우 현재의 EditorKit이 사용되어 컨텐츠형은 이 EditorKit 형태인 것이 요구된다
  2. read 메서드를 사용하면, Reader로 부터 컴퍼넌트를 초기화할 수 있다. 컨텐츠형이 HTML인 경우, <base> 태그가 사용되지 않은지, 또는 HTMLDocument로 Base 프로퍼티가 설정되어 있지 않으면 이미지등의 상대 참조를 해결을 할 수 없다. 이 경우 현재의 EditorKit이 사용되어 컨텐츠형은 이 EditorKit 형태인 것이 요구된다
  3. setPage 메서드를 사용하면, URL 로부터 컴퍼넌트를 초기화할 수 있다. 이 경우 컨텐츠형은 URL 로부터 판단되어 그 컨텐츠형에 등록되어 있는 EditorKit이 설정된다

컨텐츠에 따라서는 하이퍼 링크 이벤트를 생성하는 것에 의해 하이퍼 링크의 지원를 제공합니다. HTML EditorKit는 JEditorPane가 「편집 가능하지 않다」경우, 즉 JEditorPane.setEditable(false);가 불려가 고 있는 경우에 하이퍼 링크 이벤트를 생성합니다. 문서에 HTML 프레임이 파묻히고 있는 경우, 일반적으로 현재의 문서의 일부가 변경됩니다. 다음의 코드 fragment는 하이퍼 링크 리스너의 구현예입니다. 이 코드의 경우, HTML 프레임 이벤트에는 특별한 처리를 실시합니다만, 다른 모든 활성화된 하이퍼 링크는 단지 표시될 뿐입니다. 


     class Hyperactive implements HyperlinkListener {
 
         public void hyperlinkUpdate(HyperlinkEvent e) {
             if (e.getEventType() == HyperlinkEvent.EventType.ACTIVATED) {
                 JEditorPane pane = (JEditorPane) e.getSource();
                 if (e instanceof HTMLFrameHyperlinkEvent) {
                     HTMLFrameHyperlinkEvent  evt = (HTMLFrameHyperlinkEvent) e;
                     HTMLDocument doc = (HTMLDocument) pane.getDocument();
                     doc.processHTMLFrameHyperlinkEvent(evt);
                 } else {
                     try {
                         pane.setPage(e.getURL());
                     } catch (Throwable t) {
                         t.printStackTrace();
                     }
                 }
             }
         }
     }

text/html 렌더링의 커스터마이즈에 대해서는 W3C_LENGTH_UNITS 및 HONOR_DISPLAY_PROPERTIES를 참조하십시오.

문서내의 문화 존 정보는 캐릭터 세트로 불리는 도구에 의해 다루어집니다. 캐릭터 세트란 캐릭터 세트의 원가요소 (문자, 표의 문자, 숫자, 기호, 제어 문자)와 특정의 수치 코드의 명시적인 매핑이며, 파일에의 보존 방법을 나타냅니다. 캐릭터 세트에는 ISO-8859-1, ISO-8859-5, Shift-jis, Euc-jp, UTF-8 등이 있습니다. 파일은 사용자 에이전트 (JEditorPane)에게 건네질 때, 문서의 캐릭터 세트 (ISO-10646, 별명 Unicode)에 변환됩니다.

JEditorPane로 사용되는 캐릭터 세트를 지정하는 방법은 다수 있습니다.

  1. 1개의 방법은 캐릭터 세트를 MIME 형식의 파라미터로서 지정하는 것. 이 방법에서는 setContentType 메서드를 호출할 필요가 있다. 컨텐츠가 setPage 메서드에 의해 로드 되는 경우, 컨텐츠형은 URL 지정에 따라 설정된다. 파일이 직접 로드 되는 경우, 컨텐츠형은 로드의 앞으로 설정될 필요가 있다.
  2. 캐릭터 세트를 지정하기 위한 이제(이미 ) 1개의 방법은 문서 자체에 있어, 이 경우 목적의 캐릭터 세트를 지정하기 전에 문서를 읽어들일 필요가 있다. 이것을 처리하기 위해서는 EditorKit read 오퍼레이션에 의해 발생되는 ChangedCharSetException을 캐치 할 필요가 있다. read 자체는 ChangedCharSetException (IOException)로 지정된 캐릭터 세트를 사용하는 새로운 리더로 다시 개시된다

개행
개행의 처리 방법에 대해서는 DefaultEditorKit 를 참조하십시오.

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

중첩(Nested) 클래스 개요
protected  class JEditorPane.AccessibleJEditorPane
          이 클래스는 JEditorPane 클래스용의 사용자 보조 기능의 지원를 구현하고 있습니다.
protected  class JEditorPane.AccessibleJEditorPaneHTML
          이 클래스는 AccessibleHypertext 지원를 제공해, JEditorPane에 인스톨 된 EditorKit이 HTMLEditorKit 인스턴스인 경우에 그 인스턴스로 사용됩니다.
protected  class JEditorPane.JEditorPaneAccessibleHypertextSupport
          AccessibleJEditorPaneHTML.getAccessibleText에 의해 리턴된 것을 취득합니다.
 
클래스 javax.swing.text. JTextComponent 로부터 상속된 중첩(Nested) 클래스/인터페이스
JTextComponent.AccessibleJTextComponent, JTextComponent.KeyBinding
 
클래스 javax.swing. JComponent 로부터 상속된 중첩(Nested) 클래스/인터페이스
JComponent.AccessibleJComponent
 
클래스 java.awt. Container 로부터 상속된 중첩(Nested) 클래스/인터페이스
Container.AccessibleAWTContainer
 
클래스 java.awt. Component 로부터 상속된 중첩(Nested) 클래스/인터페이스
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
필드 개요
static String HONOR_DISPLAY_PROPERTIES
          폰트나 전경색이 서식 첨부 텍스트로 지정되지 않는 경우에 컴퍼넌트의 디폴트 폰트 및 전경색을 사용하는지를 나타내는 클라이언트 프로퍼티를 위한 키입니다.
static String W3C_LENGTH_UNITS
          HTML 렌더링에 w3c 준거의 길이의 단위가 사용되고 있는지를 나타내는 클라이언트 프로퍼티를 위한 키입니다.
 
클래스 javax.swing.text. JTextComponent 로부터 상속된 필드
DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY
 
클래스 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
 
생성자 개요
JEditorPane ()
          새로운 JEditorPane를 생성합니다.
JEditorPane (String  url)
          URL 지정을 나타내는 캐릭터 라인을 기본으로 해, JEditorPane를 생성합니다.
JEditorPane (String  type, String  text)
          지정된 텍스트에 초기화되고 있는 JEditorPane를 생성합니다.
JEditorPane (URL  initialPage)
          입력을 위해서 지정된 URL를 기본으로 해, JEditorPane을 생성합니다.
 
메서드 개요
 void addHyperlinkListener (HyperlinkListener  listener)
          변경의 통지를 위해서 하이퍼 링크 리스너를 추가합니다.
protected  EditorKit createDefaultEditorKit ()
          컴퍼넌트가 처음으로 생성될 때, 디폴트의 에디터 킷 (PlainEditorKit)을 생성합니다.
static EditorKit createEditorKitForContentType (String  type)
          에디터 킷의 디폴트의 레지스트리로부터, 지정된 컨텐츠형의 핸들러를 생성합니다.
 void fireHyperlinkUpdate (HyperlinkEvent  e)
          이 형태의 이벤트의 통지를, 등록되어 있는 모든 리스너에게 통지합니다.
 AccessibleContext getAccessibleContext ()
          이 JEditorPane에 관련한 AccessibleContext를 취득합니다.
 String getContentType ()
          이 에디터가 처리하도록 현재 설정되어 있는 컨텐츠형을 취득합니다.
 EditorKit getEditorKit ()
          컨텐츠의 처리를 위해서 현재 인스톨 되고 있는 킷을 리턴합니다.
static String getEditorKitClassNameForContentType (String  type)
          형태 type에 현재 등록되어 있는 EditorKit 클래스명을 리턴합니다.
 EditorKit getEditorKitForContentType (String  type)
          지정된 컨텐츠형으로 사용하는 에디터 킷을 꺼냅니다.
 HyperlinkListener [] getHyperlinkListeners ()
          addHyperlinkListener()를 사용해, 이 JEditorPane에 추가된 모든 HyperLinkListener 배열을 리턴합니다.
 URL getPage ()
          표시되고 있는 현재의 URL를 리턴합니다.
 Dimension getPreferredSize ()
          JEditorPane 적절한 사이즈를 리턴합니다.
 boolean getScrollableTracksViewportHeight ()
          뷰포트가 항상 이 Scrollable 높이를 강제적으로 뷰포트의 높이로 일치시키는 경우에 true를 리턴합니다.
 boolean getScrollableTracksViewportWidth ()
          뷰포트가 항상 이 Scrollable 넓이를 강제적으로 뷰포트의 폭에 일치시키는 경우에 true를 리턴합니다.
protected  InputStream getStream (URL  page)
          setPage 메서드에 의해 로드 되려고 하고 있는 지정된 URL 스트림을 리턴합니다.
 String getText ()
          이 TextComponent에 포함되고 있는 텍스트를 이 에디터의 컨텐츠형으로 리턴합니다.
 String getUIClassID ()
          UI 클래스 ID를 리턴합니다.
protected  String paramString ()
          이 JEditorPane 캐릭터 라인 표현을 리턴합니다.
 void read (InputStream  in, Object  desc)
          이 메서드는 스트림로부터 초기화를 실시합니다.
static void registerEditorKitForContentType (String  type, String  classname)
          type와 classname 디폴트의 바인딩을 작성합니다.
static void registerEditorKitForContentType (String  type, String  classname, ClassLoader  loader)
          type와 classname 디폴트의 바인딩을 작성합니다.
 void removeHyperlinkListener (HyperlinkListener  listener)
          하이퍼 링크 리스너를 삭제합니다.
 void replaceSelection (String  content)
          현재 선택되고 있는 컨텐츠를, 지정된 캐릭터 라인으로 나타내지는 새로운 컨텐츠와 옮겨놓습니다.
 void scrollToReference (String  reference)
          지정된 참조 위치 (표시되고 있는 URL에 대한 URL.getRef 메서드에 의해 리턴된 값)까지 뷰를 스크롤 합니다.
 void setContentType (String  type)
          이 에디터가 처리하는 컨텐츠형을 설정합니다.
 void setEditorKit (EditorKit  kit)
          컨텐츠의 처리를 위해서 현재 인스톨 되고 있는 킷을 설정합니다.
 void setEditorKitForContentType (String  type, EditorKit  k)
          지정된 컨텐츠형으로 사용할 수 있도록 에디터 킷을 직접 설정합니다.
 void setPage (String  url)
          표시되고 있는 현재의 URL를 설정합니다.
 void setPage (URL  page)
          표시되고 있는 현재의 URL를 설정합니다.
 void setText (String  t)
          이 TextComponent 텍스트를, 지정된 컨텐츠로 설정합니다.
 
클래스 javax.swing.text. JTextComponent 로부터 상속된 메서드
addCaretListener, addInputMethodListener, addKeymap, copy, cut, fireCaretUpdate, getActions, getCaret, getCaretColor, getCaretListeners, getCaretPosition, getDisabledTextColor, getDocument, getDragEnabled, getFocusAccelerator, getHighlighter, getInputMethodRequests, getKeymap, getKeymap, getMargin, getNavigationFilter, getPreferredScrollableViewportSize, getScrollableBlockIncrement, getScrollableUnitIncrement, getSelectedText, getSelectedTextColor, getSelectionColor, getSelectionEnd, getSelectionStart, getText, getToolTipText, getUI, isEditable, loadKeymap, modelToView, moveCaretPosition, paste, processInputMethodEvent, read, removeCaretListener, removeKeymap, removeNotify, select, selectAll, setCaret, setCaretColor, setCaretPosition, setComponentOrientation, setDisabledTextColor, setDocument, setDragEnabled, setEditable, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setNavigationFilter, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setUI, updateUI, viewToModel, write
 
클래스 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, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, 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, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree
 
클래스 java.awt. Component 로부터 상속된 메서드
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, 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, 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, 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
 

필드의 상세

W3C_LENGTH_UNITS

public static final String  W3C_LENGTH_UNITS
HTML 렌더링에 w3c 준거의 길이의 단위가 사용되고 있는지를 나타내는 클라이언트 프로퍼티를 위한 키입니다.

디폴트에서는 무효입니다. 유효하게 하려면 이 이름의 클라이언트 property를 Boolean.TRUE로 설정합니다.

도입된 버전 :
1.5
관련 항목:
정수 필드값

HONOR_DISPLAY_PROPERTIES

public static final String  HONOR_DISPLAY_PROPERTIES
폰트나 전경색이 서식 첨부 텍스트로 지정되지 않는 경우에 컴퍼넌트의 디폴트 폰트 및 전경색을 사용하는지를 나타내는 클라이언트 프로퍼티를 위한 키입니다.

디폴트는 Look & Feel에 따라서 다릅니다. 유효하게 하려면 이 이름의 클라이언트 property를 Boolean.TRUE로 설정합니다.

도입된 버전 :
1.5
관련 항목:
정수 필드값
생성자 상세

JEditorPane

public JEditorPane()
새로운 JEditorPane를 생성합니다. 문서 모델은 null로 설정됩니다.

JEditorPane

public JEditorPane(URL  initialPage)
            throws IOException
입력을 위해서 지정된 URL를 기본으로 해, JEditorPane를 생성합니다.

파라미터:
initialPage - URL
예외:
IOException - URL가 null인지, 액세스 할 수 없는 경우

JEditorPane

public JEditorPane(String  url)
            throws IOException
URL 지정을 나타내는 캐릭터 라인을 기본으로 해, JEditorPane를 생성합니다.

파라미터:
url - URL
예외:
IOException - URL가 null인지, 액세스 할 수 없는 경우

JEditorPane

public JEditorPane(String  type,
                   String  text)
지정된 텍스트에 초기화되고 있는 JEditorPane를 생성합니다. 이것은, setContentType 메서드 및 setText 메서드를 호출하는 간이 생성자 입니다.

파라미터:
type - 지정된 텍스트의 MIME 형식
text - 초기화에 사용하는 텍스트. null인 경우도 있다
예외:
NullPointerException - type 파라미터가 null인 경우
메서드의 상세

addHyperlinkListener

public void addHyperlinkListener(HyperlinkListener  listener)
변경의 통지를 위해서 하이퍼 링크 리스너를 추가합니다. 예를 들어 링크를 선택했을 때, 링크에 들어왔을 때등이 있습니다.

파라미터:
listener - 리스너

removeHyperlinkListener

public void removeHyperlinkListener(HyperlinkListener  listener)
하이퍼 링크 리스너를 삭제합니다.

파라미터:
listener - 리스너

getHyperlinkListeners

public HyperlinkListener [] getHyperlinkListeners()
addHyperlinkListener()를 사용해, 이 JEditorPane에 추가된 모든 HyperLinkListener 배열을 리턴합니다.

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

fireHyperlinkUpdate

public void fireHyperlinkUpdate(HyperlinkEvent  e)
이 형태의 이벤트의 통지를, 등록되어 있는 모든 리스너에게 통지합니다. 일반적으로 하이퍼 링크를 지원 하고 있는 컨텐츠형이 현재 액티브하고, 링크가 사용되었을 경우에 현재 인스톨 되고 있는 EditorKit에 의해 호출합니다. 리스너의 리스트는 말미로부터 선두에의 순서로 처리됩니다.

파라미터:
e - 이벤트
관련 항목:
EventListenerList

setPage

public void setPage(URL  page)
             throws IOException
표시되고 있는 현재의 URL를 설정합니다. 구획의 컨텐츠형이 설정되어 구획의 에디터 킷이 null 이외의 경우, 새로운 디폴트 문서가 생성되어 URL가 그 문서에 읽힙니다. URL에 참조 위값이 포함되어 있는 경우는 scrollToReference 메서드를 호출하면, 그 참조 위치까지 스크롤 됩니다. 목적의 URL가 현재 표시되고 있는 경우는 문서는 재로드 되지 않습니다. 문서의 재로드를 강제적으로 실행하려면, 문서의 스트림 기술 프로퍼티를 클리어 할 필요가 있습니다. 다음의 코드는 이 방법을 나타내고 있습니다. 

Document doc = jEditorPane.getDocument();
doc.putProperty(Document.StreamDescriptionProperty, null);
목적의 URL가 현재 표시되어 있지 않은 경우, getStream 메서드가 불려가 지정된 스트림에 대한 제어가 서브 클래스에게 건네집니다.

이 메서드는 EditorKit에 의해 리턴된 문서에 근거해 동기적 또는 비동기적으로 로드를 실시합니다. 문서가 AbstractDocument 형으로AbstractDocument.getAsynchronousLoadPriority에 의해 리턴된 제로 이상의 값을 가지는 경우, 그 페이지는 그 우선 순위에 의해 다른 thread로 로드 됩니다.

문서가 동기적으로 로드 되는 경우, 문서를 프로퍼티 변경 이벤트에 관련지어 트리거 하는 setDocument이 불려가 에디터에 인스톨 되기 전에 이 문서에 스트림이 설정됩니다. IOException가 발생되는 경우, 부분적으로 로드 된 문서는 파기되어 문서 프로퍼티 변경 이벤트도 페이지 프로퍼티 변경 이벤트도 트리거 되지 않습니다. 문서가 정상적으로 로드 및 인스톨 되었을 경우, UI에 의해 그 문서의 뷰가 생성되어 필요한 경우는 또한 스크롤 되어, 페이지 프로퍼티 변경 이벤트가 트리거 됩니다.

문서가 비동기적으로 로드 되는 경우, 문서 프로퍼티 변경 이벤트를 트리거 하는 setDocument를 호출해 문서가 즉시 에디터에 인스톨 되어 다음에 실제의 로드를 개시하는 thread가 생성됩니다. 이 경우 페이지 프로퍼티 변경 이벤트는 이 메서드의 호출에 의해 직접 트리거 될 것은 없고, 로드를 실행하는 thread가 종료했을 때에 트리거 됩니다. 호출측의 thread는 이제 한편의 thread로 에러가 발생했을 경우에 IOException을 Throw 할 수 없기 때문에 로드가 성공했는지 어떠했는지에 관계없이, 페이지 프로퍼티 변경 이벤트는 이제(이미 ) 한편의 thread가 종료했을 때에 트리거 됩니다.

파라미터:
page - 페이지의 URL
예외:
IOException - null 또는 무효인 페이지가 지정되었을 경우, 혹은 읽기 안의 스트림로부터 예외가 발생했을 경우
관련 항목:
getPage()

read

public void read(InputStream  in,
                 Object  desc)
          throws IOException
이 메서드는 스트림로부터 초기화를 실시합니다. 킷이 HTMLEditorKit 형으로 설정되어 있는 경우, desc 파라미터가 HTMLDocument 때는 이 메서드는 HTMLEditorKit를 호출하는 것으로 read를 개시합니다. 그렇지 않은 경우는 plaintext로서 모델을 로드하는 슈퍼 클래스 메서드를 호출합니다.

파라미터:
in - 읽을 스트림
desc - 스트림을 기술하는 객체
예외:
IOException - 초기화에 사용되는 스트림에 의해 발생되는
관련 항목:
JTextComponent.read(java.io.Reader, java.lang.Object), JTextComponent.setDocument(javax.swing.text.Document)

getStream

protected InputStream  getStream(URL  page)
                         throws IOException
setPage 메서드에 의해 로드 되려고 하고 있는 지정된 URL 스트림을 리턴합니다. 디폴트에서는 이 메서드는 단지 URL를 오픈해, 스트림을 리턴합니다. 이 메서드를 다시 구현하면, 캐쉬로부터의 스트림의 꺼내, 스트림의 진척 상황의 감시등이 편리한 기능을 실행할 수 있습니다.

이 메서드는 컨텐츠형을 확립해, 그 결과적으로 스트림의 로드에 사용하는 적절한 EditorKit를 설정한다고 생각됩니다.

이 스트림이 http 접속의 경우, 계속되어 리다이렉트를의해 그 결과 얻을 수 있는 URL 가 상대 URL를 적절히 해결할 수 있도록 Document.StreamDescriptionProperty로 서 설정됩니다.

파라미터:
page - 페이지의 URL
예외:
IOException

scrollToReference

public void scrollToReference(String  reference)
지정된 참조 위치 (표시되고 있는 URL에 대한 URL.getRef 메서드에 의해 리턴된 값)까지 뷰를 스크롤 합니다. 디폴트에서는 이 메서드는 HTMLDocument 내에서의 참조 위치를 인식하고 있을 뿐입니다. 실제의 스크롤 처리를 실행하려면, 구현에 의해 scrollRectToVisible 메서드를 호출합니다. HTML 이외의 문서 형식에서 참조 위값의 스크롤이 필요한 경우는 이 메서드를 재구현할 필요가 있습니다. 이 메서드는 컴퍼넌트가 가시 상태가 아닌 경우는 무효입니다.

파라미터:
reference - 스크롤처가 되는 지정된 위치

getPage

public URL  getPage()
표시되고 있는 현재의 URL를 리턴합니다. 이 문서의 작성으로 URL가 지정되지 않았던 경우는 null을 돌려주고, 상대 URL는 해결되지 않습니다.

반환값:
URL. 지정되어 있지 않은 경우는 null

setPage

public void setPage(String  url)
             throws IOException
표시되고 있는 현재의 URL를 설정합니다.

파라미터:
url - 표시되고 있는 URL
예외:
IOException - null 또는 무효인 URL 지정의 경우

getUIClassID

public String  getUIClassID()
UI 클래스 ID를 리턴합니다.

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

createDefaultEditorKit

protected EditorKit  createDefaultEditorKit()
컴퍼넌트가 처음으로 생성될 때, 디폴트의 에디터 킷 (PlainEditorKit)을 생성합니다.

반환값:
에디터 킷

getEditorKit

public EditorKit  getEditorKit()
컨텐츠의 처리를 위해서 현재 인스톨 되고 있는 킷을 리턴합니다. 필요한 경우는 디폴트의 에디터 킷의 셋업을 위해서 createDefaultEditorKit이 호출됩니다.

반환값:
에디터 킷

getContentType

public final String  getContentType()
이 에디터가 처리하도록 현재 설정되어 있는 컨텐츠형을 취득합니다. 이것은 현재 인스톨 되고 있는 EditorKit에 관련한 형태가 되도록 정의되고 있습니다.

반환값:
컨텐츠형. 에디터 킷이 설정되어 있지 않은 경우는 null

setContentType

public final void setContentType(String  type)
이 에디터가 처리하는 컨텐츠형을 설정합니다. 이 메서드는 getEditorKitForContentType를 호출해, 에디터 킷이 올바르게 검출할 수 있으면 setEditorKit를 호출합니다. 이 메서드는 setEditorKit 직접 호출 대신에 사용할 수 있는 간이 메서드와 거의 같습니다.

컨텐츠형 지정의 파라미터로서 캐릭터 세트의 정의가 가리키는 경우, 관련된 EditorKit를 사용해 입력 스트림을 로드할 때는 그 캐릭터 세트가 사용됩니다. 예를 들어 형태가 text/html; charset=EUC-JP로 서 가리키는 경우, 컨텐츠는 text/html에 등록되어 있는 EditorKit를 사용해 로드 되어 문서에 Unicode를 로드하기 위해서 EditorKit에 제공되는 리더는 Unicode 에의 변환을 위해서 EUC-JP 캐릭터 세트를 사용합니다. 형태를 식별할 수 없는 경우는 컨텐츠는 plaintext text/plain에 등록된 EditorKit를 사용해 로드 됩니다.

파라미터:
type - 컨텐츠를 편집하기 위한 MIME 타입. null 이외를 지정
예외:
NullPointerException - type 파라미터가 null인 경우
관련 항목:
getContentType()

setEditorKit

public void setEditorKit(EditorKit  kit)
컨텐츠의 처리를 위해서 현재 인스톨 되고 있는 킷을 설정합니다. 이것은 에디터의 컨텐츠형을 설정하는 바운드 프로퍼티입니다. 최초로 이전의 킷을 삭제하고 있어, 킷이 null이 아닌 경우, 새로운 킷이 인스톨 되어 디폴트 문서가 생성됩니다. setEditorKit이 불려가 면, 항상 PropertyChange 이벤트 (editorKit)가 트리거 됩니다.

주: EditorKit는 특정의 형태의 컨텐츠를 모델화하는 소스이기 때문에 모델을 변경한다고 하는 부작용이 있습니다. 이 메서드를 사용하면, 내부 상태의 정합성을 보증하기 위해서 호출 측에 대신 setDocument이 호출됩니다.

파라미터:
kit - 바람직한 에디터 동작
관련 항목:
getEditorKit()

getEditorKitForContentType

public EditorKit  getEditorKitForContentType(String  type)
지정된 컨텐츠형으로 사용하는 에디터 킷을 꺼냅니다. 이 메서드는 현재 인스톨 되고 있는 컨텐츠형에 일치하지 않는 형태가 요구되었을 때에 호출합니다. 컴퍼넌트에 지정된 형태에 대해서 등록되어 있는 EditorKit이 없는 경우는 디폴트의 EditorKit 레지스트리로부터 EditorKit 생성을 시도합니다. 생성할 수 없었던 경우는 모든 텍스트 문서를 plaintext로서 표시할 수 있는 것과 가정해, PlainEditorKit이 사용됩니다.

이 메서드는 타종의 컨텐츠형 레지스트리를 사용하기 위해서 재구현할 수 있습니다. 이 메서드를 재구현하면, 예를 들어 Java Activation Framework를 사용할 수 있게 됩니다.

파라미터:
type - null이 아닌 컨텐츠형
반환값:
에디터 킷

setEditorKitForContentType

public void setEditorKitForContentType(String  type,
                                       EditorKit  k)
지정된 컨텐츠형으로 사용할 수 있도록 에디터 킷을 직접 설정합니다. Look & Feel (L&F)의 구현에 따라서는 이 메서드를 createEditorKitForContentType와 함께 사용해, Look & Feel (L&F)를 고려한 컨텐츠형의 핸들러를 인스톨 하는 일이 있습니다.

파라미터:
type - null이 아닌 컨텐츠형
k - 설정하는 에디터 킷

replaceSelection

public void replaceSelection(String  content)
현재 선택되고 있는 컨텐츠를, 지정된 캐릭터 라인으로 나타내지는 새로운 컨텐츠와 옮겨놓습니다. 선택 영역이 없는 경우, 지정된 텍스트의 삽입을 실시합니다. 옮겨놓는 텍스트가 없는 경우, 즉, 컨텐츠 캐릭터 라인이 공백, 또는 null인 경우는 현재의 선택 영역의 삭제를 실시합니다. 치환 후의 텍스트에는 입력용에 현재 정의되고 있는 속성이 설정됩니다. 컴퍼넌트를 편집할 수 없는 상태이면, beep음을 울려 종료합니다.

이 메서드는 thread 세이프입니다만, 대부분의 Swing 메서드는 다릅니다. 자세한 내용은 「Threads and Swing」를 참조하십시오.

오버라이드(override):
클래스 JTextComponent 내의 replaceSelection
파라미터:
content - 선택 영역과 옮겨놓는 컨텐츠. null도 가능

createEditorKitForContentType

public static EditorKit  createEditorKitForContentType(String  type)
에디터 킷의 디폴트의 레지스트리로부터, 지정된 컨텐츠형의 핸들러를 생성합니다. 레지스트리는 필요에 따라서 생성됩니다. 등록되어 있는 클래스가 아직 로드되어 있지 않은 경우는 지정된 형용의 에디터 킷의 prototype를 동적으로 로드하려고 합니다. 형태가 ClassLoader와 함께 등록되어 있었을 경우는 그 ClassLoader를 사용해 prototype가 로드 됩니다. 등록되어 있는 ClassLoader가 없었던 경우는 Class.forName를 사용해 prototype가 로드 됩니다.

prototype EditorKit 인스턴스가 올바르게 검출되면, 그 인스턴스가 복제되어 그 복제가 리턴됩니다 .

파라미터:
type - 컨텐츠형
반환값:
에디터 킷. 지정된 형태에 아무것도 등록되지 않은 경우는 null

registerEditorKitForContentType

public static void registerEditorKitForContentType(String  type,
                                                   String  classname)
type와 classname 디폴트의 바인딩을 작성합니다. 클래스는 나중에 실제로 필요하게 되었을 때에 동적으로 로드 되어 실제의 사용전에 안전하게 변경할 수 있으므로 불필요한 클래스의 로드를 피할 수 있습니다 . prototype EditorKit는 이 메서드로 등록되었을 때에 Class.forName로 로드 됩니다.

파라미터:
type - null이 아닌 컨텐츠형
classname - 나중에 로드하는 클래스

registerEditorKitForContentType

public static void registerEditorKitForContentType(String  type,
                                                   String  classname,
                                                   ClassLoader  loader)
type와 classname 디폴트의 바인딩을 작성합니다. 클래스는 나중에 실제로 필요하게 되었을 때에 지정된 ClassLoader를 사용해 동적으로 로드 되어 실제의 사용전에 안전하게 변경할 수 있기 때문에 불필요한 클래스의 로드를 피할 수 있습니다 .

파라미터:
type - null이 아닌 컨텐츠형
classname - 나중에 로드하는 클래스
loader - 이름을 로드하기 위한 ClassLoader

getEditorKitClassNameForContentType

public static String  getEditorKitClassNameForContentType(String  type)
형태 type에 현재 등록되어 있는 EditorKit 클래스명을 리턴합니다.

파라미터:
type - null이 아닌 컨텐츠형
도입된 버전 :
1.3

getPreferredSize

public Dimension  getPreferredSize()
JEditorPane 적절한 사이즈를 리턴합니다. JEditorPane 적절한 사이즈는 슈퍼 클래스의 적절한 사이즈와 조금 다릅니다. 뷰포트의 사이즈가 컴퍼넌트의 최소 사이즈보다 작아졌을 경우,높이 또는 높이를 트럭하기 위한 scrollable 정의가 false 로 바뀝니다. 디폴트의 뷰포트레이아우트는 적절한 사이즈를 리턴합니다만, 이 사이즈는 scrollable가 트랙킹 하고 있는 경우에는 적절하지는 않습니다. 그 경우, 「보통 의」적절한 사이즈가 최소 사이즈에 맞추어 조정됩니다. 이것에 의해 HTML 테이블 등은 최소 사이즈에 축소되어 그 사이즈로 배치됩니다. 최소 사이즈보다 작아질 것은 없습니다.

오버라이드(override):
클래스 JComponent 내의 getPreferredSize
반환값:
적절한 사이즈를 보관 유지하는 Dimension
관련 항목:
JComponent.setPreferredSize(java.awt.Dimension), ComponentUI

setText

public void setText(String  t)
이 TextComponent 텍스트를, 지정된 컨텐츠로 설정합니다. 설정되는 컨텐츠는 이 에디터의 컨텐츠형이 될 필요가 있습니다. 예를 들어 형태가 text/html로 설정되어 있는 경우, 캐릭터 라인은 HTML 형식에서 지정됩니다.

현재의 문서의 컨텐츠를 삭제해, 현재의 EditorKit를 사용해 지정된 캐릭터 라인을 해석해 컨텐츠를 옮겨놓도록 구현됩니다. 이것에 의해 컴퍼넌트에 현재 설정되어 있는 컨텐츠형을 지원 하면서, 모델을 변경하지 않고 슈퍼 클래스의 시멘틱스가 지정됩니다. 전의 컨텐츠가 비교적 작고, 부작용이 없는 것이 전제가 됩니다. 일전에제가 어느쪽이나 지켜질 수 없는 경우, 예기치 않은 결과를 일으키는 일이 있습니다. 이것을 피하기 위해서 새로운 문서 getEditorKit(). createDefaultDocument()를 생성해, 기존의 Document를 새로운 것에 옮겨놓습니다. 이것으로 전의 Document이 어중간한 상태가 될 것은 없습니다.

  1. 기존의 모델을 사용 가능대로의해 두면, 낡은 뷰가 티아다운 되어 새로운 뷰가 작성된다. 이것에 대해서 문서를 옮겨놓으면 낡은 뷰의 티아다운을 피할 수가 있다
  2. HTML 등의 몇개의 형식은 장래의 컨텐츠에 영향을 내리는 문서에 컨텐츠를 인스톨 할 수 있다. HTML 형식의 경우는 스타일 정보를 묻어, 다음의 컨텐츠가 예상외의 상황으로 인스톨 되었을 때에 영향을 줄 수가 있다

캐릭터 라인과 함께 컴퍼넌트를 로드하는 이제(이미 ) 1개의 방법에는 StringReader를 생성해 read 메서드를 호출하는 것이 있습니다. 이 방법의 경우, 모델은 초기화가 완료하면 캐릭터 라인의 컨텐츠로 옮겨집니다.

이 메서드는 thread 세이프입니다만, 대부분의 Swing 메서드는 다릅니다. 자세한 내용은 「Threads and Swing」를 참조하십시오.

오버라이드(override):
클래스 JTextComponent 내의 setText
파라미터:
t - 설정하는 새로운 텍스트. null인 경우는 낡은 텍스트가 삭제되는
관련 항목:
getText()

getText

public String  getText()
이 TextComponent에 포함되고 있는 텍스트를 이 에디터의 컨텐츠형으로 리턴합니다. 텍스트의 취득시에 예외가 Throw 되었을 경우는 null이 리턴됩니다 . 이 메서드를 구현하면, StringWriter 으로 JTextComponent.write를 호출할 수 있습니다 .

오버라이드(override):
클래스 JTextComponent 내의 getText
반환값:
텍스트
관련 항목:
setText(java.lang.String)

getScrollableTracksViewportWidth

public boolean getScrollableTracksViewportWidth()
뷰포트가 항상 이 Scrollable 넓이를 강제적으로 뷰포트의 폭에 일치시키는 경우에 true를 리턴합니다.

정의:
인터페이스 Scrollable 내의 getScrollableTracksViewportWidth
오버라이드(override):
클래스 JTextComponent 내의 getScrollableTracksViewportWidth
반환값:
뷰포트가 Scrollable 넓이를 그 자체의 폭과 강제적으로 일치시키는 경우는 true, 그 외의 경우는 false

getScrollableTracksViewportHeight

public boolean getScrollableTracksViewportHeight()
뷰포트가 항상 이 Scrollable 높이를 강제적으로 뷰포트의 높이로 일치시키는 경우에 true를 리턴합니다.

정의:
인터페이스 Scrollable 내의 getScrollableTracksViewportHeight
오버라이드(override):
클래스 JTextComponent 내의 getScrollableTracksViewportHeight
반환값:
뷰포트가 Scrollable 높이를 그 자체의 높이와 강제적으로 일치시키는 경우는 true, 그 외의 경우는 false

paramString

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

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

getAccessibleContext

public AccessibleContext  getAccessibleContext()
이 JEditorPane에 관련한 AccessibleContext를 취득합니다. 에디터 구획의 경우, AccessibleContext는 AccessibleJEditorPane 형식을 취합니다. 필요에 따라서 새로운의 AccessibleJEditorPane 인스턴스가 생성됩니다.

정의:
인터페이스 Accessible 내의 getAccessibleContext
오버라이드(override):
클래스 JTextComponent 내의 getAccessibleContext
반환값:
이 JEditorPane AccessibleContext 로서 기능하는 AccessibleJEditorPane
개요   패키지    클래스  사용   계층 트리   비추천 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 도 참조하십시오.