Класс MinimalHTMLWriter

public class MinimalHTMLWriter
extends AbstractWriter

MinimalHTMLWriter — это вспомогательный писатель, используемый HTMLEditorKit для вывода HTML для документа, который не был создан EditorKit. Формат документа:

<html>
   <head>
     <style>
        <!-- list of named styles
         p.normal {
            font-family: SansSerif;
            margin-height: 0;
            font-size: 14
         }
        -->
      </style>
   </head>
   <body>
    <p style=normal>
        Bold, italic, and underline attributes
        of the run are emitted as HTML tags.
        The remaining attributes are emitted as
        part of the style attribute of a <span> tag.
        The syntax is similar to inline styles.
    </p>
   </body>
 </html>

Поля

Поля, объявленные в классе javax.swing.text.AbstractWriter

NEWLINE

Конструкторы

Конструктор Описание
MinimalHTMLWriter​(Writer w, StyledDocument doc)

Создаёт новый MinimalHTMLWriter.

MinimalHTMLWriter​(Writer w, StyledDocument doc, int pos, int len)

Создаёт новый MinimalHTMLWriter.

Методы

Модификатор и тип Метод Описание
protected void endFontTag()

Этот метод больше не используется, вместо него будет выводиться <span>.

protected boolean inFontTag()

Возвращает true, если мы находимся внутри тега <font>.

protected boolean isText​(Element elem)

Возвращает true, если элемент — это текстовый элемент.

protected void startFontTag​(String style)

Этот метод больше не используется, вместо него будет выводиться <span>.

protected void text​(Element elem)

Выводит текст.

void write()

Генерирует HTML-вывод из StyledDocument.

protected void writeAttributes​(AttributeSet attr)

Выводит все атрибуты для следующих типов: StyleConstants.ParagraphConstants, StyleConstants.CharacterConstants, StyleConstants.FontConstants, StyleConstants.ColorConstants.

protected void writeBody()

Итерируется по элементам в документе и обрабатывает элементы в зависимости от того, являются ли они элементами ветвления или листа.

protected void writeComponent​(Element elem)

Ответственный за обработку элементов Component; намеренно не реализован.

protected void writeContent​(Element elem, boolean needsIndenting)

Выводит набор атрибутов в соответствии с HTML.

protected void writeEndParagraph()

Выводит закрывающий тег для тега <p>.

protected void writeEndTag​(String endTag)

Выводит закрывающий тег с соответствующим отступом.

protected void writeHeader()

Выводит теги <head> и <style>, а затем вызывает writeStyles() для вывода всех именованных стилей в качестве содержимого тега <style>.

protected void writeHTMLTags​(AttributeSet attr)

Генерирует теги <b>, <i> и <u> для текста, основываясь на его атрибутах.

protected void writeImage​(Element elem)

Ответственный за обработку элементов Icon; намеренно не реализован.

protected void writeLeaf​(Element elem)

Ответственный за вывод других элементов листа, не являющихся текстовыми.

protected void writeNonHTMLAttributes​(AttributeSet attr)

Выводит оставшиеся атрибуты уровня символов (атрибуты, отличные от полужирного, курсива и подчеркивания) в соответствии с HTML.

protected void writeStartParagraph​(Element elem)

Выводит открывающий тег для абзаца.

protected void writeStartTag​(String tag)

Выводит открывающий тег с соответствующим отступом.

protected void writeStyles()

Выводит все именованные стили в качестве содержимого тега <style>.

Методы, объявленные в классе javax.swing.text.AbstractWriter

decrIndent, getCanWrapLines, getCurrentLineLength, getDocument, getElementIterator, getEndOffset, getIndentLevel, getIndentSpace, getLineLength, getLineSeparator, getStartOffset, getText, getWriter, incrIndent, indent, inRange, isLineEmpty, output, setCanWrapLines, setCurrentLineLength, setIndentSpace, setLineLength, setLineSeparator, write, write, write, writeLineSeparator

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Конструкторы

MinimalHTMLWriter

public MinimalHTMLWriter(Writer w,
                         StyledDocument doc)

Создаёт новый MinimalHTMLWriter.

Параметры:
w - Поток вывода
doc - StyledDocument

MinimalHTMLWriter

public MinimalHTMLWriter(Writer w,
                         StyledDocument doc,
                         int pos,
                         int len)

Создаёт новый MinimalHTMLWriter.

Параметры:
w - Поток вывода
doc - StyledDocument
pos - Местоположение в документе для извлечения содержимого.
len - Количество для записи.

Методы

write

public void write()
           throws IOException,
                  BadLocationException

Генерирует HTML-вывод из StyledDocument.

Указано в:
write в классе AbstractWriter
Исключения:
IOException - при любой ошибке ввода-вывода
BadLocationException - если pos представляет недопустимое местоположение в документе.

writeAttributes

protected void writeAttributes(AttributeSet attr)
                        throws IOException

Выводит все атрибуты для следующих типов: StyleConstants.ParagraphConstants, StyleConstants.CharacterConstants, StyleConstants.FontConstants, StyleConstants.ColorConstants. Имя и значение атрибута разделены двоеточием. Каждая пара разделена точкой с запятой.

Переопределяет:
writeAttributes в классе AbstractWriter
Параметры:
attr - набор атрибутов.
Исключения:
IOException - при любой ошибке ввода-вывода

text

protected void text(Element elem)
             throws IOException,
                    BadLocationException

Выводит текст.

Переопределяет:
text в классе AbstractWriter
Параметры:
elem - элемент.
Исключения:
IOException - при любой ошибке ввода-вывода
BadLocationException - если pos представляет недопустимое местоположение в документе.

