Класс 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`	Тег для проверки в документе.

Поля, объявленные в классе 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.

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

Модификатор и тип	Метод	Описание
`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.

Методы, объявленные в классе 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

Параметры:: 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/text/html/HTMLEditorKit.InsertHTMLTextAction.html