Adding upstream version 124.0.1.upstream/124.0.1

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 32 insertions, 0 deletions

diff --git a/editor/nsIDocumentStateListener.idl b/editor/nsIDocumentStateListener.idl
new file mode 100644
index 0000000000..ab1d1cdf2f
--- /dev/null
+++ b/editor/nsIDocumentStateListener.idl
@@ -0,0 +1,32 @@
+/* -*- 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"
+
+/**
+ * Due to the historical reason, this listener interface says "document state",
+ * but this listener listens to HTML editor state.
+ */
+[scriptable, uuid(050cdc00-3b8e-11d3-9ce4-a458f454fcbc)]
+interface nsIDocumentStateListener : nsISupports
+{
+  /**
+   * NotifyDocumentWillBeDestroyed() is called when HTML editor instance is
+   * being destroyed.  Note that related objects may have already gone when
+   * this is called because that may cause destroying HTML editor.
+   */
+  [can_run_script]
+  void NotifyDocumentWillBeDestroyed();
+
+  /**
+   * NotifyDocumentStateChanged() is called when dirty state of HTML editor
+   * is changed.
+   *
+   * @param aNowDirty   if true, this is called when the HTML editor becomes
+   *                    dirty.  Otherwise, called when it becomes not dirty.
+   */
+  [can_run_script]
+  void NotifyDocumentStateChanged(in boolean aNowDirty);
+};