From 36d22d82aa202bb199967e9512281e9a53db42c9 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 21:33:14 +0200 Subject: Adding upstream version 115.7.0esr. Signed-off-by: Daniel Baumann --- editor/nsIEditActionListener.idl | 91 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 91 insertions(+) create mode 100644 editor/nsIEditActionListener.idl (limited to 'editor/nsIEditActionListener.idl') diff --git a/editor/nsIEditActionListener.idl b/editor/nsIEditActionListener.idl new file mode 100644 index 0000000000..d959c19e4f --- /dev/null +++ b/editor/nsIEditActionListener.idl @@ -0,0 +1,91 @@ +/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ +/* This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ + +#include "nsISupports.idl" +#include "domstubs.idl" + +webidl CharacterData; +webidl Node; +webidl Range; + +%{C++ +#include "mozilla/EditorDOMPoint.h" +class nsINode; +class nsIContent; +%} + +[ref] native EditorRawDOMPointRef(mozilla::EditorDOMPointBase); + +/* +Editor Action Listener interface to outside world +*/ + + +/** + * A generic editor action listener interface. + *

+ * nsIEditActionListener is the interface used by applications wishing to be notified + * when the editor modifies the DOM tree. + * + * Note: this is the wrong class to implement if you are interested in generic + * change notifications. For generic notifications, you should implement + * nsIDocumentObserver. + */ +[scriptable, uuid(b22907b1-ee93-11d2-8d50-000064657374)] +interface nsIEditActionListener : nsISupports +{ + /** + * Called after the editor deletes a node. + * @param aChild The node to delete + * @param aResult The result of the delete node operation. + */ + void DidDeleteNode(in Node aChild, in nsresult aResult); + + /** + * Called after the editor joins 2 nodes. + * @param aJoinedPoint The joined point. If aLeftNodeWasRemoved is true, + * it points after inserted left node content in the + * right node. Otherwise, it points start of inserted + * right node content in the left node. + * @param aRemovedNode The removed node. + * @param aLeftNodeWasRemoved + * true if left node is removed and its contents were + * moved into start of the right node. + * false if right node is removed and its contents were + * moved into end of the left node. + */ + [noscript] + void DidJoinContents([const] in EditorRawDOMPointRef aJoinedPoint, + [const] in Node aRemovedNode, + in bool aLeftNodeWasRemoved); + + /** + * Called after the editor inserts text. + * @param aTextNode This node getting inserted text. + * @param aOffset The offset in aTextNode to insert at. + * @param aString The string that gets inserted. + * @param aResult The result of the insert text operation. + */ + void DidInsertText(in CharacterData aTextNode, + in long aOffset, + in AString aString, + in nsresult aResult); + + /** + * Called before the editor deletes text. + * @param aTextNode This node getting text deleted. + * @param aOffset The offset in aTextNode to delete at. + * @param aLength The amount of text to delete. + */ + void WillDeleteText(in CharacterData aTextNode, + in long aOffset, + in long aLength); + + /** + * Called before the editor deletes the ranges. + * @param aRangesToDelete The ranges to be deleted. + */ + void WillDeleteRanges(in Array aRangesToDelete); +}; -- cgit v1.2.3