Класс 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 platform 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 - первый тег для начала вставки в документ
С:: 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, 2021, 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/17/docs/api/java.desktop/javax/swing/text/html/HTMLEditorKit.InsertHTMLTextAction.html