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 를 사용할 필요가 있을지가 판정됩니다.

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

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 가 설정됩니다.

컨텐츠에 따라서는, 하이퍼 링크 이벤트를 생성하는 것에 의해 하이퍼 링크의 지원를 제공합니다. 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 의 draw 방법의 커스터마이즈에 대해서는,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 오퍼레이션에 의해 throw 되는 ChangedCharSetException 를 캐치 할 필요가 있습니다. read 자체는 ChangedCharSetException (IOException)로 지정된 캐릭터 세트를 사용하는 새로운 리더로 다시 개시됩니다.

개행

개행의 처리 방법에 대해서는,DefaultEditorKit 를 참조해 주세요.

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

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

상자의 클래스의 개요

protected class	JEditorPane.AccessibleJEditorPane 이 클래스는 JEditorPane 클래스용의 접근성? 지원를 구현하고 있습니다.
protected class	JEditorPane.AccessibleJEditorPaneHTML 이 클래스는 AccessibleHypertext 의 지원를 제공해,JEditorPane 에 인스톨 된 EditorKit 가 HTMLEditorKit 의 인스턴스인 경우에, 그 인스턴스로 사용됩니다.
protected class	JEditorPane.JEditorPaneAccessibleHypertextSupport AccessibleJEditorPaneHTML.getAccessibleText 에 의해 반환되는 것을 가져옵니다.

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

JTextComponent.AccessibleJTextComponent , JTextComponent.DropLocation , JTextComponent.KeyBinding

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

필드의 개요

static String	HONOR_DISPLAY_PROPERTIES 폰트 또는 foreground 칼라가 서식 첨부 텍스트로 지정되어 있지 않은 경우에, 컴퍼넌트의 디폴트의 폰트 및 foreground 칼라를 사용할지 어떨지를 나타내기 위해서(때문에) 사용하는, 클라이언트 프로퍼티의 키입니다.
static String	W3C_LENGTH_UNITS HTML 의 draw로,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 , getDropLocation , getDropMode , getFocusAccelerator , getHighlighter , getInputMethodRequests , getKeymap , getKeymap , getMargin , getNavigationFilter , getPreferredScrollableViewportSize , getPrintable , getScrollableBlockIncrement , getScrollableUnitIncrement , getSelectedText , getSelectedTextColor , getSelectionColor , getSelectionEnd , getSelectionStart , getText , getToolTipText , getUI , isEditable , loadKeymap , modelToView , moveCaretPosition , paste , print , print , print , processInputMethodEvent , read , removeCaretListener , removeKeymap , removeNotify , select , selectAll , setCaret , setCaretColor , setCaretPosition , setComponentOrientation , setDisabledTextColor , setDocument , setDragEnabled , setDropMode , 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 , 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 , getRegisteredKeyStrokes , getRootPane , getSize , getToolTipLocation , getToolTipText , getTopLevelAncestor , getTransferHandler , getVerifyInputWhenFocusTarget , getVetoableChangeListeners , getVisibleRect , getWidth , getX , getY , grabFocus , isDoubleBuffered , isLightweightComponent , isManagingFocus , isOpaque , isOptimizedDrawingEnabled , isPaintingForPrint , 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 의 draw로,w3c 준거의 길이 유니트가 사용될지 어떨지를 나타내기 위해서(때문에) 사용하는, 클라이언트 프로퍼티의 키입니다.

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

도입된 버젼:

1.5

관련 항목:

정수 필드치

HONOR_DISPLAY_PROPERTIES

public static final String  HONOR_DISPLAY_PROPERTIES

폰트 또는 foreground 칼라가 서식 첨부 텍스트로 지정되어 있지 않은 경우에, 컴퍼넌트의 디폴트의 폰트 및 foreground 칼라를 사용할지 어떨지를 나타내기 위해서(때문에) 사용하는, 클라이언트 프로퍼티의 키입니다.

디폴트 값는, 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, 청취자가 추가되어 있지 않은 경우는 빈 상태(empty)의 배열

도입된 버젼:

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 가 throw 되는 경우, 부분적으로 로드 된 문서는 파기되어 문서 프로퍼티 변경 이벤트도 페이지 프로퍼티 변경 이벤트도 트리거되지 않습니다. 문서가 정상적으로 로드 및 인스톨 되었을 경우, 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 - read원의 스트림

desc - 스트림을 기술하는 객체

예외:

IOException - 초기화에 사용되는 스트림에 의해 throw 되는

관련 항목:

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 접속의 경우, 계속되어 리다이렉트(redirect)를 해 결과적으로 얻을 수 있는 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)

현재 선택되고 있는 컨텐츠를, 건네받은 캐릭터 라인이 가리키는 새로운 컨텐츠로 옮겨놓습니다. 선택 영역이 없는 경우는, 지정된 텍스트의 삽입과 동등합니다. 옮겨놓는 텍스트가 없는 경우, 즉, 컨텐츠 캐릭터 라인이 빈 상태(empty), 또는 null 의 경우는, 현재의 선택 영역의 삭제를 실시합니다. 치환 후의 텍스트에는, 입력용에 현재 정의되고 있는 속성이 설정됩니다. 컴퍼넌트를 편집할 수 없는 상태이면, beep음을 울려 종료합니다.

이 메소드는 thread에 대해서 안전합니다만, 대부분의 Swing 메소드는 다릅니다. 자세한 것은,「How to Use Threads」를 참조해 주세요.

오버라이드(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 메소드는 다릅니다. 자세한 것은,「How to Use Threads」를 참조해 주세요.

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

오버라이드(override):

클래스 JTextComponent 내의 paramString

반환값:

이 JEditorPane 의 캐릭터 라인 표현

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 JEditorPane 에 관련한 AccessibleContext 를 가져옵니다. 에디터 구획의 경우, AccessibleContext 는 AccessibleJEditorPane 의 형식을 취합니다. 필요에 따라서 신규의 AccessibleJEditorPane 인스턴스가 생성됩니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 JTextComponent 내의 getAccessibleContext

반환값:

이 JEditorPane 의 AccessibleContext 로서 기능하는 AccessibleJEditorPane