4a6e2c3df6bf34af9c480234bb527ca223d5d161
[WebKit-https.git] / Source / WebCore / page / FrameView.h
1 /*
2    Copyright (C) 1997 Martin Jones (mjones@kde.org)
3              (C) 1998 Waldo Bastian (bastian@kde.org)
4              (C) 1998, 1999 Torben Weis (weis@kde.org)
5              (C) 1999 Lars Knoll (knoll@kde.org)
6              (C) 1999 Antti Koivisto (koivisto@kde.org)
7    Copyright (C) 2004, 2005, 2006, 2007, 2008, 2009 Apple Inc. All rights reserved.
8
9    This library is free software; you can redistribute it and/or
10    modify it under the terms of the GNU Library General Public
11    License as published by the Free Software Foundation; either
12    version 2 of the License, or (at your option) any later version.
13
14    This library is distributed in the hope that it will be useful,
15    but WITHOUT ANY WARRANTY; without even the implied warranty of
16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
17    Library General Public License for more details.
18
19    You should have received a copy of the GNU Library General Public License
20    along with this library; see the file COPYING.LIB.  If not, write to
21    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
22    Boston, MA 02110-1301, USA.
23 */
24
25 #ifndef FrameView_h
26 #define FrameView_h
27
28 #include "AdjustViewSizeOrNot.h"
29 #include "Color.h"
30 #include "LayoutMilestones.h"
31 #include "LayoutRect.h"
32 #include "Pagination.h"
33 #include "PaintPhase.h"
34 #include "ScrollView.h"
35 #include <wtf/Forward.h>
36 #include <wtf/OwnPtr.h>
37 #include <wtf/text/WTFString.h>
38
39 namespace WebCore {
40
41 class AXObjectCache;
42 class Element;
43 class Event;
44 class FloatSize;
45 class Frame;
46 class FrameActionScheduler;
47 class HTMLFrameOwnerElement;
48 class KURL;
49 class Node;
50 class Page;
51 class RenderBox;
52 class RenderEmbeddedObject;
53 class RenderLayer;
54 class RenderObject;
55 class RenderScrollbarPart;
56 class RenderStyle;
57 class RenderView;
58
59 Pagination::Mode paginationModeForRenderStyle(RenderStyle*);
60
61 typedef unsigned long long DOMTimeStamp;
62
63 class FrameView : public ScrollView {
64 public:
65     friend class RenderView;
66     friend class Internals;
67
68     static PassRefPtr<FrameView> create(Frame&);
69     static PassRefPtr<FrameView> create(Frame&, const IntSize& initialSize);
70
71     virtual ~FrameView();
72
73     virtual HostWindow* hostWindow() const;
74     
75     virtual void invalidateRect(const IntRect&);
76     virtual void setFrameRect(const IntRect&);
77
78 #if ENABLE(REQUEST_ANIMATION_FRAME)
79     virtual bool scheduleAnimation();
80 #endif
81
82     Frame& frame() const { return *m_frame; }
83
84     RenderView* renderView() const;
85
86     int mapFromLayoutToCSSUnits(LayoutUnit) const;
87     LayoutUnit mapFromCSSToLayoutUnits(int) const;
88
89     LayoutUnit marginWidth() const { return m_margins.width(); } // -1 means default
90     LayoutUnit marginHeight() const { return m_margins.height(); } // -1 means default
91     void setMarginWidth(LayoutUnit);
92     void setMarginHeight(LayoutUnit);
93
94     virtual void setCanHaveScrollbars(bool);
95     void updateCanHaveScrollbars();
96
97     virtual PassRefPtr<Scrollbar> createScrollbar(ScrollbarOrientation);
98
99     virtual bool avoidScrollbarCreation() const;
100
101     virtual void setContentsSize(const IntSize&);
102
103     void layout(bool allowSubtree = true);
104     bool didFirstLayout() const;
105     void layoutTimerFired(Timer<FrameView>*);
106     void scheduleRelayout();
107     void scheduleRelayoutOfSubtree(RenderObject&);
108     void unscheduleRelayout();
109     bool layoutPending() const;
110     bool isInLayout() const { return m_inLayout; }
111
112     RenderObject* layoutRoot(bool onlyDuringLayout = false) const;
113     void clearLayoutRoot() { m_layoutRoot = 0; }
114     int layoutCount() const { return m_layoutCount; }
115
116     bool needsLayout() const;
117     void setNeedsLayout();
118     void setViewportConstrainedObjectsNeedLayout();
119
120     bool needsFullRepaint() const { return m_needsFullRepaint; }
121
122 #if ENABLE(REQUEST_ANIMATION_FRAME)
123     void serviceScriptedAnimations(double monotonicAnimationStartTime);
124 #endif
125
126 #if USE(ACCELERATED_COMPOSITING)
127     void updateCompositingLayersAfterStyleChange();
128     void updateCompositingLayersAfterLayout();
129     bool flushCompositingStateForThisFrame(Frame* rootFrameForFlush);
130
131     void clearBackingStores();
132     void restoreBackingStores();
133
134     // Called when changes to the GraphicsLayer hierarchy have to be synchronized with
135     // content rendered via the normal painting path.
136     void setNeedsOneShotDrawingSynchronization();
137
138     virtual TiledBacking* tiledBacking() OVERRIDE;
139
140     // In the future when any ScrollableArea can have a node in th ScrollingTree, this should
141     // become a virtual function on ScrollableArea.
142     uint64_t scrollLayerID() const;
143 #endif
144
145     bool hasCompositedContent() const;
146     bool hasCompositedContentIncludingDescendants() const;
147     bool hasCompositingAncestor() const;
148     void enterCompositingMode();
149     bool isEnclosedInCompositingLayer() const;
150
151     // Only used with accelerated compositing, but outside the #ifdef to make linkage easier.
152     // Returns true if the flush was completed.
153     bool flushCompositingStateIncludingSubframes();
154
155     // Returns true when a paint with the PaintBehaviorFlattenCompositingLayers flag set gives
156     // a faithful representation of the content.
157     bool isSoftwareRenderable() const;
158
159     void didMoveOnscreen();
160     void willMoveOffscreen();
161     void setIsInWindow(bool);
162
163     void resetScrollbars();
164     void resetScrollbarsAndClearContentsSize();
165     void prepareForDetach();
166     void detachCustomScrollbars();
167     virtual void recalculateScrollbarOverlayStyle();
168
169     void clear();
170
171     bool isTransparent() const;
172     void setTransparent(bool isTransparent);
173     
174     // True if the FrameView is not transparent, and the base background color is opaque.
175     bool hasOpaqueBackground() const;
176
177     Color baseBackgroundColor() const;
178     void setBaseBackgroundColor(const Color&);
179     void updateBackgroundRecursively(const Color&, bool);
180
181     bool shouldUpdateWhileOffscreen() const;
182     void setShouldUpdateWhileOffscreen(bool);
183     bool shouldUpdate(bool = false) const;
184
185     void adjustViewSize();
186     
187     virtual IntRect windowClipRect(bool clipToContents = true) const;
188     IntRect windowClipRectForFrameOwner(const HTMLFrameOwnerElement*, bool clipToLayerContents) const;
189
190     virtual IntRect windowResizerRect() const;
191
192     virtual float visibleContentScaleFactor() const OVERRIDE;
193
194     virtual void setFixedVisibleContentRect(const IntRect&) OVERRIDE;
195     virtual void setScrollPosition(const IntPoint&) OVERRIDE;
196     void scrollPositionChangedViaPlatformWidget();
197     virtual void repaintFixedElementsAfterScrolling();
198     virtual void updateFixedElementsAfterScrolling();
199     virtual bool shouldRubberBandInDirection(ScrollDirection) const;
200     virtual bool requestScrollPositionUpdate(const IntPoint&) OVERRIDE;
201     virtual bool isRubberBandInProgress() const OVERRIDE;
202     virtual IntPoint minimumScrollPosition() const OVERRIDE;
203     virtual IntPoint maximumScrollPosition() const OVERRIDE;
204
205     // This is different than visibleContentRect() in that it ignores negative (or overly positive)
206     // offsets from rubber-banding, and it takes zooming into account. 
207     LayoutRect viewportConstrainedVisibleContentRect() const;
208
209     String mediaType() const;
210     void setMediaType(const String&);
211     void adjustMediaTypeForPrinting(bool printing);
212
213     void setCannotBlitToWindow();
214     void setIsOverlapped(bool);
215     bool isOverlapped() const { return m_isOverlapped; }
216     bool isOverlappedIncludingAncestors() const;
217     void setContentIsOpaque(bool);
218
219     void addSlowRepaintObject(RenderObject*);
220     void removeSlowRepaintObject(RenderObject*);
221     bool hasSlowRepaintObject(RenderObject* o) const { return m_slowRepaintObjects && m_slowRepaintObjects->contains(o); }
222     bool hasSlowRepaintObjects() const { return m_slowRepaintObjects && m_slowRepaintObjects->size(); }
223
224     // Includes fixed- and sticky-position objects.
225     typedef HashSet<RenderObject*> ViewportConstrainedObjectSet;
226     void addViewportConstrainedObject(RenderObject*);
227     void removeViewportConstrainedObject(RenderObject*);
228     const ViewportConstrainedObjectSet* viewportConstrainedObjects() const { return m_viewportConstrainedObjects.get(); }
229     bool hasViewportConstrainedObjects() const { return m_viewportConstrainedObjects && m_viewportConstrainedObjects->size() > 0; }
230
231     // Functions for querying the current scrolled position, negating the effects of overhang
232     // and adjusting for page scale.
233     IntSize scrollOffsetForFixedPosition() const;
234     // Static function can be called from another thread.
235     static IntSize scrollOffsetForFixedPosition(const IntRect& visibleContentRect, const IntSize& totalContentsSize, const IntPoint& scrollPosition, const IntPoint& scrollOrigin, float frameScaleFactor, bool fixedElementsLayoutRelativeToFrame, int headerHeight, int footerHeight);
236
237     bool fixedElementsLayoutRelativeToFrame() const;
238
239     void beginDeferredRepaints();
240     void endDeferredRepaints();
241     void handleLoadCompleted();
242     void flushDeferredRepaints();
243     void startDeferredRepaintTimer(double delay);
244     void resetDeferredRepaintDelay();
245
246     void updateLayerFlushThrottlingInAllFrames();
247     void adjustTiledBackingCoverage();
248
249     void beginDisableRepaints();
250     void endDisableRepaints();
251     bool repaintsDisabled() { return m_disableRepaints > 0; }
252
253 #if ENABLE(DASHBOARD_SUPPORT) || ENABLE(DRAGGABLE_REGION)
254     void updateAnnotatedRegions();
255 #endif
256     void updateControlTints();
257
258     void restoreScrollbar();
259
260     void scheduleEvent(PassRefPtr<Event>, PassRefPtr<Node>);
261     void pauseScheduledEvents();
262     void resumeScheduledEvents();
263     void postLayoutTimerFired(Timer<FrameView>*);
264
265     bool wasScrolledByUser() const;
266     void setWasScrolledByUser(bool);
267
268     bool safeToPropagateScrollToParent() const { return m_safeToPropagateScrollToParent; }
269     void setSafeToPropagateScrollToParent(bool isSafe) { m_safeToPropagateScrollToParent = isSafe; }
270
271     void addWidgetToUpdate(RenderObject*);
272     void removeWidgetToUpdate(RenderObject*);
273
274     virtual void paintContents(GraphicsContext*, const IntRect& damageRect);
275     void setPaintBehavior(PaintBehavior);
276     PaintBehavior paintBehavior() const;
277     bool isPainting() const;
278     bool hasEverPainted() const { return m_lastPaintTime; }
279     void setLastPaintTime(double lastPaintTime) { m_lastPaintTime = lastPaintTime; }
280     void setNodeToDraw(Node*);
281
282     enum SelectionInSnapshot { IncludeSelection, ExcludeSelection };
283     enum CoordinateSpaceForSnapshot { DocumentCoordinates, ViewCoordinates };
284     void paintContentsForSnapshot(GraphicsContext*, const IntRect& imageRect, SelectionInSnapshot shouldPaintSelection, CoordinateSpaceForSnapshot);
285
286     virtual void paintOverhangAreas(GraphicsContext*, const IntRect& horizontalOverhangArea, const IntRect& verticalOverhangArea, const IntRect& dirtyRect);
287     virtual void paintScrollCorner(GraphicsContext*, const IntRect& cornerRect);
288     virtual void paintScrollbar(GraphicsContext*, Scrollbar*, const IntRect&) OVERRIDE;
289
290     Color documentBackgroundColor() const;
291
292     bool isInChildFrameWithFrameFlattening() const;
293
294     static double currentPaintTimeStamp() { return sCurrentPaintTimeStamp; } // returns 0 if not painting
295     
296     void updateLayoutAndStyleIfNeededRecursive();
297
298     void incrementVisuallyNonEmptyCharacterCount(unsigned);
299     void incrementVisuallyNonEmptyPixelCount(const IntSize&);
300     void updateIsVisuallyNonEmpty();
301     bool isVisuallyNonEmpty() const { return m_isVisuallyNonEmpty; }
302     void enableAutoSizeMode(bool enable, const IntSize& minSize, const IntSize& maxSize);
303     void setAutoSizeFixedMinimumHeight(int fixedMinimumHeight);
304     IntSize autoSizingIntrinsicContentSize() const { return m_autoSizeContentSize; }
305
306     void forceLayout(bool allowSubtree = false);
307     void forceLayoutForPagination(const FloatSize& pageSize, const FloatSize& originalPageSize, float maximumShrinkFactor, AdjustViewSizeOrNot);
308
309     // FIXME: This method is retained because of embedded WebViews in AppKit.  When a WebView is embedded inside
310     // some enclosing view with auto-pagination, no call happens to resize the view.  The new pagination model
311     // needs the view to resize as a result of the breaks, but that means that the enclosing view has to potentially
312     // resize around that view.  Auto-pagination uses the bounds of the actual view that's being printed to determine
313     // the edges of the print operation, so the resize is necessary if the enclosing view's bounds depend on the
314     // web document's bounds.
315     // 
316     // This is already a problem if the view needs to be a different size because of printer fonts or because of print stylesheets.
317     // Mail/Dictionary work around this problem by using the _layoutForPrinting SPI
318     // to at least get print stylesheets and printer fonts into play, but since WebKit doesn't know about the page offset or
319     // page size, it can't actually paginate correctly during _layoutForPrinting.
320     //
321     // We can eventually move Mail to a newer SPI that would let them opt in to the layout-time pagination model,
322     // but that doesn't solve the general problem of how other AppKit views could opt in to the better model.
323     //
324     // NO OTHER PLATFORM BESIDES MAC SHOULD USE THIS METHOD.
325     void adjustPageHeightDeprecated(float* newBottom, float oldTop, float oldBottom, float bottomLimit);
326
327     bool scrollToFragment(const KURL&);
328     bool scrollToAnchor(const String&);
329     void maintainScrollPositionAtAnchor(Node*);
330     void scrollElementToRect(Element*, const IntRect&);
331
332     // Methods to convert points and rects between the coordinate space of the renderer, and this view.
333     virtual IntRect convertFromRenderer(const RenderObject*, const IntRect&) const;
334     virtual IntRect convertToRenderer(const RenderObject*, const IntRect&) const;
335     virtual IntPoint convertFromRenderer(const RenderObject*, const IntPoint&) const;
336     virtual IntPoint convertToRenderer(const RenderObject*, const IntPoint&) const;
337
338     bool isFrameViewScrollCorner(RenderScrollbarPart* scrollCorner) const { return m_scrollCorner == scrollCorner; }
339
340     bool isScrollable();
341
342     enum ScrollbarModesCalculationStrategy { RulesFromWebContentOnly, AnyRule };
343     void calculateScrollbarModesForLayout(ScrollbarMode& hMode, ScrollbarMode& vMode, ScrollbarModesCalculationStrategy = AnyRule);
344
345     // Normal delay
346     static void setRepaintThrottlingDeferredRepaintDelay(double p);
347     // Negative value would mean that first few repaints happen without a delay
348     static void setRepaintThrottlingnInitialDeferredRepaintDelayDuringLoading(double p);
349     // The delay grows on each repaint to this maximum value
350     static void setRepaintThrottlingMaxDeferredRepaintDelayDuringLoading(double p);
351     // On each repaint the delay increses by this amount
352     static void setRepaintThrottlingDeferredRepaintDelayIncrementDuringLoading(double p);
353
354     virtual IntPoint lastKnownMousePosition() const;
355     virtual bool isHandlingWheelEvent() const OVERRIDE;
356     bool shouldSetCursor() const;
357
358     virtual bool scrollbarsCanBeActive() const OVERRIDE;
359
360     // FIXME: Remove this method once plugin loading is decoupled from layout.
361     void flushAnyPendingPostLayoutTasks();
362
363     virtual bool shouldSuspendScrollAnimations() const;
364     virtual void scrollbarStyleChanged(int newStyle, bool forceUpdate);
365
366     void setAnimatorsAreActive();
367
368     RenderBox* embeddedContentBox() const;
369     
370     void setTracksRepaints(bool);
371     bool isTrackingRepaints() const { return m_isTrackingRepaints; }
372     void resetTrackedRepaints();
373     const Vector<IntRect>& trackedRepaintRects() const { return m_trackedRepaintRects; }
374     String trackedRepaintRectsAsText() const;
375
376     typedef HashSet<ScrollableArea*> ScrollableAreaSet;
377     // Returns whether the scrollable area has just been newly added.
378     bool addScrollableArea(ScrollableArea*);
379     // Returns whether the scrollable area has just been removed.
380     bool removeScrollableArea(ScrollableArea*);
381     bool containsScrollableArea(ScrollableArea*) const;
382     const ScrollableAreaSet* scrollableAreas() const { return m_scrollableAreas.get(); }
383
384     virtual void removeChild(Widget*) OVERRIDE;
385
386     // This function exists for ports that need to handle wheel events manually.
387     // On Mac WebKit1 the underlying NSScrollView just does the scrolling, but on most other platforms
388     // we need this function in order to do the scroll ourselves.
389     bool wheelEvent(const PlatformWheelEvent&);
390
391     void setScrollingPerformanceLoggingEnabled(bool);
392
393     // Page and FrameView both store a Pagination value. Page::pagination() is set only by API,
394     // and FrameView::pagination() is set only by CSS. Page::pagination() will affect all
395     // FrameViews in the page cache, but FrameView::pagination() only affects the current
396     // FrameView. FrameView::pagination() will return m_pagination if it has been set. Otherwise,
397     // it will return Page::pagination() since currently there are no callers that need to
398     // distinguish between the two.
399     const Pagination& pagination() const;
400     void setPagination(const Pagination&);
401     
402     bool inProgrammaticScroll() const { return m_inProgrammaticScroll; }
403     void setInProgrammaticScroll(bool programmaticScroll) { m_inProgrammaticScroll = programmaticScroll; }
404
405 #if ENABLE(CSS_FILTERS)
406     void setHasSoftwareFilters(bool hasSoftwareFilters) { m_hasSoftwareFilters = hasSoftwareFilters; }
407     bool hasSoftwareFilters() const { return m_hasSoftwareFilters; }
408 #endif
409 #if ENABLE(CSS_DEVICE_ADAPTATION)
410     IntSize initialViewportSize() const { return m_initialViewportSize; }
411     void setInitialViewportSize(const IntSize& size) { m_initialViewportSize = size; }
412 #endif
413
414     virtual bool isActive() const OVERRIDE;
415
416 #if ENABLE(RUBBER_BANDING)
417     GraphicsLayer* setWantsLayerForTopOverHangArea(bool) const;
418     GraphicsLayer* setWantsLayerForBottomOverHangArea(bool) const;
419 #endif
420
421     virtual int headerHeight() const OVERRIDE { return m_headerHeight; }
422     void setHeaderHeight(int);
423     virtual int footerHeight() const OVERRIDE { return m_footerHeight; }
424     void setFooterHeight(int);
425
426     virtual void willStartLiveResize() OVERRIDE;
427     virtual void willEndLiveResize() OVERRIDE;
428
429 #if USE(ACCELERATED_COMPOSITING)
430     virtual bool scrollbarAnimationsAreSuppressed() const OVERRIDE;
431 #endif
432
433     void addPaintPendingMilestones(LayoutMilestones);
434     void firePaintRelatedMilestones();
435     LayoutMilestones milestonesPendingPaint() const { return m_milestonesPendingPaint; }
436
437     bool visualUpdatesAllowedByClient() const { return m_visualUpdatesAllowedByClient; }
438     void setVisualUpdatesAllowedByClient(bool);
439
440     void resumeAnimatingImages();
441     
442     void setScrollPinningBehavior(ScrollPinningBehavior);
443
444 protected:
445     virtual bool scrollContentsFastPath(const IntSize& scrollDelta, const IntRect& rectToScroll, const IntRect& clipRect);
446     virtual void scrollContentsSlowPath(const IntRect& updateRect);
447     
448     void repaintSlowRepaintObjects();
449
450     virtual bool isVerticalDocument() const;
451     virtual bool isFlippedDocument() const;
452
453 private:
454     explicit FrameView(Frame&);
455
456     void reset();
457     void init();
458
459     virtual bool isFrameView() const OVERRIDE { return true; }
460
461     bool isMainFrameView() const;
462
463     friend class RenderWidget;
464     bool useSlowRepaints(bool considerOverlap = true) const;
465     bool useSlowRepaintsIfNotOverlapped() const;
466     void updateCanBlitOnScrollRecursively();
467     bool contentsInCompositedLayer() const;
468
469     bool shouldUpdateFixedElementsAfterScrolling();
470
471     void applyOverflowToViewport(RenderObject*, ScrollbarMode& hMode, ScrollbarMode& vMode);
472     void applyPaginationToViewport();
473
474     void updateOverflowStatus(bool horizontalOverflow, bool verticalOverflow);
475
476     void paintControlTints();
477
478     void forceLayoutParentViewIfNeeded();
479     void performPostLayoutTasks();
480     void autoSizeIfEnabled();
481
482     virtual void repaintContentRectangle(const IntRect&, bool immediate);
483     virtual void contentsResized() OVERRIDE;
484     virtual void visibleContentsResized();
485     virtual void fixedLayoutSizeChanged() OVERRIDE;
486
487     virtual void delegatesScrollingDidChange();
488
489     // Override ScrollView methods to do point conversion via renderers, in order to
490     // take transforms into account.
491     virtual IntRect convertToContainingView(const IntRect&) const OVERRIDE;
492     virtual IntRect convertFromContainingView(const IntRect&) const OVERRIDE;
493     virtual IntPoint convertToContainingView(const IntPoint&) const OVERRIDE;
494     virtual IntPoint convertFromContainingView(const IntPoint&) const OVERRIDE;
495
496     // ScrollableArea interface
497     virtual void invalidateScrollbarRect(Scrollbar*, const IntRect&) OVERRIDE;
498     virtual void getTickmarks(Vector<IntRect>&) const OVERRIDE;
499     virtual void scrollTo(const IntSize&) OVERRIDE;
500     virtual void setVisibleScrollerThumbRect(const IntRect&) OVERRIDE;
501     virtual ScrollableArea* enclosingScrollableArea() const OVERRIDE;
502     virtual IntRect scrollableAreaBoundingBox() const OVERRIDE;
503     virtual bool scrollAnimatorEnabled() const OVERRIDE;
504 #if USE(ACCELERATED_COMPOSITING)
505     virtual bool usesCompositedScrolling() const OVERRIDE;
506     virtual GraphicsLayer* layerForScrolling() const OVERRIDE;
507     virtual GraphicsLayer* layerForHorizontalScrollbar() const OVERRIDE;
508     virtual GraphicsLayer* layerForVerticalScrollbar() const OVERRIDE;
509     virtual GraphicsLayer* layerForScrollCorner() const OVERRIDE;
510 #if ENABLE(RUBBER_BANDING)
511     virtual GraphicsLayer* layerForOverhangAreas() const OVERRIDE;
512 #endif
513 #endif
514
515     // Override scrollbar notifications to update the AXObject cache.
516     virtual void didAddScrollbar(Scrollbar*, ScrollbarOrientation) OVERRIDE;
517     virtual void willRemoveScrollbar(Scrollbar*, ScrollbarOrientation) OVERRIDE;
518
519     void sendResizeEventIfNeeded();
520
521     void updateScrollableAreaSet();
522
523     virtual void notifyPageThatContentAreaWillPaint() const;
524
525     bool shouldUseLoadTimeDeferredRepaintDelay() const;
526     void deferredRepaintTimerFired(Timer<FrameView>*);
527     void doDeferredRepaints();
528     void updateDeferredRepaintDelayAfterRepaint();
529     double adjustedDeferredRepaintDelay() const;
530
531     bool updateWidgets();
532     void updateWidget(RenderObject*);
533     void scrollToAnchor();
534     void scrollPositionChanged();
535
536     bool hasCustomScrollbars() const;
537
538     virtual void updateScrollCorner();
539
540     FrameView* parentFrameView() const;
541
542     bool doLayoutWithFrameFlattening(bool allowSubtree);
543     bool frameFlatteningEnabled() const;
544     bool isFrameFlatteningValidForThisFrame() const;
545
546     bool qualifiesAsVisuallyNonEmpty() const;
547
548     virtual AXObjectCache* axObjectCache() const;
549     void notifyWidgetsInAllFrames(WidgetNotification);
550     void removeFromAXObjectCache();
551     
552     static double sCurrentPaintTimeStamp; // used for detecting decoded resource thrash in the cache
553
554     LayoutSize m_size;
555     LayoutSize m_margins;
556     
557     typedef HashSet<RenderObject*> RenderObjectSet;
558     OwnPtr<RenderObjectSet> m_widgetUpdateSet;
559     const RefPtr<Frame> m_frame;
560
561     OwnPtr<RenderObjectSet> m_slowRepaintObjects;
562
563     bool m_needsFullRepaint;
564     
565     bool m_canHaveScrollbars;
566     bool m_cannotBlitToWindow;
567     bool m_isOverlapped;
568     bool m_contentIsOpaque;
569
570     int m_borderX;
571     int m_borderY;
572
573     Timer<FrameView> m_layoutTimer;
574     bool m_delayedLayout;
575     RenderObject* m_layoutRoot;
576     
577     bool m_layoutSchedulingEnabled;
578     bool m_inLayout;
579     bool m_doingPreLayoutStyleUpdate;
580     bool m_inSynchronousPostLayout;
581     int m_layoutCount;
582     unsigned m_nestedLayoutCount;
583     Timer<FrameView> m_postLayoutTasksTimer;
584     bool m_firstLayoutCallbackPending;
585
586     bool m_firstLayout;
587     bool m_isTransparent;
588     Color m_baseBackgroundColor;
589     IntSize m_lastViewportSize;
590     float m_lastZoomFactor;
591
592     String m_mediaType;
593     String m_mediaTypeWhenNotPrinting;
594
595     OwnPtr<FrameActionScheduler> m_actionScheduler;
596
597     bool m_overflowStatusDirty;
598     bool m_horizontalOverflow;
599     bool m_verticalOverflow;    
600     RenderObject* m_viewportRenderer;
601
602     Pagination m_pagination;
603
604     bool m_wasScrolledByUser;
605     bool m_inProgrammaticScroll;
606     bool m_safeToPropagateScrollToParent;
607
608     unsigned m_deferringRepaints;
609     unsigned m_repaintCount;
610     Vector<LayoutRect> m_repaintRects;
611     Timer<FrameView> m_deferredRepaintTimer;
612     double m_deferredRepaintDelay;
613     double m_lastPaintTime;
614
615     unsigned m_disableRepaints;
616
617     bool m_isTrackingRepaints; // Used for testing.
618     Vector<IntRect> m_trackedRepaintRects;
619
620     bool m_shouldUpdateWhileOffscreen;
621
622     unsigned m_deferSetNeedsLayouts;
623     bool m_setNeedsLayoutWasDeferred;
624
625     RefPtr<Node> m_nodeToDraw;
626     PaintBehavior m_paintBehavior;
627     bool m_isPainting;
628
629     unsigned m_visuallyNonEmptyCharacterCount;
630     unsigned m_visuallyNonEmptyPixelCount;
631     bool m_isVisuallyNonEmpty;
632     bool m_firstVisuallyNonEmptyLayoutCallbackPending;
633
634     RefPtr<Node> m_maintainScrollPositionAnchor;
635
636     // Renderer to hold our custom scroll corner.
637     RenderScrollbarPart* m_scrollCorner;
638
639     // If true, automatically resize the frame view around its content.
640     bool m_shouldAutoSize;
641     bool m_inAutoSize;
642     // True if autosize has been run since m_shouldAutoSize was set.
643     bool m_didRunAutosize;
644     // The lower bound on the size when autosizing.
645     IntSize m_minAutoSize;
646     // The upper bound on the size when autosizing.
647     IntSize m_maxAutoSize;
648     // The fixed height to resize the view to after autosizing is complete.
649     int m_autoSizeFixedMinimumHeight;
650     // The intrinsic content size decided by autosizing.
651     IntSize m_autoSizeContentSize;
652
653     OwnPtr<ScrollableAreaSet> m_scrollableAreas;
654     OwnPtr<ViewportConstrainedObjectSet> m_viewportConstrainedObjects;
655
656     int m_headerHeight;
657     int m_footerHeight;
658
659     LayoutMilestones m_milestonesPendingPaint;
660
661     static double s_normalDeferredRepaintDelay;
662     static double s_initialDeferredRepaintDelayDuringLoading;
663     static double s_maxDeferredRepaintDelayDuringLoading;
664     static double s_deferredRepaintDelayIncrementDuringLoading;
665
666     static const unsigned visualCharacterThreshold = 200;
667     static const unsigned visualPixelThreshold = 32 * 32;
668
669 #if ENABLE(CSS_FILTERS)
670     bool m_hasSoftwareFilters;
671 #endif
672 #if ENABLE(CSS_DEVICE_ADAPTATION)
673     // Size of viewport before any UA or author styles have overridden
674     // the viewport given by the window or viewing area of the UA.
675     IntSize m_initialViewportSize;
676 #endif
677
678     bool m_visualUpdatesAllowedByClient;
679     
680     ScrollPinningBehavior m_scrollPinningBehavior;
681 };
682
683 inline void FrameView::incrementVisuallyNonEmptyCharacterCount(unsigned count)
684 {
685     if (m_isVisuallyNonEmpty)
686         return;
687     m_visuallyNonEmptyCharacterCount += count;
688     if (m_visuallyNonEmptyCharacterCount <= visualCharacterThreshold)
689         return;
690     updateIsVisuallyNonEmpty();
691 }
692
693 inline void FrameView::incrementVisuallyNonEmptyPixelCount(const IntSize& size)
694 {
695     if (m_isVisuallyNonEmpty)
696         return;
697     m_visuallyNonEmptyPixelCount += size.width() * size.height();
698     if (m_visuallyNonEmptyPixelCount <= visualPixelThreshold)
699         return;
700     updateIsVisuallyNonEmpty();
701 }
702
703 inline FrameView* toFrameView(Widget* widget)
704 {
705     ASSERT(!widget || widget->isFrameView());
706     return static_cast<FrameView*>(widget);
707 }
708
709 inline const FrameView* toFrameView(const Widget* widget)
710 {
711     ASSERT(!widget || widget->isFrameView());
712     return static_cast<const FrameView*>(widget);
713 }
714
715 // This will catch anyone doing an unnecessary cast.
716 void toFrameView(const FrameView*);
717
718 } // namespace WebCore
719
720 #endif // FrameView_h