summaryrefslogtreecommitdiffstats
path: root/layout/base/nsIReflowCallback.h
diff options
context:
space:
mode:
Diffstat (limited to 'layout/base/nsIReflowCallback.h')
-rw-r--r--layout/base/nsIReflowCallback.h34
1 files changed, 34 insertions, 0 deletions
diff --git a/layout/base/nsIReflowCallback.h b/layout/base/nsIReflowCallback.h
new file mode 100644
index 0000000000..aa7dbd3c24
--- /dev/null
+++ b/layout/base/nsIReflowCallback.h
@@ -0,0 +1,34 @@
+/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* vim: set ts=8 sts=2 et sw=2 tw=80: */
+/* 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/. */
+#ifndef nsIReflowCallback_h___
+#define nsIReflowCallback_h___
+
+/**
+ * Reflow callback interface.
+ * These are not refcounted. Objects must be removed from the presshell
+ * callback list before they die.
+ * Protocol: objects will either get a ReflowFinished() call when a reflow
+ * has finished or a ReflowCallbackCanceled() call if the shell is destroyed,
+ * whichever happens first. If the object is explicitly removed from the shell
+ * (using PresShell::CancelReflowCallback()) before that occurs then neither
+ * of the callback methods are called.
+ */
+class nsIReflowCallback {
+ public:
+ /**
+ * The presshell calls this when reflow has finished. Return true if
+ * you need a FlushType::Layout to happen after this.
+ */
+ virtual bool ReflowFinished() = 0;
+ /**
+ * The presshell calls this on outstanding callback requests in its
+ * Destroy() method. The shell removes the request after calling
+ * ReflowCallbackCanceled().
+ */
+ virtual void ReflowCallbackCanceled() = 0;
+};
+
+#endif /* nsIReflowCallback_h___ */