1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114
|
/*
* Copyright (C) 2022 Apple Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
* OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
#pragma once
#include "ScrollView.h"
#include <wtf/TZoneMallocInlines.h>
namespace WebCore {
class Frame;
enum class RenderAsTextFlag : uint16_t;
class FrameView : public ScrollView {
WTF_MAKE_TZONE_ALLOCATED(FrameView);
WTF_OVERRIDE_DELETE_FOR_CHECKED_PTR(FrameView);
public:
enum class Type : bool { Local, Remote };
virtual Type viewType() const = 0;
virtual void writeRenderTreeAsText(TextStream&, OptionSet<RenderAsTextFlag>) = 0;
virtual Frame& frame() const = 0;
WEBCORE_EXPORT int headerHeight() const final;
WEBCORE_EXPORT int footerHeight() const final;
WEBCORE_EXPORT FloatBoxExtent obscuredContentInsets(InsetType = InsetType::WebCoreInset) const final;
float visibleContentScaleFactor() const final;
HostWindow* hostWindow() const final;
WEBCORE_EXPORT void invalidateRect(const IntRect&) final;
bool isActive() const final;
bool forceUpdateScrollbarsOnMainThreadForPerformanceTesting() const final;
IntRect scrollableAreaBoundingBox(bool* = nullptr) const final;
void scrollbarStyleChanged(ScrollbarStyle, bool forceUpdate) override;
// Coordinate systems:
//
// "View"
// Top left is top left of the FrameView/ScrollView/Widget. Size is Widget::boundsRect().size().
//
// "TotalContents"
// Relative to ScrollView's scrolled contents, including headers and footers. Size is totalContentsSize().
//
// "Contents"
// Relative to ScrollView's scrolled contents, excluding headers and footers, so top left is top left of the scroll view's
// document, and size is contentsSize().
//
// "Absolute"
// Relative to the document's scroll origin (non-zero for RTL documents), but affected by page zoom and page scale. Mostly used
// in rendering code.
//
// "Document"
// Relative to the document's scroll origin, but not affected by page zoom or page scale. Size is equivalent to CSS pixel dimensions.
// FIXME: some uses are affected by page zoom (e.g. layout and visual viewports).
//
// "Client"
// Relative to the visible part of the document (or, more strictly, the layout viewport rect), and with the same scaling
// as Document coordinates, i.e. matching CSS pixels. Affected by scroll origin.
//
// "LayoutViewport"
// Similar to client coordinates, but affected by page zoom (but not page scale).
//
// Methods to convert points and rects between the coordinate space of the renderer, and this view.
WEBCORE_EXPORT IntRect convertFromRendererToContainingView(const RenderElement*, const IntRect&) const;
WEBCORE_EXPORT IntRect convertFromContainingViewToRenderer(const RenderElement*, const IntRect&) const;
WEBCORE_EXPORT FloatRect convertFromContainingViewToRenderer(const RenderElement*, const FloatRect&) const;
WEBCORE_EXPORT IntPoint convertFromRendererToContainingView(const RenderElement*, const IntPoint&) const;
WEBCORE_EXPORT FloatPoint convertFromRendererToContainingView(const RenderElement*, const FloatPoint&) const;
WEBCORE_EXPORT IntPoint convertFromContainingViewToRenderer(const RenderElement*, const IntPoint&) const;
// Override ScrollView methods to do point conversion via renderers, in order to take transforms into account.
IntRect convertToContainingView(const IntRect&) const final;
IntRect convertFromContainingView(const IntRect&) const final;
FloatRect convertFromContainingView(const FloatRect&) const final;
IntPoint convertToContainingView(const IntPoint&) const final;
FloatPoint convertToContainingView(const FloatPoint&) const final;
IntPoint convertFromContainingView(const IntPoint&) const final;
private:
ScrollableArea* enclosingScrollableArea() const final;
bool scrollAnimatorEnabled() const final;
};
}
SPECIALIZE_TYPE_TRAITS_BEGIN(WebCore::FrameView)
static bool isType(const WebCore::Widget& widget) { return widget.isLocalFrameView() || widget.isRemoteFrameView(); }
SPECIALIZE_TYPE_TRAITS_END()
|