Класс HTMLDocument

Дополнительные комментарии

public static final String AdditionalComments

См. также:

• Значения постоянных полей

HTMLDocument

public HTMLDocument()

HTMLDocument

public HTMLDocument(StyleSheet styles)

Параметры:

styles - стили

HTMLDocument

public HTMLDocument(AbstractDocument.Content c, StyleSheet styles)

Параметры:

c - контейнер для содержимого

styles - стили

getReader

public HTMLEditorKit.ParserCallback getReader(int pos)

Параметры:

pos - начальная позиция

Возвращает:

ридер, используемый парсером для загрузки документа

getReader

public HTMLEditorKit.ParserCallback getReader(int pos, int popDepth, int pushDepth, HTML.Tag insertTag)

Параметры:

pos - начальная позиция

popDepth - количество ElementSpec.EndTagTypes для генерации перед вставкой

pushDepth - количество ElementSpec.StartTagTypes с направлением ElementSpec.JoinNextDirection, которое должно быть сгенерировано перед вставкой, но после генерации закрывающих тегов

insertTag - первый тег для начала вставки в документ

Возвращает:

ридер, используемый парсером для загрузки документа

getBase

public URL getBase()

Возвращает:

базовое расположение

setBase

public void setBase(URL u)

Параметры:

u - желаемый базовый URL-адрес

insert

protected void insert(int offset, DefaultStyledDocument.ElementSpec[] data) throws BadLocationException

Переопределяет:

insert в классе DefaultStyledDocument

Параметры:

offset - начальный смещение

data - данные элемента

Исключения:

BadLocationException - если заданная позиция не представляет собой допустимое расположение в связанном документе.

insertUpdate

protected void insertUpdate(AbstractDocument.DefaultDocumentEvent chng, AttributeSet attr)

Переопределяет:

insertUpdate в классе DefaultStyledDocument

Параметры:

chng - описание изменения документа

attr - атрибуты

create

protected void create(DefaultStyledDocument.ElementSpec[] data)

Переопределяет:

create в классе DefaultStyledDocument

Параметры:

data - новое содержимое документа

setParagraphAttributes

public void setParagraphAttributes(int offset, int length, AttributeSet s, boolean replace)

Указано в:

setParagraphAttributes в интерфейсе StyledDocument

Переопределяет:

setParagraphAttributes в классе DefaultStyledDocument

Параметры:

offset - смещение в абзаце (должно быть не меньше 0)

length - количество затронутых символов (должно быть не меньше 0)

s - атрибуты

replace - заменить существующие атрибуты или объединить их

getStyleSheet

public StyleSheet getStyleSheet()

Возвращает:

StyleSheet

getIterator

public HTMLDocument.Iterator getIterator(HTML.Tag t)

Параметры:

t - запрашиваемый HTML.Tag

Возвращает:

Iterator для данного тега HTML

См. также:

• HTML.Tag

createLeafElement

protected Element createLeafElement(Element parent, AttributeSet a, int p0, int p1)

Переопределяет:

createLeafElement в классе AbstractDocument

Параметры:

parent - родительский элемент

a - атрибуты для элемента

p0 - начало диапазона (должно быть не меньше 0)

p1 - конец диапазона (должно быть не меньше p0)

Возвращает:

новый элемент

createBranchElement

protected Element createBranchElement(Element parent, AttributeSet a)

Переопределяет:

createBranchElement в классе AbstractDocument

Параметры:

parent - родительский элемент

a - атрибуты

Возвращает:

элемент

createDefaultRoot

protected AbstractDocument.AbstractElement createDefaultRoot()

Переопределяет:

createDefaultRoot в классе DefaultStyledDocument

Возвращает:

базовый элемент

setTokenThreshold

public void setTokenThreshold(int n)

Параметры:

n - количество токенов для буферизации

getTokenThreshold

public int getTokenThreshold()

Возвращает:

количество токенов для буферизации

setPreservesUnknownTags

public void setPreservesUnknownTags(boolean preservesTags)

Parameters:

preservesTags - true, если неизвестные теги должны сохраняться в модели, в противном случае теги отбрасываются

See Also:

• HTML.Tag

getPreservesUnknownTags

public boolean getPreservesUnknownTags()

Returns:

true, если неизвестные теги должны сохраняться при разборе

See Also:

• HTML.Tag

processHTMLFrameHyperlinkEvent

public void processHTMLFrameHyperlinkEvent(HTMLFrameHyperlinkEvent e)

Parameters:

e - событие

setParser

public void setParser(HTMLEditorKit.Parser parser)

Parameters:

parser - анализатор, который будет использоваться для вставки текста

Since:

1.3

getParser

public HTMLEditorKit.Parser getParser()

Returns:

используемый анализатор для вставки текста

Since:

1.3

setInnerHTML

