Класс HTMLEditorKit.InsertHTMLTextAction

Все реализованные интерфейсы:
ActionListener, Serializable, Cloneable, EventListener, Action
Вложенный класс:
HTMLEditorKit
public static class HTMLEditorKit.InsertHTMLTextAction
extends HTMLEditorKit.HTMLTextAction

InsertHTMLTextAction можно использовать для вставки произвольной строки HTML в существующий документ HTML. Необходимо предоставить как минимум два тега HTML. Первый тег, parentTag, идентифицирует родительский элемент в документе, к которому будут добавлены элементы. Второй тег, addTag, идентифицирует первый тег, который должен быть добавлен в документ, как видно в строке HTML. Важно помнить, что анализатор сгенерирует все соответствующие теги, даже если они не указаны в переданной строке HTML.

Например, предположим, что вы хотите создать действие для вставки таблицы в тело документа. parentTag будет HTML.Tag.BODY, addTag будет HTML.Tag.TABLE, а строка может быть такой: <table><tr><td></td></tr></table>.

Также есть возможность указать альтернативные parentTag и addTag. Они будут проверены, если parentTag не найден.

См. также:
Сериализованная форма

Поля

Модификатор и типПолеОписание
protected HTML.TagaddTag

Тег в HTML для начала добавления тегов.

protected HTML.TagalternateAddTag

Альтернативный тег в HTML для начала добавления тегов, если parentTag не найден, а alternateParentTag найден.

protected HTML.TagalternateParentTag

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

protected Stringhtml

Вставляемый HTML.

protected HTML.TagparentTag

Тег для проверки в документе.

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

changeSupport, enabled

Поля, объявленные в интерфейсе javax.swing.Action

ACCELERATOR_KEY, ACTION_COMMAND_KEY, DEFAULT, DISPLAYED_MNEMONIC_INDEX_KEY, LARGE_ICON_KEY, LONG_DESCRIPTION, MNEMONIC_KEY, NAME, SELECTED_KEY, SHORT_DESCRIPTION, SMALL_ICON

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

КонструкторОписание
InsertHTMLTextAction​(String name, String html, HTML.Tag parentTag, HTML.Tag addTag)

Создает новый InsertHTMLTextAction.

InsertHTMLTextAction​(String name, String html, HTML.Tag parentTag, HTML.Tag addTag, HTML.Tag alternateParentTag, HTML.Tag alternateAddTag)

Создает новый InsertHTMLTextAction.

Методы

Модификатор и типМетодОписание
voidactionPerformed​(ActionEvent ae)

Вставляет HTML в документ.

protected voidinsertAtBoundary​(JEditorPane editor, HTMLDocument doc, int offset, Element insertElement, String html, HTML.Tag parentTag, HTML.Tag addTag)

Вызывается при вставке на границе.

protected voidinsertAtBoundry​(JEditorPane editor, HTMLDocument doc, int offset, Element insertElement, String html, HTML.Tag parentTag, HTML.Tag addTag)

Устарело.

Начиная с Java 2 platform v1.3, используйте insertAtBoundary

protected voidinsertHTML​(JEditorPane editor, HTMLDocument doc, int offset, String html, int popDepth, int pushDepth, HTML.Tag addTag)

Обёртка для HTMLEditorKit.insertHTML.

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

elementCountToTag, findElementMatchingTag, getElementsAt, getHTMLDocument, getHTMLEditorKit

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

getEditor, getStyledDocument, getStyledEditorKit, setCharacterAttributes, setParagraphAttributes

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

augmentList, getFocusedComponent, getTextComponent

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

addPropertyChangeListener, clone, firePropertyChange, getKeys, getPropertyChangeListeners, getValue, isEnabled, putValue, removePropertyChangeListener, setEnabled

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

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

Методы, объявленные в интерфейсе javax.swing.Action

accept

Подробное описание полей

html

protected String html

Вставляемый HTML.

parentTag

protected HTML.Tag parentTag

Тег для проверки в документе.

addTag

protected HTML.Tag addTag

Тег в HTML для начала добавления тегов.

alternateParentTag

protected HTML.Tag alternateParentTag

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

alternateAddTag

protected HTML.Tag alternateAddTag

Альтернативный тег в HTML для начала добавления тегов, если parentTag не найден и alternateParentTag найден.

Подробное описание конструкторов

InsertHTMLTextAction

public InsertHTMLTextAction(String name,
                            String html,
                            HTML.Tag parentTag,
                            HTML.Tag addTag)

Создает новый InsertHTMLTextAction.

Параметры:
name - имя действия
html - строка HTML
parentTag - родительский тег
addTag - первый тег для начала вставки в документ

InsertHTMLTextAction

public InsertHTMLTextAction(String name,
                            String html,
                            HTML.Tag parentTag,
                            HTML.Tag addTag,
                            HTML.Tag alternateParentTag,
                            HTML.Tag alternateAddTag)

Создает новый InsertHTMLTextAction.

Параметры:
name - имя действия
html - строка HTML
parentTag - родительский тег
addTag - первый тег для начала вставки в документ
alternateParentTag - альтернативный родительский тег
alternateAddTag - альтернативный тег

Подробное описание методов

insertHTML

protected void insertHTML(JEditorPane editor,
                          HTMLDocument doc,
                          int offset,
                          String html,
                          int popDepth,
                          int pushDepth,
                          HTML.Tag addTag)

Обёртка для HTMLEditorKit.insertHTML. Если возникает исключение, оно обертывается в RuntimeException и выбрасывается.

Параметры:
editor - экземпляр JEditorPane
doc - документ для вставки
offset - смещение для вставки HTML
html - строка HTML
popDepth - количество ElementSpec.EndTagTypes, которое нужно сгенерировать перед вставкой
pushDepth - количество ElementSpec.StartTagTypes с направлением ElementSpec.JoinNextDirection, которое нужно сгенерировать перед вставкой, но после генерации конечных тегов
addTag - первый тег для начала вставки в документ

insertAtBoundary

protected void insertAtBoundary(JEditorPane editor,
                                HTMLDocument doc,
                                int offset,
                                Element insertElement,
                                String html,
                                HTML.Tag parentTag,
                                HTML.Tag addTag)

Вызывается при вставке на границе. Определяет количество удалений, затем количество добавлений и затем вызывает insertHTML.

Параметры:
editor - экземпляр JEditorPane
doc - экземпляр HTMLDocument
offset - смещение для начала
insertElement - экземпляр Element
html - строка HTML
parentTag - родительский тег
addTag - первый тег для начала вставки в документ
Since:
1.3

insertAtBoundry

@Deprecated
protected void insertAtBoundry(JEditorPane editor,
                               HTMLDocument doc,
                               int offset,
                               Element insertElement,
                               String html,
                               HTML.Tag parentTag,
                               HTML.Tag addTag)
Устарело.
Начиная с Java 2 platform v1.3, используйте insertAtBoundary

Вызывается при вставке на границе. Определяет количество удалений, затем количество добавлений и затем вызывает insertHTML.

Параметры:
editor - экземпляр JEditorPane
doc - экземпляр HTMLDocument
offset - смещение для начала
insertElement - экземпляр Element
html - строка HTML
parentTag - родительский тег
addTag - первый тег для начала вставки в документ

actionPerformed

public void actionPerformed(ActionEvent ae)

Вставляет HTML в документ.

Параметры:
ae - событие

© 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/HTMLEditorKit.InsertHTMLTextAction.html

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