javax.swing
클래스 JEditorPane

java.lang.Object 
  |
  +--java.awt.Component 
        |
        +--java.awt.Container 
              |
              +--javax.swing.JComponent 
                    |
                    +--javax.swing.text.JTextComponent 
                          |
                          +--javax.swing.JEditorPane

모든 구현 인터페이스:

Accessible , ImageObserver , MenuContainer , Scrollable , Serializable

직계의 기존의 서브 클래스:

JTextPane

public class JEditorPane

extends JTextComponent

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

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

디폴트에서는 다음의 컨텐츠 타입에 대응하고 있습니다.

text/plain

plaintext. 지정된 타입을 인식할 수 없는 경우의 디폴트. 이 경우에 사용되는 킷은 랩 된 프레인테키스트뷰를 생성하는 DefaultEditorKit 의 확장

text/html

HTML 텍스트. 이 경우에 사용되는 킷은 HTML 3.2 를 서포트하는 javax.swing.text.html.HTMLEditorKit 클래스

text/rtf

RTF 텍스트. 이 경우에 사용되는 킷은 리치 텍스트 형식을 제한부로 서포트하는 javax.swing.text.rtf.RTFEditorKit 클래스

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

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

표준의 Look & Feel (L&F) 표현으로 이 컴퍼넌트가 사용하는 키보드의 키에 대해서는 「JeditorPane 의 키의 할당」 을 참조해 주세요.

컨텐츠에 따라서는 하이퍼 링크 이벤트를 생성하는 것에 의해 하이퍼 링크의 서포트를 제공합니다. 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();
 		          }
 		      }
 	          }
 	      }
     }
 

문서내의 문화 의존 정보는 캐릭터 인코딩으로 불리는 기구에 의해 다루어집니다. 캐릭터 인코딩이란, 캐릭터 세트의 원가요소 (캐릭터, 표의 문자, 숫자, 기호, 제어 캐릭터)와 특정의 수치 코드의 명시적인 매핑이며, 파일에의 보존 방법을 나타냅니다. 캐릭터 인코딩에는 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)로 지정된 캐릭터 세트를 사용하는 새로운 리더로 다시 개시된다

Newlines

newlines 의 처리 방법에 대해서는 「DefaultEditorKit」 를 참조해 주세요.

경고: 이 클래스의 직렬화 오브젝트는 향후 릴리스 되는 Swing 와의 호환성은 없습니다. 현재 서포트되고 있는 직렬화는 단기간의 보관, 또는 같은 버젼의 Swing 가 가동하고 있는 어플리케이션간의 RMI 에 적절하고 있습니다. 1.4 로부터는 모든 JavaBeans^TM 의 장기간의 보관이 java.beans 패키지로 추가 서포트되고 있습니다. XMLEncoder 를 참조해 주세요.

중첩된 클래스의 개요

protected class	JEditorPane.AccessibleJEditorPane 이 클래스는 JEditorPane 클래스용의 유저 보조 기능의 서포트를 구현하고 있습니다.
protected class	JEditorPane.AccessibleJEditorPaneHTML 이 클래스는 AccessibleHypertext 의 서포트를 제공해,JEditorPane 에 인스톨 된 EditorKit 가 HTMLEditorKit 의 인스턴스인 경우에, 그 인스턴스로 사용됩니다.
protected class	JEditorPane.JEditorPaneAccessibleHypertextSupport AccessibleJEditorPaneHTML.getAccessibleText 가 돌려주는 값에 의해, 이 JEditorPane 에 표시되고 있는 HTML 문서가 있는 경우는 AccessibleHypertext 의 서포트가 가능하게 됩니다.

클래스 javax.swing.text. JTextComponent 을 상속받은 중첩된 클래스

JTextComponent.KeyBinding

클래스 javax.swing. JComponent 을 상속받은 중첩된 클래스

클래스 java.awt. Container 을 상속받은 중첩된 클래스

클래스 java.awt. Component 을 상속받은 중첩된 클래스

Component.BltBufferStrategy , Component.FlipBufferStrategy

필드의 개요

