Класс HTMLEditorKit.InsertHTMLTextAction

javax.swing.text.html.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.Tag`	`addTag`	Тег в HTML, с которого начинается добавление тегов.
`protected HTML.Tag`	`alternateAddTag`	Альтернативный тег в HTML, с которого начинается добавление тегов, если parentTag не найден, а alternateParentTag найден.
`protected HTML.Tag`	`alternateParentTag`	Альтернативный тег для поиска в документе, если parentTag не найден.
`protected String`	`html`	Вставляемый HTML.
`protected HTML.Tag`	`parentTag`	Тег для поиска в документе.

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

changeSupport, enabled

Поля, объявленные в интерфейсе 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.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`actionPerformed(ActionEvent ae)`	Вставляет HTML в документ.
`protected void`	`insertAtBoundary(JEditorPane editor, HTMLDocument doc, int offset, Element insertElement, String html, HTML.Tag parentTag, HTML.Tag addTag)`	Вызывается при вставке на границе.
`protected void`	`insertAtBoundry(JEditorPane editor, HTMLDocument doc, int offset, Element insertElement, String html, HTML.Tag parentTag, HTML.Tag addTag)`	Устарело. Начиная с платформы Java 2 v1.3 используйте insertAtBoundary
`protected void`	`insertHTML(JEditorPane editor, HTMLDocument doc, int offset, String html, int popDepth, int pushDepth, HTML.Tag addTag)`	Обертка для HTMLEditorKit.insertHTML.

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

elementCountToTag, findElementMatchingTag, getElementsAt, getHTMLDocument, getHTMLEditorKit

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

getEditor, getStyledDocument, getStyledEditorKit, setCharacterAttributes, setParagraphAttributes

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

augmentList, getFocusedComponent, getTextComponent

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

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

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

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

Методы, объявленные в интерфейсе 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 — первый тег, с которого начинается вставка в документ
Начиная с версии:: 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 v1.3 используйте insertAtBoundary

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

actionPerformed

public void actionPerformed(ActionEvent ae)

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

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

© 1993, 2025, 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/25/docs/api/java.desktop/javax/swing/text/html/HTMLEditorKit.InsertHTMLTextAction.html