public void setInnerHTML(Element elem, String htmlText) throws BadLocationException, IOException

     <body>
       |
     <div>
      /  \
    <p>   <p>
 

     <body>
       |
     <div>
         \
         <ul>
           \
           <li>
 

Parameters:

elem - элемент ветвления, потомки которого будут заменены

htmlText - строка, которая будет обработана и назначена elem

Throws:

IllegalArgumentException - если elem является листом

IllegalStateException - если анализатор HTMLEditorKit.Parser не определён

BadLocationException - если замена невозможна из-за структурной проблемы

IOException - если произошла ошибка ввода-вывода

Since:

1.3

setOuterHTML

public void setOuterHTML(Element elem, String htmlText) throws BadLocationException, IOException

     <body>
       |
     <div>
      /  \
    <p>   <p>
 

    <body>
      |
     <ul>
       \
       <li>
 

Parameters:

elem - элемент, который нужно заменить

htmlText - строка, которая будет обработана и вставлена вместо elem

Throws:

IllegalStateException - если анализатор HTMLEditorKit.Parser не установлен

BadLocationException - если замена невозможна из-за структурной проблемы

IOException - если произошла ошибка ввода-вывода

Since:

1.3

insertAfterStart

public void insertAfterStart(Element elem, String htmlText) throws BadLocationException, IOException

     <body>
       |
     <div>
      /  \
    <p>   <p>
 

        <body>
          |
        <div>
       /  |  \
    <ul> <p> <p>
     /
  <li>
 

Parameters:

elem - элемент ветвления, который будет корнем для нового текста

htmlText - строка, которая будет обработана и назначена elem

Throws:

IllegalArgumentException - если elem является листом

IllegalStateException - если анализатор HTMLEditorKit.Parser не установлен в документе

BadLocationException - если вставка невозможна из-за структурной проблемы

IOException - если произошла ошибка ввода-вывода

Since:

1.3

insertBeforeEnd

public void insertBeforeEnd(Element elem, String htmlText) throws BadLocationException, IOException

     <body>
       |
     <div>
      /  \
    <p>   <p>
 

        <body>
          |
        <div>
       /  |  \
     <p> <p> <ul>
               \
               <li>
 

Parameters:

elem - элемент, который будет корнем для нового текста

htmlText - строка, которая будет обработана и назначена elem

Throws:

IllegalArgumentException - если elem является листом

IllegalStateException - если анализатор HTMLEditorKit.Parser не установлен в документе

BadLocationException - если вставка невозможна из-за структурной проблемы

IOException - если произошла ошибка ввода-вывода

Since:

1.3

insertBeforeStart

public void insertBeforeStart(Element elem, String htmlText) throws BadLocationException, IOException

     <body>
       |
     <div>
      /  \
    <p>   <p>
 

        <body>
         /  \
      <ul> <div>
       /    /  \
     <li> <p>  <p>
 

Parameters:

elem - элемент, перед которым вставляется содержимое

htmlText - строка, которая должна быть обработана и вставлена перед elem

Throws:

IllegalStateException - если для документа не установлен HTMLEditorKit.Parser

BadLocationException - если вставка невозможна из-за структурной проблемы

IOException - если произошла ошибка ввода-вывода

Since:

1.3

insertAfterEnd

public void insertAfterEnd(Element elem, String htmlText) throws BadLocationException, IOException

     <body>
       |
     <div>
      /  \
    <p>   <p>
 

        <body>
         /  \
      <div> <ul>
       / \    \
     <p> <p>  <li>
 

Parameters:

elem - элемент, после которого вставляется содержимое

htmlText - строка, которая должна быть обработана и вставлена после elem

Throws:

IllegalStateException - если для документа не установлен HTMLEditorKit.Parser

BadLocationException - если вставка невозможна из-за структурной проблемы

IOException - если произошла ошибка ввода-вывода

Since:

1.3

getElement

public Element getElement(String id)

Parameters:

id - строка, представляющая искомый Attribute

Returns:

элемент с указанным Attribute или null, если он не найден, или null, если id равен null

Since:

1.3

See Also:

• HTML.Attribute

getElement

public Element getElement(Element e, Object attribute, Object value)

Parameters:

e - корневой элемент, с которого начинается поиск

attribute - искомый Attribute

value - значения для указанного Attribute

Returns:

элемент с указанным Attribute и указанным value, или null, если он не найден

Since:

1.3

See Also:

• HTML.Attribute

fireChangedUpdate

protected void fireChangedUpdate(DocumentEvent e)

Overrides:

fireChangedUpdate в классе AbstractDocument

Parameters:

e - событие

See Also:

• EventListenerList

fireUndoableEditUpdate

protected void fireUndoableEditUpdate(UndoableEditEvent e)

Overrides:

fireUndoableEditUpdate в классе AbstractDocument

Parameters:

e - событие

See Also:

• EventListenerList