클래스 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 , addPropertyChangeListener , addPropertyChangeListener , addVetoableChangeListener , computeVisibleRect , contains , createToolTip , disable , enable , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , fireVetoableChange , getActionForKeyStroke , getActionMap , getAlignmentX , getAlignmentY , getAncestorListeners , getAutoscrolls , getBorder , getBounds , getClientProperty , getComponentGraphics , getConditionForKeyStroke , getDebugGraphicsOptions , getDefaultLocale , getGraphics , getHeight , getInputMap , getInputMap , getInputVerifier , getInsets , getInsets , getListeners , getLocation , getMaximumSize , getMinimumSize , getNextFocusableComponent , getPropertyChangeListeners , getPropertyChangeListeners , getRegisteredKeyStrokes , getRootPane , getSize , getToolTipLocation , getToolTipText , getTopLevelAncestor , getTransferHandler , getVerifyInputWhenFocusTarget , getVetoableChangeListeners , getVisibleRect , getWidth , getX , getY , grabFocus , isDoubleBuffered , isLightweightComponent , isManagingFocus , isMaximumSizeSet , isMinimumSizeSet , isOpaque , isOptimizedDrawingEnabled , isPaintingTile , isPreferredSizeSet , isRequestFocusEnabled , isValidateRoot , paint , paintBorder , paintChildren , paintComponent , paintImmediately , paintImmediately , print , printAll , printBorder , printChildren , printComponent , processComponentKeyEvent , processKeyBinding , processKeyEvent , processMouseMotionEvent , putClientProperty , registerKeyboardAction , registerKeyboardAction , removeAncestorListener , removePropertyChangeListener , removePropertyChangeListener , removeVetoableChangeListener , repaint , repaint , requestDefaultFocus , requestFocus , requestFocus , requestFocusInWindow , requestFocusInWindow , resetKeyboardActions , reshape , revalidate , scrollRectToVisible , setActionMap , setAlignmentX , setAlignmentY , setAutoscrolls , setBackground , setBorder , setDebugGraphicsOptions , setDefaultLocale , setDoubleBuffered , setEnabled , setFont , setForeground , 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 , applyComponentOrientation , areFocusTraversalKeysSet , countComponents , deliverEvent , doLayout , findComponentAt , findComponentAt , getComponent , getComponentAt , getComponentAt , getComponentCount , getComponents , getContainerListeners , getFocusTraversalKeys , getFocusTraversalPolicy , getLayout , insets , invalidate , isAncestorOf , isFocusCycleRoot , isFocusCycleRoot , isFocusTraversalPolicySet , layout , list , list , locate , minimumSize , paintComponents , preferredSize , printComponents , processContainerEvent , processEvent , remove , remove , removeAll , removeContainerListener , setFocusCycleRoot , setFocusTraversalKeys , setFocusTraversalPolicy , 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 , getBackground , getBounds , getColorModel , getComponentListeners , getComponentOrientation , getCursor , getDropTarget , getFocusCycleRootAncestor , getFocusListeners , getFocusTraversalKeysEnabled , getFont , getFontMetrics , getForeground , getGraphicsConfiguration , getHierarchyBoundsListeners , getHierarchyListeners , getIgnoreRepaint , getInputContext , getInputMethodListeners , getKeyListeners , getLocale , getLocation , getLocationOnScreen , getMouseListeners , getMouseMotionListeners , getMouseWheelListeners , getName , getParent , getPeer , getSize , getToolkit , getTreeLock , gotFocus , handleEvent , hasFocus , hide , imageUpdate , inside , isBackgroundSet , isCursorSet , isDisplayable , isEnabled , isFocusable , isFocusOwner , isFocusTraversable , isFontSet , isForegroundSet , isLightweight , 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 , processMouseEvent , processMouseWheelEvent , remove , removeComponentListener , removeFocusListener , removeHierarchyBoundsListener , removeHierarchyListener , removeInputMethodListener , removeKeyListener , removeMouseListener , removeMouseMotionListener , removeMouseWheelListener , 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

생성자의 상세

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 메소드를 호출하는 간이 constructor 입니다.

파라미터:

type - 지정된 텍스트의 MIME 형식

text - 초기화에 사용하는 텍스트

예외:

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 가 현재 표시되어 있지 않은 경우,getStream 메소드가 불려 가 지정된 스트림에 대한 제어가 서브 클래스에게 건네집니다.

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

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

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

파라미터:

page - 페이지의 URL

예외:

IOException - null 또는 무효인 페이지가 지정되었을 경우, 혹은 읽어들여 안의 스트림으로부터 예외가 발생했을 경우

관련 항목:

getPage()

read

public void read(InputStream  in,
                 Object  desc)
          throws IOException 

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

파라미터:

in - read원의 스트림

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 이외를 지정

관련 항목:

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)

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

이 메소드는 thread에 대해서 안전합니다만, 대부분의 Swing 메소드는 안전하지는 않습니다. 자세한 것은 「Threads and Swing」를 참조해 주세요.

오버라이드(override):

클래스 JTextComponent 내의 replaceSelection

파라미터:

content - 선택 area와 옮겨놓는 컨텐츠. 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 - 설정하는 새로운 텍스트

관련 항목:

getText()

getText

public String  getText()

이 TextComponent 에 저장되고 있는 텍스트를 이 에디터의 컨텐츠 타입으로 돌려줍니다. 텍스트의 취득시에 예외가 슬로우 되었을 경우는 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