From 5f8de423f190bbb79a62f804151bc24824fa32d8 Mon Sep 17 00:00:00 2001 From: "Matt A. Tobin" Date: Fri, 2 Feb 2018 04:16:08 -0500 Subject: Add m-esr52 at 52.6.0 --- widget/nsIWidgetListener.h | 165 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 165 insertions(+) create mode 100644 widget/nsIWidgetListener.h (limited to 'widget/nsIWidgetListener.h') diff --git a/widget/nsIWidgetListener.h b/widget/nsIWidgetListener.h new file mode 100644 index 000000000..63d899be0 --- /dev/null +++ b/widget/nsIWidgetListener.h @@ -0,0 +1,165 @@ +/* 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 nsIWidgetListener_h__ +#define nsIWidgetListener_h__ + +#include + +#include "mozilla/EventForwards.h" +#include "mozilla/TimeStamp.h" + +#include "nsRegionFwd.h" +#include "Units.h" + +class nsView; +class nsIPresShell; +class nsIWidget; +class nsIXULWindow; + +/** + * sizemode is an adjunct to widget size + */ +enum nsSizeMode +{ + nsSizeMode_Normal = 0, + nsSizeMode_Minimized, + nsSizeMode_Maximized, + nsSizeMode_Fullscreen, + nsSizeMode_Invalid +}; + +/** + * different types of (top-level) window z-level positioning + */ +enum nsWindowZ +{ + nsWindowZTop = 0, // on top + nsWindowZBottom, // on bottom + nsWindowZRelative // just below some specified widget +}; + +class nsIWidgetListener +{ +public: + + /** + * If this listener is for an nsIXULWindow, return it. If this is null, then + * this is likely a listener for a view, which can be determined using + * GetView. If both methods return null, this will be an nsWebBrowser. + */ + virtual nsIXULWindow* GetXULWindow(); + + /** + * If this listener is for an nsView, return it. + */ + virtual nsView* GetView(); + + /** + * Return the presshell for this widget listener. + */ + virtual nsIPresShell* GetPresShell(); + + /** + * Called when a window is moved to location (x, y). Returns true if the + * notification was handled. Coordinates are outer window screen coordinates. + */ + virtual bool WindowMoved(nsIWidget* aWidget, int32_t aX, int32_t aY); + + /** + * Called when a window is resized to (width, height). Returns true if the + * notification was handled. Coordinates are outer window screen coordinates. + */ + virtual bool WindowResized(nsIWidget* aWidget, + int32_t aWidth, int32_t aHeight); + + /** + * Called when the size mode (minimized, maximized, fullscreen) is changed. + */ + virtual void SizeModeChanged(nsSizeMode aSizeMode); + + /** + * Called when the DPI (device resolution scaling factor) is changed, + * such that UI elements may need to be rescaled. + */ + virtual void UIResolutionChanged(); + + /** + * Called when the z-order of the window is changed. Returns true if the + * notification was handled. aPlacement indicates the new z order. If + * placement is nsWindowZRelative, then aRequestBelow should be the + * window to place below. On return, aActualBelow will be set to the + * window actually behind. This generally only applies to Windows. + */ + virtual bool ZLevelChanged(bool aImmediate, nsWindowZ* aPlacement, + nsIWidget* aRequestBelow, + nsIWidget** aActualBelow); + + /** + * Called when the window entered or left the fullscreen state. + */ + virtual void FullscreenChanged(bool aInFullscreen); + + /** + * Called when the window is activated and focused. + */ + virtual void WindowActivated(); + + /** + * Called when the window is deactivated and no longer focused. + */ + virtual void WindowDeactivated(); + + /** + * Called when the show/hide toolbar button on the Mac titlebar is pressed. + */ + virtual void OSToolbarButtonPressed(); + + /** + * Called when a request is made to close the window. Returns true if the + * notification was handled. Returns true if the notification was handled. + */ + virtual bool RequestWindowClose(nsIWidget* aWidget); + + /* + * Indicate that a paint is about to occur on this window. This is called + * at a time when it's OK to change the geometry of this widget or of + * other widgets. Must be called before every call to PaintWindow. + */ + virtual void WillPaintWindow(nsIWidget* aWidget); + + /** + * Paint the specified region of the window. Returns true if the + * notification was handled. + * This is called at a time when it is not OK to change the geometry of + * this widget or of other widgets. + */ + virtual bool PaintWindow(nsIWidget* aWidget, + mozilla::LayoutDeviceIntRegion aRegion); + + /** + * Indicates that a paint occurred. + * This is called at a time when it is OK to change the geometry of + * this widget or of other widgets. + * Must be called after every call to PaintWindow. + */ + virtual void DidPaintWindow(); + + virtual void DidCompositeWindow(uint64_t aTransactionId, + const mozilla::TimeStamp& aCompositeStart, + const mozilla::TimeStamp& aCompositeEnd); + + /** + * Request that layout schedules a repaint on the next refresh driver tick. + */ + virtual void RequestRepaint(); + + /** + * Handle an event. + */ + virtual nsEventStatus HandleEvent(mozilla::WidgetGUIEvent* aEvent, + bool aUseAttachedEvents); +}; + +#endif -- cgit v1.2.3