forked from mirrors/gecko-dev
38b10eafda
This rewrites scrollbar layout to work with regular reflow rather than box layout. Overall it's about the same amount of code (mostly because nsScrollbarFrame::Reflow is sorta hand-rolled), but it cleans up a bit and it is progress towards removing XUL layout altogether, without getting into much deeper refactoring. This also blocks some other performance improvements and refactorings I want to make in this code. We make some assumptions to simplify the code that to some extent were made already before, both explicitly and by virtue of using XUL layout. In particular, we assume that scrollbar / slider / thumb has no border or padding and that the writing-mode is horizontal ltr. Differential Revision: https://phabricator.services.mozilla.com/D173489
101 lines
4.1 KiB
C++
101 lines
4.1 KiB
C++
/* -*- 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 nsIScrollbarMediator_h___
|
|
#define nsIScrollbarMediator_h___
|
|
|
|
#include "mozilla/ScrollTypes.h"
|
|
#include "nsQueryFrame.h"
|
|
#include "nsCoord.h"
|
|
|
|
class nsScrollbarFrame;
|
|
class nsIFrame;
|
|
|
|
class nsIScrollbarMediator : public nsQueryFrame {
|
|
public:
|
|
NS_DECL_QUERYFRAME_TARGET(nsIScrollbarMediator)
|
|
|
|
/**
|
|
* The aScrollbar argument denotes the scrollbar that's firing the
|
|
* notification. aScrollbar is never null. aDirection is either -1, 0, or 1.
|
|
*/
|
|
|
|
/**
|
|
* When set to ENABLE_SNAP, additional scrolling will be performed after the
|
|
* scroll operation to maintain the constraints set by CSS Scroll snapping.
|
|
* The additional scrolling may include asynchronous smooth scrolls that
|
|
* continue to animate after the initial scroll position has been set.
|
|
* In case of DEFAULT, it means ENABLE_SNAP for CSS scroll snap v1,
|
|
* DISABLE_SNAP for the old scroll snap.
|
|
*/
|
|
|
|
/**
|
|
* One of the following three methods is called when the scrollbar's button is
|
|
* clicked.
|
|
* @note These methods might destroy the frame, pres shell, and other objects.
|
|
*/
|
|
virtual void ScrollByPage(nsScrollbarFrame* aScrollbar, int32_t aDirection,
|
|
mozilla::ScrollSnapFlags aSnapFlags =
|
|
mozilla::ScrollSnapFlags::Disabled) = 0;
|
|
virtual void ScrollByWhole(nsScrollbarFrame* aScrollbar, int32_t aDirection,
|
|
mozilla::ScrollSnapFlags aSnapFlags =
|
|
mozilla::ScrollSnapFlags::Disabled) = 0;
|
|
virtual void ScrollByLine(nsScrollbarFrame* aScrollbar, int32_t aDirection,
|
|
mozilla::ScrollSnapFlags aSnapFlags =
|
|
mozilla::ScrollSnapFlags::Disabled) = 0;
|
|
|
|
// Only implemented for nsGfxScrollFrame, not nsTreeBodyFrame.
|
|
virtual void ScrollByUnit(nsScrollbarFrame* aScrollbar,
|
|
mozilla::ScrollMode aMode, int32_t aDirection,
|
|
mozilla::ScrollUnit aUnit,
|
|
mozilla::ScrollSnapFlags aSnapFlags =
|
|
mozilla::ScrollSnapFlags::Disabled) = 0;
|
|
|
|
/**
|
|
* RepeatButtonScroll is called when the scrollbar's button is held down. When
|
|
* the button is first clicked the increment is set; RepeatButtonScroll adds
|
|
* this increment to the current position.
|
|
* @note This method might destroy the frame, pres shell, and other objects.
|
|
*/
|
|
virtual void RepeatButtonScroll(nsScrollbarFrame* aScrollbar) = 0;
|
|
/**
|
|
* aOldPos and aNewPos are scroll positions.
|
|
* The scroll positions start with zero at the left edge; implementors that
|
|
* want zero at the right edge for RTL content will need to adjust
|
|
* accordingly. (See nsHTMLScrollFrame::ThumbMoved in nsGfxScrollFrame.cpp.)
|
|
* @note This method might destroy the frame, pres shell, and other objects.
|
|
*/
|
|
virtual void ThumbMoved(nsScrollbarFrame* aScrollbar, nscoord aOldPos,
|
|
nscoord aNewPos) = 0;
|
|
/**
|
|
* Called when the scroll bar thumb, slider, or any other component is
|
|
* released.
|
|
*/
|
|
virtual void ScrollbarReleased(nsScrollbarFrame* aScrollbar) = 0;
|
|
virtual void VisibilityChanged(bool aVisible) = 0;
|
|
|
|
/**
|
|
* Obtain the frame for the horizontal or vertical scrollbar, or null
|
|
* if there is no such box.
|
|
*/
|
|
virtual nsScrollbarFrame* GetScrollbarBox(bool aVertical) = 0;
|
|
/**
|
|
* Show or hide scrollbars on 2 fingers touch.
|
|
* Subclasses should call their ScrollbarActivity's corresponding methods.
|
|
*/
|
|
virtual void ScrollbarActivityStarted() const = 0;
|
|
virtual void ScrollbarActivityStopped() const = 0;
|
|
|
|
virtual bool IsScrollbarOnRight() const = 0;
|
|
|
|
/**
|
|
* Returns true if the mediator is asking the scrollbar to suppress
|
|
* repainting itself on changes.
|
|
*/
|
|
virtual bool ShouldSuppressScrollbarRepaints() const = 0;
|
|
};
|
|
|
|
#endif
|