/* -*- 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/. */ /* rendering object to wrap rendering objects that should be scrollable */ #ifndef nsGfxScrollFrame_h___ #define nsGfxScrollFrame_h___ #include "mozilla/Attributes.h" #include "nsContainerFrame.h" #include "nsIAnonymousContentCreator.h" #include "nsBoxFrame.h" #include "nsIScrollableFrame.h" #include "nsIScrollbarMediator.h" #include "nsIStatefulFrame.h" #include "nsThreadUtils.h" #include "nsIReflowCallback.h" #include "nsBoxLayoutState.h" #include "nsQueryFrame.h" #include "nsRefreshDriver.h" #include "nsExpirationTracker.h" #include "TextOverflow.h" #include "ScrollVelocityQueue.h" #include "mozilla/PresState.h" class nsPresContext; class nsIPresShell; class nsIContent; class nsAtom; class nsIScrollPositionListener; namespace mozilla { struct ScrollReflowInput; namespace layers { class Layer; class LayerManager; } // namespace layers namespace layout { class ScrollbarActivity; } // namespace layout class ScrollFrameHelper : public nsIReflowCallback { public: typedef nsIFrame::Sides Sides; typedef mozilla::CSSIntPoint CSSIntPoint; typedef mozilla::layout::ScrollbarActivity ScrollbarActivity; typedef mozilla::layers::FrameMetrics FrameMetrics; typedef mozilla::layers::ScrollSnapInfo ScrollSnapInfo; typedef mozilla::layers::Layer Layer; typedef mozilla::layers::LayerManager LayerManager; class AsyncScroll; class AsyncSmoothMSDScroll; ScrollFrameHelper(nsContainerFrame* aOuter, bool aIsRoot); ~ScrollFrameHelper(); mozilla::ScrollbarStyles GetScrollbarStylesFromFrame() const; // If a child frame was added or removed on the scrollframe, // reload our child frame list. // We need this if a scrollbar frame is recreated. void ReloadChildFrames(); nsresult CreateAnonymousContent( nsTArray& aElements); void AppendAnonymousContentTo(nsTArray& aElements, uint32_t aFilter); nsresult FireScrollPortEvent(); void PostScrollEndEvent(); void FireScrollEndEvent(); void PostOverflowEvent(); using PostDestroyData = nsIFrame::PostDestroyData; void Destroy(PostDestroyData& aPostDestroyData); void BuildDisplayList(nsDisplayListBuilder* aBuilder, const nsDisplayListSet& aLists); void AppendScrollPartsTo(nsDisplayListBuilder* aBuilder, const nsDisplayListSet& aLists, bool aCreateLayer, bool aPositioned); bool GetBorderRadii(const nsSize& aFrameSize, const nsSize& aBorderArea, Sides aSkipSides, nscoord aRadii[8]) const; // nsIReflowCallback virtual bool ReflowFinished() override; virtual void ReflowCallbackCanceled() override; /** * @note This method might destroy the frame, pres shell and other objects. * Called when the 'curpos' attribute on one of the scrollbars changes. */ void CurPosAttributeChanged(nsIContent* aChild, bool aDoScroll = true); void PostScrollEvent(); void FireScrollEvent(); void PostScrolledAreaEvent(); void FireScrolledAreaEvent(); bool IsSmoothScrollingEnabled(); /** * This class handles the dispatching of scroll events to content. * * Scroll events are posted to the refresh driver via * nsRefreshDriver::PostScrollEvent(), and they are fired during a refresh * driver tick, after running requestAnimationFrame callbacks but before * the style flush. This allows rAF callbacks to perform scrolling and have * that scrolling be reflected on the same refresh driver tick, while at * the same time allowing scroll event listeners to make style changes and * have those style changes be reflected on the same refresh driver tick. * * ScrollEvents cannot be refresh observers, because none of the existing * categories of refresh observers (FlushType::Style, FlushType::Layout, * and FlushType::Display) are run at the desired time in a refresh driver * tick. They behave similarly to refresh observers in that their presence * causes the refresh driver to tick. * * ScrollEvents are one-shot runnables; the refresh driver drops them after * running them. */ class ScrollEvent : public Runnable { public: NS_DECL_NSIRUNNABLE explicit ScrollEvent(ScrollFrameHelper* aHelper); void Revoke() { mHelper = nullptr; } private: ScrollFrameHelper* mHelper; }; class ScrollEndEvent : public Runnable { public: NS_DECL_NSIRUNNABLE explicit ScrollEndEvent(ScrollFrameHelper* aHelper); void Revoke() { mHelper = nullptr; } private: ScrollFrameHelper* mHelper; }; class AsyncScrollPortEvent : public Runnable { public: NS_DECL_NSIRUNNABLE explicit AsyncScrollPortEvent(ScrollFrameHelper* helper) : Runnable("ScrollFrameHelper::AsyncScrollPortEvent") , mHelper(helper) { } void Revoke() { mHelper = nullptr; } private: ScrollFrameHelper *mHelper; }; class ScrolledAreaEvent : public Runnable { public: NS_DECL_NSIRUNNABLE explicit ScrolledAreaEvent(ScrollFrameHelper* helper) : Runnable("ScrollFrameHelper::ScrolledAreaEvent") , mHelper(helper) { } void Revoke() { mHelper = nullptr; } private: ScrollFrameHelper *mHelper; }; /** * @note This method might destroy the frame, pres shell and other objects. */ void FinishReflowForScrollbar(mozilla::dom::Element* aElement, nscoord aMinXY, nscoord aMaxXY, nscoord aCurPosXY, nscoord aPageIncrement, nscoord aIncrement); /** * @note This method might destroy the frame, pres shell and other objects. */ void SetScrollbarEnabled(mozilla::dom::Element* aElement, nscoord aMaxPos); /** * @note This method might destroy the frame, pres shell and other objects. */ void SetCoordAttribute(mozilla::dom::Element* aElement, nsAtom* aAtom, nscoord aSize); nscoord GetCoordAttribute(nsIFrame* aFrame, nsAtom* aAtom, nscoord aDefaultValue, nscoord* aRangeStart, nscoord* aRangeLength); /** * @note This method might destroy the frame, pres shell and other objects. * Update scrollbar curpos attributes to reflect current scroll position */ void UpdateScrollbarPosition(); nsRect GetScrollPortRect() const { return mScrollPort; } nsPoint GetScrollPosition() const { return mScrollPort.TopLeft() - mScrolledFrame->GetPosition(); } /** * For LTR frames, the logical scroll position is the offset of the top left * corner of the frame from the top left corner of the scroll port (same as * GetScrollPosition). * For RTL frames, it is the offset of the top right corner of the frame from * the top right corner of the scroll port */ nsPoint GetLogicalScrollPosition() const { nsPoint pt; pt.x = IsPhysicalLTR() ? mScrollPort.x - mScrolledFrame->GetPosition().x : mScrollPort.XMost() - mScrolledFrame->GetRect().XMost(); pt.y = mScrollPort.y - mScrolledFrame->GetPosition().y; return pt; } nsRect GetScrollRange() const; // Get the scroll range assuming the scrollport has size (aWidth, aHeight). nsRect GetScrollRange(nscoord aWidth, nscoord aHeight) const; nsSize GetScrollPositionClampingScrollPortSize() const; void ScrollSnap(nsIScrollableFrame::ScrollMode aMode = nsIScrollableFrame::SMOOTH_MSD); void ScrollSnap(const nsPoint &aDestination, nsIScrollableFrame::ScrollMode aMode = nsIScrollableFrame::SMOOTH_MSD); protected: nsRect GetScrollRangeForClamping() const; public: static void AsyncScrollCallback(ScrollFrameHelper* aInstance, mozilla::TimeStamp aTime); static void AsyncSmoothMSDScrollCallback(ScrollFrameHelper* aInstance, mozilla::TimeDuration aDeltaTime); /** * @note This method might destroy the frame, pres shell and other objects. * aRange is the range of allowable scroll positions around the desired * aScrollPosition. Null means only aScrollPosition is allowed. * This is a closed-ended range --- aRange.XMost()/aRange.YMost() are allowed. */ void ScrollTo(nsPoint aScrollPosition, nsIScrollableFrame::ScrollMode aMode, const nsRect* aRange = nullptr, nsIScrollbarMediator::ScrollSnapMode aSnap = nsIScrollbarMediator::DISABLE_SNAP) { ScrollToWithOrigin(aScrollPosition, aMode, nsGkAtoms::other, aRange, aSnap); } /** * @note This method might destroy the frame, pres shell and other objects. */ void ScrollToCSSPixels(const CSSIntPoint& aScrollPosition, nsIScrollableFrame::ScrollMode aMode = nsIScrollableFrame::INSTANT); /** * @note This method might destroy the frame, pres shell and other objects. */ void ScrollToCSSPixelsApproximate(const mozilla::CSSPoint& aScrollPosition, nsAtom* aOrigin = nullptr); CSSIntPoint GetScrollPositionCSSPixels(); /** * @note This method might destroy the frame, pres shell and other objects. */ void ScrollToImpl(nsPoint aScrollPosition, const nsRect& aRange, nsAtom* aOrigin = nullptr); void ScrollVisual(); /** * @note This method might destroy the frame, pres shell and other objects. */ void ScrollBy(nsIntPoint aDelta, nsIScrollableFrame::ScrollUnit aUnit, nsIScrollableFrame::ScrollMode aMode, nsIntPoint* aOverflow, nsAtom* aOrigin = nullptr, nsIScrollableFrame::ScrollMomentum aMomentum = nsIScrollableFrame::NOT_MOMENTUM, nsIScrollbarMediator::ScrollSnapMode aSnap = nsIScrollbarMediator::DISABLE_SNAP); /** * @note This method might destroy the frame, pres shell and other objects. */ void ScrollToRestoredPosition(); enum class LoadingState { Loading, Stopped, Loaded }; LoadingState GetPageLoadingState(); /** * GetSnapPointForDestination determines which point to snap to after * scrolling. aStartPos gives the position before scrolling and aDestination * gives the position after scrolling, with no snapping. Behaviour is * dependent on the value of aUnit. * Returns true if a suitable snap point could be found and aDestination has * been updated to a valid snapping position. */ bool GetSnapPointForDestination(nsIScrollableFrame::ScrollUnit aUnit, nsPoint aStartPos, nsPoint &aDestination); nsSize GetLineScrollAmount() const; nsSize GetPageScrollAmount() const; mozilla::UniquePtr SaveState() const; void RestoreState(mozilla::PresState* aState); nsIFrame* GetScrolledFrame() const { return mScrolledFrame; } nsIFrame* GetScrollbarBox(bool aVertical) const { return aVertical ? mVScrollbarBox : mHScrollbarBox; } void AddScrollPositionListener(nsIScrollPositionListener* aListener) { mListeners.AppendElement(aListener); } void RemoveScrollPositionListener(nsIScrollPositionListener* aListener) { mListeners.RemoveElement(aListener); } static void SetScrollbarVisibility(nsIFrame* aScrollbar, bool aVisible); /** * GetScrolledRect is designed to encapsulate deciding which * directions of overflow should be reachable by scrolling and which * should not. Callers should NOT depend on it having any particular * behavior (although nsXULScrollFrame currently does). * * This should only be called when the scrolled frame has been * reflowed with the scroll port size given in mScrollPort. * * Currently it allows scrolling down and to the right for * nsHTMLScrollFrames with LTR directionality and for all * nsXULScrollFrames, and allows scrolling down and to the left for * nsHTMLScrollFrames with RTL directionality. */ nsRect GetScrolledRect() const; /** * GetUnsnappedScrolledRectInternal is designed to encapsulate deciding which * directions of overflow should be reachable by scrolling and which * should not. Callers should NOT depend on it having any particular * behavior (although nsXULScrollFrame currently does). * * Currently it allows scrolling down and to the right for * nsHTMLScrollFrames with LTR directionality and for all * nsXULScrollFrames, and allows scrolling down and to the left for * nsHTMLScrollFrames with RTL directionality. */ nsRect GetUnsnappedScrolledRectInternal(const nsRect& aScrolledOverflowArea, const nsSize& aScrollPortSize) const; uint32_t GetScrollbarVisibility() const { return (mHasVerticalScrollbar ? nsIScrollableFrame::VERTICAL : 0) | (mHasHorizontalScrollbar ? nsIScrollableFrame::HORIZONTAL : 0); } nsMargin GetActualScrollbarSizes() const; nsMargin GetDesiredScrollbarSizes(nsBoxLayoutState* aState); nscoord GetNondisappearingScrollbarWidth(nsBoxLayoutState* aState, mozilla::WritingMode aVerticalWM); bool IsPhysicalLTR() const { WritingMode wm = GetFrameForDir()->GetWritingMode(); return wm.IsVertical() ? wm.IsVerticalLR() : wm.IsBidiLTR(); } bool IsBidiLTR() const { nsIFrame* frame = GetFrameForDir(); return frame->StyleVisibility()->mDirection == NS_STYLE_DIRECTION_LTR; } private: nsIFrame* GetFrameForDir() const; // helper for Is{Physical,Bidi}LTR to find // the frame whose directionality we use public: bool IsScrollbarOnRight() const; bool IsScrollingActive(nsDisplayListBuilder* aBuilder) const; bool IsMaybeAsynchronouslyScrolled() const { // If this is true, then we'll build an ASR, and that's what we want // to know I think. return mWillBuildScrollableLayer; } bool IsMaybeScrollingActive() const; bool IsProcessingAsyncScroll() const { return mAsyncScroll != nullptr || mAsyncSmoothMSDScroll != nullptr; } void ResetScrollPositionForLayerPixelAlignment() { mScrollPosForLayerPixelAlignment = GetScrollPosition(); } bool ComputeCustomOverflow(nsOverflowAreas& aOverflowAreas); void UpdateSticky(); void UpdatePrevScrolledRect(); bool IsRectNearlyVisible(const nsRect& aRect) const; nsRect ExpandRectToNearlyVisible(const nsRect& aRect) const; // adjust the scrollbar rectangle aRect to account for any visible resizer. // aHasResizer specifies if there is a content resizer, however this method // will also check if a widget resizer is present as well. void AdjustScrollbarRectForResizer(nsIFrame* aFrame, nsPresContext* aPresContext, nsRect& aRect, bool aHasResizer, bool aVertical); // returns true if a resizer should be visible bool HasResizer() { return mResizerBox && !mCollapsedResizer; } void LayoutScrollbars(nsBoxLayoutState& aState, const nsRect& aContentArea, const nsRect& aOldScrollArea); bool IsIgnoringViewportClipping() const; void MarkScrollbarsDirtyForReflow() const; bool ShouldClampScrollPosition() const; bool IsAlwaysActive() const; void MarkRecentlyScrolled(); void MarkNotRecentlyScrolled(); nsExpirationState* GetExpirationState() { return &mActivityExpirationState; } void SetTransformingByAPZ(bool aTransforming) { if (mTransformingByAPZ && !aTransforming) { PostScrollEndEvent(); } mTransformingByAPZ = aTransforming; if (!mozilla::css::TextOverflow::HasClippedOverflow(mOuter)) { // If the block has some text-overflow stuff we should kick off a paint // because we have special behaviour for it when APZ scrolling is active. mOuter->SchedulePaint(); } } bool IsTransformingByAPZ() const { return mTransformingByAPZ; } void SetScrollableByAPZ(bool aScrollable); void SetZoomableByAPZ(bool aZoomable); void SetHasOutOfFlowContentInsideFilter(); bool UsesContainerScrolling() const; ScrollSnapInfo GetScrollSnapInfo() const; bool DecideScrollableLayer(nsDisplayListBuilder* aBuilder, nsRect* aVisibleRect, nsRect* aDirtyRect, bool aSetBase, bool* aDirtyRectHasBeenOverriden = nullptr); void NotifyApproximateFrameVisibilityUpdate(bool aIgnoreDisplayPort); bool GetDisplayPortAtLastApproximateFrameVisibilityUpdate(nsRect* aDisplayPort); bool AllowDisplayPortExpiration(); void TriggerDisplayPortExpiration(); void ResetDisplayPortExpiryTimer(); void ScheduleSyntheticMouseMove(); static void ScrollActivityCallback(nsITimer *aTimer, void* anInstance); void HandleScrollbarStyleSwitching(); nsAtom* LastScrollOrigin() const { return mLastScrollOrigin; } void AllowScrollOriginDowngrade() { mAllowScrollOriginDowngrade = true; } nsAtom* LastSmoothScrollOrigin() const { return mLastSmoothScrollOrigin; } uint32_t CurrentScrollGeneration() const { return mScrollGeneration; } nsPoint LastScrollDestination() const { return mDestination; } void ResetScrollInfoIfGeneration(uint32_t aGeneration) { if (aGeneration == mScrollGeneration) { mLastScrollOrigin = nullptr; mLastSmoothScrollOrigin = nullptr; } } bool WantAsyncScroll() const; Maybe ComputeScrollMetadata( LayerManager* aLayerManager, const nsIFrame* aContainerReferenceFrame, const ContainerLayerParameters& aParameters, const mozilla::DisplayItemClip* aClip) const; void ClipLayerToDisplayPort(Layer* aLayer, const mozilla::DisplayItemClip* aClip, const ContainerLayerParameters& aParameters) const; // nsIScrollbarMediator void ScrollByPage(nsScrollbarFrame* aScrollbar, int32_t aDirection, nsIScrollbarMediator::ScrollSnapMode aSnap = nsIScrollbarMediator::DISABLE_SNAP); void ScrollByWhole(nsScrollbarFrame* aScrollbar, int32_t aDirection, nsIScrollbarMediator::ScrollSnapMode aSnap = nsIScrollbarMediator::DISABLE_SNAP); void ScrollByLine(nsScrollbarFrame* aScrollbar, int32_t aDirection, nsIScrollbarMediator::ScrollSnapMode aSnap = nsIScrollbarMediator::DISABLE_SNAP); void RepeatButtonScroll(nsScrollbarFrame* aScrollbar); void ThumbMoved(nsScrollbarFrame* aScrollbar, nscoord aOldPos, nscoord aNewPos); void ScrollbarReleased(nsScrollbarFrame* aScrollbar); void ScrollByUnit(nsScrollbarFrame* aScrollbar, nsIScrollableFrame::ScrollMode aMode, int32_t aDirection, nsIScrollableFrame::ScrollUnit aUnit, nsIScrollbarMediator::ScrollSnapMode aSnap = nsIScrollbarMediator::DISABLE_SNAP); bool ShouldSuppressScrollbarRepaints() const { return mSuppressScrollbarRepaints; } bool DragScroll(WidgetEvent* aEvent); void AsyncScrollbarDragRejected(); bool IsRootScrollFrameOfDocument() const { return mIsRoot; } // owning references to the nsIAnonymousContentCreator-built content nsCOMPtr mHScrollbarContent; nsCOMPtr mVScrollbarContent; nsCOMPtr mScrollCornerContent; nsCOMPtr mResizerContent; RefPtr mScrollEvent; RefPtr mScrollEndEvent; nsRevocableEventPtr mAsyncScrollPortEvent; nsRevocableEventPtr mScrolledAreaEvent; nsIFrame* mHScrollbarBox; nsIFrame* mVScrollbarBox; nsIFrame* mScrolledFrame; nsIFrame* mScrollCornerBox; nsIFrame* mResizerBox; nsContainerFrame* mOuter; const nsIFrame* mReferenceFrameDuringPainting; RefPtr mAsyncScroll; RefPtr mAsyncSmoothMSDScroll; RefPtr mScrollbarActivity; nsTArray mListeners; nsAtom* mLastScrollOrigin; bool mAllowScrollOriginDowngrade; nsAtom* mLastSmoothScrollOrigin; Maybe mApzSmoothScrollDestination; uint32_t mScrollGeneration; nsRect mScrollPort; // Where we're currently scrolling to, if we're scrolling asynchronously. // If we're not in the middle of an asynchronous scroll then this is // just the current scroll position. ScrollBy will choose its // destination based on this value. nsPoint mDestination; nsPoint mScrollPosAtLastPaint; // A goal position to try to scroll to as content loads. As long as mLastPos // matches the current logical scroll position, we try to scroll to mRestorePos // after every reflow --- because after each time content is loaded/added to the // scrollable element, there will be a reflow. nsPoint mRestorePos; // The last logical position we scrolled to while trying to restore mRestorePos, or // 0,0 when this is a new frame. Set to -1,-1 once we've scrolled for any reason // other than trying to restore mRestorePos. nsPoint mLastPos; nsExpirationState mActivityExpirationState; nsCOMPtr mScrollActivityTimer; nsPoint mScrollPosForLayerPixelAlignment; // The scroll position where we last updated frame visibility. nsPoint mLastUpdateFramesPos; bool mHadDisplayPortAtLastFrameUpdate; nsRect mDisplayPortAtLastFrameUpdate; nsRect mPrevScrolledRect; FrameMetrics::ViewID mScrollParentID; // Timer to remove the displayport some time after scrolling has stopped nsCOMPtr mDisplayPortExpiryTimer; bool mNeverHasVerticalScrollbar:1; bool mNeverHasHorizontalScrollbar:1; bool mHasVerticalScrollbar:1; bool mHasHorizontalScrollbar:1; bool mFrameIsUpdatingScrollbar:1; bool mDidHistoryRestore:1; // Is this the scrollframe for the document's viewport? bool mIsRoot:1; // True if we should clip all descendants, false if we should only clip // descendants for which we are the containing block. bool mClipAllDescendants:1; // If true, don't try to layout the scrollbars in Reflow(). This can be // useful if multiple passes are involved, because we don't want to place the // scrollbars at the wrong size. bool mSuppressScrollbarUpdate:1; // If true, we skipped a scrollbar layout due to mSuppressScrollbarUpdate // being set at some point. That means we should lay out scrollbars even if // it might not strictly be needed next time mSuppressScrollbarUpdate is // false. bool mSkippedScrollbarLayout:1; bool mHadNonInitialReflow:1; // State used only by PostScrollEvents so we know // which overflow states have changed. bool mHorizontalOverflow:1; bool mVerticalOverflow:1; bool mPostedReflowCallback:1; bool mMayHaveDirtyFixedChildren:1; // If true, need to actually update our scrollbar attributes in the // reflow callback. bool mUpdateScrollbarAttributes:1; // If true, we should be prepared to scroll using this scrollframe // by placing descendant content into its own layer(s) bool mHasBeenScrolledRecently:1; // If true, the resizer is collapsed and not displayed bool mCollapsedResizer:1; // If true, the scroll frame should always be active because we always build // a scrollable layer. Used for asynchronous scrolling. bool mWillBuildScrollableLayer:1; // If true, the scroll frame is an ancestor of other scrolling frames, so // we shouldn't expire the displayport on this scrollframe unless those // descendant scrollframes also have their displayports removed. bool mIsScrollParent:1; // Whether we are the root scroll frame that is used for containerful // scrolling with a display port. If true, the scrollable frame // shouldn't attach frame metrics to its layers because the container // will already have the necessary frame metrics. bool mIsScrollableLayerInRootContainer:1; // If true, add clipping in ScrollFrameHelper::ClipLayerToDisplayPort. bool mAddClipRectToLayer:1; // True if this frame has been scrolled at least once bool mHasBeenScrolled:1; // True if the events synthesized by OSX to produce momentum scrolling should // be ignored. Reset when the next real, non-synthesized scroll event occurs. bool mIgnoreMomentumScroll:1; // True if the APZ is in the process of async-transforming this scrollframe, // (as best as we can tell on the main thread, anyway). bool mTransformingByAPZ:1; // True if APZ can scroll this frame asynchronously (i.e. it has an APZC // set up for this frame and it's not a scrollinfo layer). bool mScrollableByAPZ:1; // True if the APZ is allowed to zoom this scrollframe. bool mZoomableByAPZ:1; // True if the scroll frame contains out-of-flow content and is inside // a CSS filter. bool mHasOutOfFlowContentInsideFilter:1; // True if we don't want the scrollbar to repaint itself right now. bool mSuppressScrollbarRepaints:1; mozilla::layout::ScrollVelocityQueue mVelocityQueue; protected: class AutoScrollbarRepaintSuppression; friend class AutoScrollbarRepaintSuppression; class AutoScrollbarRepaintSuppression { public: AutoScrollbarRepaintSuppression(ScrollFrameHelper* aHelper, bool aSuppress) : mHelper(aHelper) , mOldSuppressValue(aHelper->mSuppressScrollbarRepaints) { mHelper->mSuppressScrollbarRepaints = aSuppress; } ~AutoScrollbarRepaintSuppression() { mHelper->mSuppressScrollbarRepaints = mOldSuppressValue; } private: ScrollFrameHelper* mHelper; bool mOldSuppressValue; }; /** * @note This method might destroy the frame, pres shell and other objects. */ void ScrollToWithOrigin(nsPoint aScrollPosition, nsIScrollableFrame::ScrollMode aMode, nsAtom *aOrigin, // nullptr indicates "other" origin const nsRect* aRange, nsIScrollbarMediator::ScrollSnapMode aSnap = nsIScrollbarMediator::DISABLE_SNAP); void CompleteAsyncScroll(const nsRect &aRange, nsAtom* aOrigin = nullptr); bool HasPluginFrames(); bool HasPerspective() const { return mOuter->ChildrenHavePerspective(); } bool HasBgAttachmentLocal() const; uint8_t GetScrolledFrameDir() const; static void EnsureFrameVisPrefsCached(); static bool sFrameVisPrefsCached; // The number of scrollports wide/high to expand when tracking frame visibility. static uint32_t sHorzExpandScrollPort; static uint32_t sVertExpandScrollPort; // The fraction of the scrollport we allow to scroll by before we schedule // an update of frame visibility. static int32_t sHorzScrollFraction; static int32_t sVertScrollFraction; }; } // namespace mozilla /** * The scroll frame creates and manages the scrolling view * * It only supports having a single child frame that typically is an area * frame, but doesn't have to be. The child frame must have a view, though * * Scroll frames don't support incremental changes, i.e. you can't replace * or remove the scrolled frame */ class nsHTMLScrollFrame : public nsContainerFrame, public nsIScrollableFrame, public nsIAnonymousContentCreator, public nsIStatefulFrame { public: typedef mozilla::ScrollFrameHelper ScrollFrameHelper; typedef mozilla::CSSIntPoint CSSIntPoint; typedef mozilla::ScrollReflowInput ScrollReflowInput; friend nsHTMLScrollFrame* NS_NewHTMLScrollFrame(nsIPresShell* aPresShell, ComputedStyle* aStyle, bool aIsRoot); NS_DECL_QUERYFRAME NS_DECL_FRAMEARENA_HELPERS(nsHTMLScrollFrame) virtual void BuildDisplayList(nsDisplayListBuilder* aBuilder, const nsDisplayListSet& aLists) override { mHelper.BuildDisplayList(aBuilder, aLists); } bool TryLayout(ScrollReflowInput* aState, ReflowOutput* aKidMetrics, bool aAssumeVScroll, bool aAssumeHScroll, bool aForce); bool ScrolledContentDependsOnHeight(ScrollReflowInput* aState); void ReflowScrolledFrame(ScrollReflowInput* aState, bool aAssumeHScroll, bool aAssumeVScroll, ReflowOutput* aMetrics, bool aFirstPass); void ReflowContents(ScrollReflowInput* aState, const ReflowOutput& aDesiredSize); void PlaceScrollArea(ScrollReflowInput& aState, const nsPoint& aScrollPosition); nscoord GetIntrinsicVScrollbarWidth(gfxContext *aRenderingContext); virtual bool GetBorderRadii(const nsSize& aFrameSize, const nsSize& aBorderArea, Sides aSkipSides, nscoord aRadii[8]) const override { return mHelper.GetBorderRadii(aFrameSize, aBorderArea, aSkipSides, aRadii); } virtual nscoord GetMinISize(gfxContext *aRenderingContext) override; virtual nscoord GetPrefISize(gfxContext *aRenderingContext) override; virtual nsresult GetXULPadding(nsMargin& aPadding) override; virtual bool IsXULCollapsed() override; virtual void Reflow(nsPresContext* aPresContext, ReflowOutput& aDesiredSize, const ReflowInput& aReflowInput, nsReflowStatus& aStatus) override; virtual bool ComputeCustomOverflow(nsOverflowAreas& aOverflowAreas) override { return mHelper.ComputeCustomOverflow(aOverflowAreas); } bool GetVerticalAlignBaseline(mozilla::WritingMode aWM, nscoord* aBaseline) const override { *aBaseline = GetLogicalBaseline(aWM); return true; } // Recomputes the scrollable overflow area we store in the helper to take children // that are affected by perpsective set on the outer frame and scroll at different // rates. void AdjustForPerspective(nsRect& aScrollableOverflow); // Called to set the child frames. We typically have three: the scroll area, // the vertical scrollbar, and the horizontal scrollbar. virtual void SetInitialChildList(ChildListID aListID, nsFrameList& aChildList) override; virtual void AppendFrames(ChildListID aListID, nsFrameList& aFrameList) override; virtual void InsertFrames(ChildListID aListID, nsIFrame* aPrevFrame, nsFrameList& aFrameList) override; virtual void RemoveFrame(ChildListID aListID, nsIFrame* aOldFrame) override; virtual void DestroyFrom(nsIFrame* aDestructRoot, PostDestroyData& aPostDestroyData) override; virtual nsIScrollableFrame* GetScrollTargetFrame() override { return this; } virtual nsContainerFrame* GetContentInsertionFrame() override { return mHelper.GetScrolledFrame()->GetContentInsertionFrame(); } virtual bool DoesClipChildren() override { return true; } virtual nsSplittableType GetSplittableType() const override; nsPoint GetPositionOfChildIgnoringScrolling(const nsIFrame* aChild) override { nsPoint pt = aChild->GetPosition(); if (aChild == mHelper.GetScrolledFrame()) pt += GetScrollPosition(); return pt; } // nsIAnonymousContentCreator virtual nsresult CreateAnonymousContent(nsTArray& aElements) override; virtual void AppendAnonymousContentTo(nsTArray& aElements, uint32_t aFilter) override; // nsIScrollableFrame virtual nsIFrame* GetScrolledFrame() const override { return mHelper.GetScrolledFrame(); } virtual mozilla::ScrollbarStyles GetScrollbarStyles() const override { return mHelper.GetScrollbarStylesFromFrame(); } virtual uint32_t GetScrollbarVisibility() const override { return mHelper.GetScrollbarVisibility(); } virtual nsMargin GetActualScrollbarSizes() const override { return mHelper.GetActualScrollbarSizes(); } virtual nsMargin GetDesiredScrollbarSizes(nsBoxLayoutState* aState) override { return mHelper.GetDesiredScrollbarSizes(aState); } virtual nsMargin GetDesiredScrollbarSizes(nsPresContext* aPresContext, gfxContext* aRC) override { nsBoxLayoutState bls(aPresContext, aRC, 0); return GetDesiredScrollbarSizes(&bls); } virtual nscoord GetNondisappearingScrollbarWidth(nsPresContext* aPresContext, gfxContext* aRC, mozilla::WritingMode aWM) override { nsBoxLayoutState bls(aPresContext, aRC, 0); return mHelper.GetNondisappearingScrollbarWidth(&bls, aWM); } virtual nsRect GetScrolledRect() const override { return mHelper.GetScrolledRect(); } virtual nsRect GetScrollPortRect() const override { return mHelper.GetScrollPortRect(); } virtual nsPoint GetScrollPosition() const override { return mHelper.GetScrollPosition(); } virtual nsPoint GetLogicalScrollPosition() const override { return mHelper.GetLogicalScrollPosition(); } virtual nsRect GetScrollRange() const override { return mHelper.GetScrollRange(); } virtual nsSize GetScrollPositionClampingScrollPortSize() const override { return mHelper.GetScrollPositionClampingScrollPortSize(); } virtual nsSize GetLineScrollAmount() const override { return mHelper.GetLineScrollAmount(); } virtual nsSize GetPageScrollAmount() const override { return mHelper.GetPageScrollAmount(); } /** * @note This method might destroy the frame, pres shell and other objects. */ virtual void ScrollTo(nsPoint aScrollPosition, ScrollMode aMode, const nsRect* aRange = nullptr, nsIScrollbarMediator::ScrollSnapMode aSnap = nsIScrollbarMediator::DISABLE_SNAP) override { mHelper.ScrollTo(aScrollPosition, aMode, aRange, aSnap); } /** * @note This method might destroy the frame, pres shell and other objects. */ virtual void ScrollToCSSPixels(const CSSIntPoint& aScrollPosition, nsIScrollableFrame::ScrollMode aMode = nsIScrollableFrame::INSTANT) override { mHelper.ScrollToCSSPixels(aScrollPosition, aMode); } virtual void ScrollToCSSPixelsApproximate(const mozilla::CSSPoint& aScrollPosition, nsAtom* aOrigin = nullptr) override { mHelper.ScrollToCSSPixelsApproximate(aScrollPosition, aOrigin); } /** * @note This method might destroy the frame, pres shell and other objects. */ virtual CSSIntPoint GetScrollPositionCSSPixels() override { return mHelper.GetScrollPositionCSSPixels(); } /** * @note This method might destroy the frame, pres shell and other objects. */ virtual void ScrollBy(nsIntPoint aDelta, ScrollUnit aUnit, ScrollMode aMode, nsIntPoint* aOverflow, nsAtom* aOrigin = nullptr, nsIScrollableFrame::ScrollMomentum aMomentum = nsIScrollableFrame::NOT_MOMENTUM, nsIScrollbarMediator::ScrollSnapMode aSnap = nsIScrollbarMediator::DISABLE_SNAP) override { mHelper.ScrollBy(aDelta, aUnit, aMode, aOverflow, aOrigin, aMomentum, aSnap); } virtual void ScrollSnap() override { mHelper.ScrollSnap(); } /** * @note This method might destroy the frame, pres shell and other objects. */ virtual void ScrollToRestoredPosition() override { mHelper.ScrollToRestoredPosition(); } virtual void AddScrollPositionListener(nsIScrollPositionListener* aListener) override { mHelper.AddScrollPositionListener(aListener); } virtual void RemoveScrollPositionListener(nsIScrollPositionListener* aListener) override { mHelper.RemoveScrollPositionListener(aListener); } /** * @note This method might destroy the frame, pres shell and other objects. */ virtual void CurPosAttributeChanged(nsIContent* aChild) override { mHelper.CurPosAttributeChanged(aChild); } NS_IMETHOD PostScrolledAreaEventForCurrentArea() override { mHelper.PostScrolledAreaEvent(); return NS_OK; } virtual bool IsScrollingActive(nsDisplayListBuilder* aBuilder) override { return mHelper.IsScrollingActive(aBuilder); } virtual bool IsMaybeScrollingActive() const override { return mHelper.IsMaybeScrollingActive(); } virtual bool IsMaybeAsynchronouslyScrolled() override { return mHelper.IsMaybeAsynchronouslyScrolled(); } virtual bool IsProcessingAsyncScroll() override { return mHelper.IsProcessingAsyncScroll(); } virtual void ResetScrollPositionForLayerPixelAlignment() override { mHelper.ResetScrollPositionForLayerPixelAlignment(); } virtual bool DidHistoryRestore() const override { return mHelper.mDidHistoryRestore; } virtual void ClearDidHistoryRestore() override { mHelper.mDidHistoryRestore = false; } virtual bool IsRectNearlyVisible(const nsRect& aRect) override { return mHelper.IsRectNearlyVisible(aRect); } virtual nsRect ExpandRectToNearlyVisible(const nsRect& aRect) const override { return mHelper.ExpandRectToNearlyVisible(aRect); } virtual nsAtom* LastScrollOrigin() override { return mHelper.LastScrollOrigin(); } virtual void AllowScrollOriginDowngrade() override { mHelper.AllowScrollOriginDowngrade(); } virtual nsAtom* LastSmoothScrollOrigin() override { return mHelper.LastSmoothScrollOrigin(); } virtual uint32_t CurrentScrollGeneration() override { return mHelper.CurrentScrollGeneration(); } virtual nsPoint LastScrollDestination() override { return mHelper.LastScrollDestination(); } virtual void ResetScrollInfoIfGeneration(uint32_t aGeneration) override { mHelper.ResetScrollInfoIfGeneration(aGeneration); } virtual bool WantAsyncScroll() const override { return mHelper.WantAsyncScroll(); } virtual mozilla::Maybe ComputeScrollMetadata( LayerManager* aLayerManager, const nsIFrame* aContainerReferenceFrame, const ContainerLayerParameters& aParameters, const mozilla::DisplayItemClip* aClip) const override { return mHelper.ComputeScrollMetadata(aLayerManager, aContainerReferenceFrame, aParameters, aClip); } virtual void ClipLayerToDisplayPort(Layer* aLayer, const mozilla::DisplayItemClip* aClip, const ContainerLayerParameters& aParameters) const override { mHelper.ClipLayerToDisplayPort(aLayer, aClip, aParameters); } virtual bool IsIgnoringViewportClipping() const override { return mHelper.IsIgnoringViewportClipping(); } virtual void MarkScrollbarsDirtyForReflow() const override { mHelper.MarkScrollbarsDirtyForReflow(); } virtual bool UsesContainerScrolling() const override { return mHelper.UsesContainerScrolling(); } virtual bool DecideScrollableLayer(nsDisplayListBuilder* aBuilder, nsRect* aVisibleRect, nsRect* aDirtyRect, bool aSetBase) override { return mHelper.DecideScrollableLayer(aBuilder, aVisibleRect, aDirtyRect, aSetBase); } virtual void NotifyApproximateFrameVisibilityUpdate(bool aIgnoreDisplayPort) override { mHelper.NotifyApproximateFrameVisibilityUpdate(aIgnoreDisplayPort); } virtual bool GetDisplayPortAtLastApproximateFrameVisibilityUpdate(nsRect* aDisplayPort) override { return mHelper.GetDisplayPortAtLastApproximateFrameVisibilityUpdate(aDisplayPort); } void TriggerDisplayPortExpiration() override { mHelper.TriggerDisplayPortExpiration(); } // nsIStatefulFrame mozilla::UniquePtr SaveState() override { return mHelper.SaveState(); } NS_IMETHOD RestoreState(mozilla::PresState* aState) override { NS_ENSURE_ARG_POINTER(aState); mHelper.RestoreState(aState); return NS_OK; } // nsIScrollbarMediator virtual void ScrollByPage(nsScrollbarFrame* aScrollbar, int32_t aDirection, nsIScrollbarMediator::ScrollSnapMode aSnap = nsIScrollbarMediator::DISABLE_SNAP) override { mHelper.ScrollByPage(aScrollbar, aDirection, aSnap); } virtual void ScrollByWhole(nsScrollbarFrame* aScrollbar, int32_t aDirection, nsIScrollbarMediator::ScrollSnapMode aSnap = nsIScrollbarMediator::DISABLE_SNAP) override { mHelper.ScrollByWhole(aScrollbar, aDirection, aSnap); } virtual void ScrollByLine(nsScrollbarFrame* aScrollbar, int32_t aDirection, nsIScrollbarMediator::ScrollSnapMode aSnap = nsIScrollbarMediator::DISABLE_SNAP) override { mHelper.ScrollByLine(aScrollbar, aDirection, aSnap); } virtual void RepeatButtonScroll(nsScrollbarFrame* aScrollbar) override { mHelper.RepeatButtonScroll(aScrollbar); } virtual void ThumbMoved(nsScrollbarFrame* aScrollbar, nscoord aOldPos, nscoord aNewPos) override { mHelper.ThumbMoved(aScrollbar, aOldPos, aNewPos); } virtual void ScrollbarReleased(nsScrollbarFrame* aScrollbar) override { mHelper.ScrollbarReleased(aScrollbar); } virtual void VisibilityChanged(bool aVisible) override {} virtual nsIFrame* GetScrollbarBox(bool aVertical) override { return mHelper.GetScrollbarBox(aVertical); } virtual void ScrollbarActivityStarted() const override; virtual void ScrollbarActivityStopped() const override; virtual bool IsScrollbarOnRight() const override { return mHelper.IsScrollbarOnRight(); } virtual bool ShouldSuppressScrollbarRepaints() const override { return mHelper.ShouldSuppressScrollbarRepaints(); } virtual void SetTransformingByAPZ(bool aTransforming) override { mHelper.SetTransformingByAPZ(aTransforming); } bool IsTransformingByAPZ() const override { return mHelper.IsTransformingByAPZ(); } void SetScrollableByAPZ(bool aScrollable) override { mHelper.SetScrollableByAPZ(aScrollable); } void SetZoomableByAPZ(bool aZoomable) override { mHelper.SetZoomableByAPZ(aZoomable); } void SetHasOutOfFlowContentInsideFilter() override { mHelper.SetHasOutOfFlowContentInsideFilter(); } ScrollSnapInfo GetScrollSnapInfo() const override { return mHelper.GetScrollSnapInfo(); } virtual bool DragScroll(mozilla::WidgetEvent* aEvent) override { return mHelper.DragScroll(aEvent); } virtual void AsyncScrollbarDragRejected() override { return mHelper.AsyncScrollbarDragRejected(); } virtual bool IsRootScrollFrameOfDocument() const override { return mHelper.IsRootScrollFrameOfDocument(); } // Return the scrolled frame. void AppendDirectlyOwnedAnonBoxes(nsTArray& aResult) override { aResult.AppendElement(OwnedAnonBox(mHelper.GetScrolledFrame())); } #ifdef DEBUG_FRAME_DUMP virtual nsresult GetFrameName(nsAString& aResult) const override; #endif #ifdef ACCESSIBILITY virtual mozilla::a11y::AccType AccessibleType() override; #endif protected: nsHTMLScrollFrame(ComputedStyle* aStyle, bool aIsRoot) : nsHTMLScrollFrame(aStyle, kClassID, aIsRoot) {} nsHTMLScrollFrame(ComputedStyle* aStyle, nsIFrame::ClassID aID, bool aIsRoot); void SetSuppressScrollbarUpdate(bool aSuppress) { mHelper.mSuppressScrollbarUpdate = aSuppress; } bool GuessHScrollbarNeeded(const ScrollReflowInput& aState); bool GuessVScrollbarNeeded(const ScrollReflowInput& aState); bool IsScrollbarUpdateSuppressed() const { return mHelper.mSuppressScrollbarUpdate; } // Return whether we're in an "initial" reflow. Some reflows with // NS_FRAME_FIRST_REFLOW set are NOT "initial" as far as we're concerned. bool InInitialReflow() const; /** * Override this to return false if computed bsize/min-bsize/max-bsize * should NOT be propagated to child content. * nsListControlFrame uses this. */ virtual bool ShouldPropagateComputedBSizeToScrolledContent() const { return true; } private: friend class mozilla::ScrollFrameHelper; ScrollFrameHelper mHelper; }; /** * The scroll frame creates and manages the scrolling view * * It only supports having a single child frame that typically is an area * frame, but doesn't have to be. The child frame must have a view, though * * Scroll frames don't support incremental changes, i.e. you can't replace * or remove the scrolled frame */ class nsXULScrollFrame final : public nsBoxFrame, public nsIScrollableFrame, public nsIAnonymousContentCreator, public nsIStatefulFrame { public: typedef mozilla::ScrollFrameHelper ScrollFrameHelper; typedef mozilla::CSSIntPoint CSSIntPoint; NS_DECL_QUERYFRAME NS_DECL_FRAMEARENA_HELPERS(nsXULScrollFrame) friend nsXULScrollFrame* NS_NewXULScrollFrame(nsIPresShell* aPresShell, ComputedStyle* aStyle, bool aIsRoot, bool aClipAllDescendants); virtual void BuildDisplayList(nsDisplayListBuilder* aBuilder, const nsDisplayListSet& aLists) override { mHelper.BuildDisplayList(aBuilder, aLists); } // XXXldb Is this actually used? #if 0 virtual nscoord GetMinISize(gfxContext *aRenderingContext) override; #endif virtual bool ComputeCustomOverflow(nsOverflowAreas& aOverflowAreas) override { return mHelper.ComputeCustomOverflow(aOverflowAreas); } bool GetVerticalAlignBaseline(mozilla::WritingMode aWM, nscoord* aBaseline) const override { *aBaseline = GetLogicalBaseline(aWM); return true; } // Called to set the child frames. We typically have three: the scroll area, // the vertical scrollbar, and the horizontal scrollbar. virtual void SetInitialChildList(ChildListID aListID, nsFrameList& aChildList) override; virtual void AppendFrames(ChildListID aListID, nsFrameList& aFrameList) override; virtual void InsertFrames(ChildListID aListID, nsIFrame* aPrevFrame, nsFrameList& aFrameList) override; virtual void RemoveFrame(ChildListID aListID, nsIFrame* aOldFrame) override; virtual void DestroyFrom(nsIFrame* aDestructRoot, PostDestroyData& aPostDestroyData) override; virtual nsIScrollableFrame* GetScrollTargetFrame() override { return this; } virtual nsContainerFrame* GetContentInsertionFrame() override { return mHelper.GetScrolledFrame()->GetContentInsertionFrame(); } virtual bool DoesClipChildren() override { return true; } virtual nsSplittableType GetSplittableType() const override; nsPoint GetPositionOfChildIgnoringScrolling(const nsIFrame* aChild) override { nsPoint pt = aChild->GetPosition(); if (aChild == mHelper.GetScrolledFrame()) pt += mHelper.GetLogicalScrollPosition(); return pt; } // nsIAnonymousContentCreator virtual nsresult CreateAnonymousContent(nsTArray& aElements) override; virtual void AppendAnonymousContentTo(nsTArray& aElements, uint32_t aFilter) override; virtual nsSize GetXULMinSize(nsBoxLayoutState& aBoxLayoutState) override; virtual nsSize GetXULPrefSize(nsBoxLayoutState& aBoxLayoutState) override; virtual nsSize GetXULMaxSize(nsBoxLayoutState& aBoxLayoutState) override; virtual nscoord GetXULBoxAscent(nsBoxLayoutState& aBoxLayoutState) override; NS_IMETHOD DoXULLayout(nsBoxLayoutState& aBoxLayoutState) override; virtual nsresult GetXULPadding(nsMargin& aPadding) override; virtual bool GetBorderRadii(const nsSize& aFrameSize, const nsSize& aBorderArea, Sides aSkipSides, nscoord aRadii[8]) const override { return mHelper.GetBorderRadii(aFrameSize, aBorderArea, aSkipSides, aRadii); } nsresult XULLayout(nsBoxLayoutState& aState); void LayoutScrollArea(nsBoxLayoutState& aState, const nsPoint& aScrollPosition); static bool AddRemoveScrollbar(bool& aHasScrollbar, nscoord& aXY, nscoord& aSize, nscoord aSbSize, bool aOnRightOrBottom, bool aAdd); bool AddRemoveScrollbar(nsBoxLayoutState& aState, bool aOnRightOrBottom, bool aHorizontal, bool aAdd); bool AddHorizontalScrollbar (nsBoxLayoutState& aState, bool aOnBottom); bool AddVerticalScrollbar (nsBoxLayoutState& aState, bool aOnRight); void RemoveHorizontalScrollbar(nsBoxLayoutState& aState, bool aOnBottom); void RemoveVerticalScrollbar (nsBoxLayoutState& aState, bool aOnRight); static void AdjustReflowInputForPrintPreview(nsBoxLayoutState& aState, bool& aSetBack); static void AdjustReflowInputBack(nsBoxLayoutState& aState, bool aSetBack); // nsIScrollableFrame virtual nsIFrame* GetScrolledFrame() const override { return mHelper.GetScrolledFrame(); } virtual mozilla::ScrollbarStyles GetScrollbarStyles() const override { return mHelper.GetScrollbarStylesFromFrame(); } virtual uint32_t GetScrollbarVisibility() const override { return mHelper.GetScrollbarVisibility(); } virtual nsMargin GetActualScrollbarSizes() const override { return mHelper.GetActualScrollbarSizes(); } virtual nsMargin GetDesiredScrollbarSizes(nsBoxLayoutState* aState) override { return mHelper.GetDesiredScrollbarSizes(aState); } virtual nsMargin GetDesiredScrollbarSizes(nsPresContext* aPresContext, gfxContext* aRC) override { nsBoxLayoutState bls(aPresContext, aRC, 0); return GetDesiredScrollbarSizes(&bls); } virtual nscoord GetNondisappearingScrollbarWidth(nsPresContext* aPresContext, gfxContext* aRC, mozilla::WritingMode aWM) override { nsBoxLayoutState bls(aPresContext, aRC, 0); return mHelper.GetNondisappearingScrollbarWidth(&bls, aWM); } virtual nsRect GetScrolledRect() const override { return mHelper.GetScrolledRect(); } virtual nsRect GetScrollPortRect() const override { return mHelper.GetScrollPortRect(); } virtual nsPoint GetScrollPosition() const override { return mHelper.GetScrollPosition(); } virtual nsPoint GetLogicalScrollPosition() const override { return mHelper.GetLogicalScrollPosition(); } virtual nsRect GetScrollRange() const override { return mHelper.GetScrollRange(); } virtual nsSize GetScrollPositionClampingScrollPortSize() const override { return mHelper.GetScrollPositionClampingScrollPortSize(); } virtual nsSize GetLineScrollAmount() const override { return mHelper.GetLineScrollAmount(); } virtual nsSize GetPageScrollAmount() const override { return mHelper.GetPageScrollAmount(); } /** * @note This method might destroy the frame, pres shell and other objects. */ virtual void ScrollTo(nsPoint aScrollPosition, ScrollMode aMode, const nsRect* aRange = nullptr, ScrollSnapMode aSnap = nsIScrollbarMediator::DISABLE_SNAP) override { mHelper.ScrollTo(aScrollPosition, aMode, aRange, aSnap); } /** * @note This method might destroy the frame, pres shell and other objects. */ virtual void ScrollToCSSPixels(const CSSIntPoint& aScrollPosition, nsIScrollableFrame::ScrollMode aMode = nsIScrollableFrame::INSTANT) override { mHelper.ScrollToCSSPixels(aScrollPosition, aMode); } virtual void ScrollToCSSPixelsApproximate(const mozilla::CSSPoint& aScrollPosition, nsAtom* aOrigin = nullptr) override { mHelper.ScrollToCSSPixelsApproximate(aScrollPosition, aOrigin); } virtual CSSIntPoint GetScrollPositionCSSPixels() override { return mHelper.GetScrollPositionCSSPixels(); } /** * @note This method might destroy the frame, pres shell and other objects. */ virtual void ScrollBy(nsIntPoint aDelta, ScrollUnit aUnit, ScrollMode aMode, nsIntPoint* aOverflow, nsAtom* aOrigin = nullptr, nsIScrollableFrame::ScrollMomentum aMomentum = nsIScrollableFrame::NOT_MOMENTUM, nsIScrollbarMediator::ScrollSnapMode aSnap = nsIScrollbarMediator::DISABLE_SNAP) override { mHelper.ScrollBy(aDelta, aUnit, aMode, aOverflow, aOrigin, aMomentum, aSnap); } virtual void ScrollSnap() override { mHelper.ScrollSnap(); } /** * @note This method might destroy the frame, pres shell and other objects. */ virtual void ScrollToRestoredPosition() override { mHelper.ScrollToRestoredPosition(); } virtual void AddScrollPositionListener(nsIScrollPositionListener* aListener) override { mHelper.AddScrollPositionListener(aListener); } virtual void RemoveScrollPositionListener(nsIScrollPositionListener* aListener) override { mHelper.RemoveScrollPositionListener(aListener); } /** * @note This method might destroy the frame, pres shell and other objects. */ virtual void CurPosAttributeChanged(nsIContent* aChild) override { mHelper.CurPosAttributeChanged(aChild); } NS_IMETHOD PostScrolledAreaEventForCurrentArea() override { mHelper.PostScrolledAreaEvent(); return NS_OK; } virtual bool IsScrollingActive(nsDisplayListBuilder* aBuilder) override { return mHelper.IsScrollingActive(aBuilder); } virtual bool IsMaybeScrollingActive() const override { return mHelper.IsMaybeScrollingActive(); } virtual bool IsMaybeAsynchronouslyScrolled() override { return mHelper.IsMaybeAsynchronouslyScrolled(); } virtual bool IsProcessingAsyncScroll() override { return mHelper.IsProcessingAsyncScroll(); } virtual void ResetScrollPositionForLayerPixelAlignment() override { mHelper.ResetScrollPositionForLayerPixelAlignment(); } virtual bool DidHistoryRestore() const override { return mHelper.mDidHistoryRestore; } virtual void ClearDidHistoryRestore() override { mHelper.mDidHistoryRestore = false; } virtual bool IsRectNearlyVisible(const nsRect& aRect) override { return mHelper.IsRectNearlyVisible(aRect); } virtual nsRect ExpandRectToNearlyVisible(const nsRect& aRect) const override { return mHelper.ExpandRectToNearlyVisible(aRect); } virtual nsAtom* LastScrollOrigin() override { return mHelper.LastScrollOrigin(); } virtual void AllowScrollOriginDowngrade() override { mHelper.AllowScrollOriginDowngrade(); } virtual nsAtom* LastSmoothScrollOrigin() override { return mHelper.LastSmoothScrollOrigin(); } virtual uint32_t CurrentScrollGeneration() override { return mHelper.CurrentScrollGeneration(); } virtual nsPoint LastScrollDestination() override { return mHelper.LastScrollDestination(); } virtual void ResetScrollInfoIfGeneration(uint32_t aGeneration) override { mHelper.ResetScrollInfoIfGeneration(aGeneration); } virtual bool WantAsyncScroll() const override { return mHelper.WantAsyncScroll(); } virtual mozilla::Maybe ComputeScrollMetadata( LayerManager* aLayerManager, const nsIFrame* aContainerReferenceFrame, const ContainerLayerParameters& aParameters, const mozilla::DisplayItemClip* aClip) const override { return mHelper.ComputeScrollMetadata(aLayerManager, aContainerReferenceFrame, aParameters, aClip); } virtual void ClipLayerToDisplayPort(Layer* aLayer, const mozilla::DisplayItemClip* aClip, const ContainerLayerParameters& aParameters) const override { mHelper.ClipLayerToDisplayPort(aLayer, aClip, aParameters); } virtual bool IsIgnoringViewportClipping() const override { return mHelper.IsIgnoringViewportClipping(); } virtual void MarkScrollbarsDirtyForReflow() const override { mHelper.MarkScrollbarsDirtyForReflow(); } // nsIStatefulFrame mozilla::UniquePtr SaveState() override { return mHelper.SaveState(); } NS_IMETHOD RestoreState(mozilla::PresState* aState) override { NS_ENSURE_ARG_POINTER(aState); mHelper.RestoreState(aState); return NS_OK; } virtual bool IsFrameOfType(uint32_t aFlags) const override { // Override bogus IsFrameOfType in nsBoxFrame. if (aFlags & (nsIFrame::eReplacedContainsBlock | nsIFrame::eReplaced)) return false; return nsBoxFrame::IsFrameOfType(aFlags); } virtual void ScrollByPage(nsScrollbarFrame* aScrollbar, int32_t aDirection, nsIScrollbarMediator::ScrollSnapMode aSnap = nsIScrollbarMediator::DISABLE_SNAP) override { mHelper.ScrollByPage(aScrollbar, aDirection, aSnap); } virtual void ScrollByWhole(nsScrollbarFrame* aScrollbar, int32_t aDirection, nsIScrollbarMediator::ScrollSnapMode aSnap = nsIScrollbarMediator::DISABLE_SNAP) override { mHelper.ScrollByWhole(aScrollbar, aDirection, aSnap); } virtual void ScrollByLine(nsScrollbarFrame* aScrollbar, int32_t aDirection, nsIScrollbarMediator::ScrollSnapMode aSnap = nsIScrollbarMediator::DISABLE_SNAP) override { mHelper.ScrollByLine(aScrollbar, aDirection, aSnap); } virtual void RepeatButtonScroll(nsScrollbarFrame* aScrollbar) override { mHelper.RepeatButtonScroll(aScrollbar); } virtual void ThumbMoved(nsScrollbarFrame* aScrollbar, nscoord aOldPos, nscoord aNewPos) override { mHelper.ThumbMoved(aScrollbar, aOldPos, aNewPos); } virtual void ScrollbarReleased(nsScrollbarFrame* aScrollbar) override { mHelper.ScrollbarReleased(aScrollbar); } virtual void VisibilityChanged(bool aVisible) override {} virtual nsIFrame* GetScrollbarBox(bool aVertical) override { return mHelper.GetScrollbarBox(aVertical); } virtual void ScrollbarActivityStarted() const override; virtual void ScrollbarActivityStopped() const override; virtual bool IsScrollbarOnRight() const override { return mHelper.IsScrollbarOnRight(); } virtual bool ShouldSuppressScrollbarRepaints() const override { return mHelper.ShouldSuppressScrollbarRepaints(); } virtual void SetTransformingByAPZ(bool aTransforming) override { mHelper.SetTransformingByAPZ(aTransforming); } virtual bool UsesContainerScrolling() const override { return mHelper.UsesContainerScrolling(); } bool IsTransformingByAPZ() const override { return mHelper.IsTransformingByAPZ(); } void SetScrollableByAPZ(bool aScrollable) override { mHelper.SetScrollableByAPZ(aScrollable); } void SetZoomableByAPZ(bool aZoomable) override { mHelper.SetZoomableByAPZ(aZoomable); } void SetHasOutOfFlowContentInsideFilter() override { mHelper.SetHasOutOfFlowContentInsideFilter(); } virtual bool DecideScrollableLayer(nsDisplayListBuilder* aBuilder, nsRect* aVisibleRect, nsRect* aDirtyRect, bool aSetBase) override { return mHelper.DecideScrollableLayer(aBuilder, aVisibleRect, aDirtyRect, aSetBase); } virtual void NotifyApproximateFrameVisibilityUpdate(bool aIgnoreDisplayPort) override { mHelper.NotifyApproximateFrameVisibilityUpdate(aIgnoreDisplayPort); } virtual bool GetDisplayPortAtLastApproximateFrameVisibilityUpdate(nsRect* aDisplayPort) override { return mHelper.GetDisplayPortAtLastApproximateFrameVisibilityUpdate(aDisplayPort); } void TriggerDisplayPortExpiration() override { mHelper.TriggerDisplayPortExpiration(); } ScrollSnapInfo GetScrollSnapInfo() const override { return mHelper.GetScrollSnapInfo(); } virtual bool DragScroll(mozilla::WidgetEvent* aEvent) override { return mHelper.DragScroll(aEvent); } virtual void AsyncScrollbarDragRejected() override { return mHelper.AsyncScrollbarDragRejected(); } virtual bool IsRootScrollFrameOfDocument() const override { return mHelper.IsRootScrollFrameOfDocument(); } // Return the scrolled frame. void AppendDirectlyOwnedAnonBoxes(nsTArray& aResult) override { aResult.AppendElement(OwnedAnonBox(mHelper.GetScrolledFrame())); } #ifdef DEBUG_FRAME_DUMP virtual nsresult GetFrameName(nsAString& aResult) const override; #endif protected: nsXULScrollFrame(ComputedStyle* aStyle, bool aIsRoot, bool aClipAllDescendants); void ClampAndSetBounds(nsBoxLayoutState& aState, nsRect& aRect, nsPoint aScrollPosition, bool aRemoveOverflowAreas = false) { /* * For RTL frames, restore the original scrolled position of the right * edge, then subtract the current width to find the physical position. */ if (!mHelper.IsPhysicalLTR()) { aRect.x = mHelper.mScrollPort.XMost() - aScrollPosition.x - aRect.width; } mHelper.mScrolledFrame->SetXULBounds(aState, aRect, aRemoveOverflowAreas); } private: friend class mozilla::ScrollFrameHelper; ScrollFrameHelper mHelper; }; #endif /* nsGfxScrollFrame_h___ */