writeStartTag

protected void writeStartTag(String tag)
                      throws IOException

Выводит открывающий тег с соответствующим отступом. Также увеличивает уровень отступа.

Параметры:
tag - открывающий тег
Исключения:
IOException - при любой ошибке ввода-вывода

writeEndTag

protected void writeEndTag(String endTag)
                    throws IOException

Выводит закрывающий тег с соответствующим отступом. Также уменьшает уровень отступа.

Параметры:
endTag - закрывающий тег
Исключения:
IOException - при любой ошибке ввода-вывода

writeHeader

protected void writeHeader()
                    throws IOException

Выводит теги <head> и <style>, а затем вызывает writeStyles(), чтобы вывести все именованные стили в качестве содержимого тега <style>. Содержимое окружено допустимыми маркерами комментариев HTML, чтобы обеспечить отображение документа в приложениях/браузерах, не поддерживающих этот тег.

Исключения:
IOException - при любой ошибке ввода-вывода

writeStyles

protected void writeStyles()
                    throws IOException

Выводит все именованные стили как содержимое тега <style>.

Исключения:
IOException - при любой ошибке ввода-вывода

writeBody

protected void writeBody()
                  throws IOException,
                         BadLocationException

Перебирает элементы в документе и обрабатывает элементы в зависимости от того, являются ли они элементами ветвления или листовыми элементами. Этот метод специально обрабатывает листовые элементы, которые являются текстом.

Исключения:
IOException - при любой ошибке ввода-вывода
BadLocationException - если мы находимся в недопустимом месте в документе.

writeEndParagraph

protected void writeEndParagraph()
                          throws IOException

Выводит закрывающий тег для тега <p>. Перед выводом тега этот метод гарантирует, что все открытые теги корректно закрыты.

Исключения:
IOException - при любой ошибке ввода-вывода

writeStartParagraph

protected void writeStartParagraph(Element elem)
                            throws IOException

Выводит открывающий тег для абзаца. Если у абзаца есть связанный с ним именованный стиль, этот метод также генерирует атрибут класса для тега <p> и устанавливает его значение в имя стиля.

Параметры:
elem - элемент
Исключения:
IOException - при любой ошибке ввода-вывода

writeLeaf

protected void writeLeaf(Element elem)
                  throws IOException

Ответственный за вывод других листовых элементов, не являющихся текстом.

Параметры:
elem - элемент
Исключения:
IOException - при любой ошибке ввода-вывода

writeImage

protected void writeImage(Element elem)
                   throws IOException

Ответственный за обработку элементов Icon; намеренно не реализован. Как реализовать этот метод — вопрос политики. Например, если вы генерируете тег <img>, как вы должны представить атрибут src (местоположение изображения)? В некоторых случаях это может быть URL, в других — считывание из потока.

Параметры:
elem - элемент типа StyleConstants.IconElementName
Исключения:
IOException - если произошла ошибка ввода-вывода.

writeComponent

protected void writeComponent(Element elem)
                       throws IOException

Ответственный за обработку элементов Component; намеренно не реализован. Как реализовать этот метод — вопрос политики.

Параметры:
elem - элемент типа StyleConstants.ComponentElementName
Исключения:
IOException - если произошла ошибка ввода-вывода.

isText

protected boolean isText(Element elem)

Возвращает true, если элемент является текстовым элементом.

Параметры:
elem - элемент
Возвращает:
true если элемент является текстовым элементом.

writeContent

protected void writeContent(Element elem,
                            boolean needsIndenting)
                     throws IOException,
                            BadLocationException

Выводит набор атрибутов в соответствии с HTML.

Параметры:
elem - элемент
needsIndenting - отступ будет добавлен, если needsIndenting равен true
Исключения:
IOException - при любой ошибке ввода-вывода
BadLocationException - если pos представляет недопустимое местоположение в документе.

writeHTMLTags

protected void writeHTMLTags(AttributeSet attr)
                      throws IOException

Генерирует теги <b>, <i> и <u> для текста на основе его настроек атрибутов.

Параметры:
attr - набор атрибутов
Исключения:
IOException - при любой ошибке ввода-вывода

writeNonHTMLAttributes

protected void writeNonHTMLAttributes(AttributeSet attr)
                               throws IOException

Выводит оставшиеся атрибуты уровня символов (атрибуты, кроме полужирного, курсива и подчёркнутого) в соответствии с HTML. Учитывая, что такие атрибуты, как семейство шрифтов и размер шрифта, не имеют прямого соответствия тегам HTML, генерируется тег <span>, атрибут style которого устанавливается для содержащего список оставшихся атрибутов, как встроенные стили.

Параметры:
attr - набор атрибутов
Исключения:
IOException - при любой ошибке ввода-вывода

inFontTag

protected boolean inFontTag()

Возвращает true, если мы находимся внутри тега <font>.

Возвращает:
true если мы находимся внутри тега <font>.

endFontTag

protected void endFontTag()
                   throws IOException

Этот метод больше не используется, вместо него будет выведен <span>.

Выводит закрывающий тег для тега <font>.

Исключения:
IOException - при любой ошибке ввода-вывода

startFontTag

protected void startFontTag(String style)
                     throws IOException

Этот метод больше не используется, вместо него будет выведен <span>.

Выводит открывающий тег для тега <font>. Поскольку теги font не могут быть вложены, этот метод закрывает любой вложенный тег font перед выводом нового открывающего тега.

Параметры:
style - стиль шрифта
Исключения:
IOException - при любой ошибке ввода-вывода

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/javax/swing/text/html/MinimalHTMLWriter.html

Spec-Zone .ru
спецификации, руководства, описания, API