2004-02-24 00:29:06 +03:00
|
|
|
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
|
|
|
|
* vim:cindent:ts=2:et:sw=2:
|
|
|
|
*
|
2012-05-21 15:12:37 +04:00
|
|
|
* 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/.
|
2004-02-24 00:29:06 +03:00
|
|
|
*
|
|
|
|
* This Original Code has been modified by IBM Corporation. Modifications made
|
|
|
|
* by IBM described herein are Copyright (c) International Business Machines
|
|
|
|
* Corporation, 2000. Modifications to Mozilla code or documentation identified
|
|
|
|
* per MPL Section 3.3
|
|
|
|
*
|
|
|
|
* Date Modified by Description of modification
|
|
|
|
* 04/20/2000 IBM Corp. OS/2 VisualAge build.
|
|
|
|
*/
|
|
|
|
|
2006-03-30 09:56:38 +04:00
|
|
|
/* storage of the frame tree and information about it */
|
|
|
|
|
2004-02-24 00:29:06 +03:00
|
|
|
#ifndef _nsFrameManager_h_
|
|
|
|
#define _nsFrameManager_h_
|
|
|
|
|
|
|
|
#include "nsIFrame.h"
|
|
|
|
#include "nsIStatefulFrame.h"
|
|
|
|
#include "nsChangeHint.h"
|
2004-03-06 07:46:11 +03:00
|
|
|
#include "nsFrameManagerBase.h"
|
2004-02-24 03:36:35 +03:00
|
|
|
|
2010-06-18 20:23:05 +04:00
|
|
|
namespace mozilla {
|
|
|
|
namespace css {
|
|
|
|
class RestyleTracker;
|
|
|
|
} // namespace css
|
|
|
|
} // namespace mozilla
|
|
|
|
|
2011-05-25 04:19:09 +04:00
|
|
|
struct TreeMatchContext;
|
|
|
|
|
2004-02-24 00:29:06 +03:00
|
|
|
/**
|
|
|
|
* Frame manager interface. The frame manager serves two purposes:
|
|
|
|
* <li>provides a service for mapping from content to frame and from
|
|
|
|
* out-of-flow frame to placeholder frame.
|
|
|
|
* <li>handles structural modifications to the frame model. If the frame model
|
|
|
|
* lock can be acquired, then the changes are processed immediately; otherwise,
|
|
|
|
* they're queued and processed later.
|
2004-03-06 07:53:30 +03:00
|
|
|
*
|
|
|
|
* Do not add virtual methods to this class, or bryner will punish you.
|
2004-02-24 00:29:06 +03:00
|
|
|
*/
|
|
|
|
|
2004-03-06 07:46:11 +03:00
|
|
|
class nsFrameManager : public nsFrameManagerBase
|
2004-02-24 00:29:06 +03:00
|
|
|
{
|
2010-06-18 20:23:05 +04:00
|
|
|
typedef mozilla::css::RestyleTracker RestyleTracker;
|
2011-08-25 00:54:30 +04:00
|
|
|
typedef nsIFrame::ChildListID ChildListID;
|
2010-06-18 20:23:05 +04:00
|
|
|
|
2004-02-24 00:29:06 +03:00
|
|
|
public:
|
2013-04-01 02:43:04 +04:00
|
|
|
nsFrameManager(nsIPresShell *aPresShell, nsStyleSet* aStyleSet) NS_HIDDEN {
|
2012-02-02 14:06:46 +04:00
|
|
|
mPresShell = aPresShell;
|
2013-04-01 02:43:04 +04:00
|
|
|
mStyleSet = aStyleSet;
|
|
|
|
MOZ_ASSERT(mPresShell, "need a pres shell");
|
|
|
|
MOZ_ASSERT(mStyleSet, "need a style set");
|
2004-03-06 07:46:11 +03:00
|
|
|
}
|
2012-02-02 14:06:46 +04:00
|
|
|
~nsFrameManager() NS_HIDDEN;
|
2004-03-06 07:46:11 +03:00
|
|
|
|
2004-02-24 00:29:06 +03:00
|
|
|
/*
|
|
|
|
* After Destroy is called, it is an error to call any FrameManager methods.
|
|
|
|
* Destroy should be called when the frame tree managed by the frame
|
|
|
|
* manager is no longer being displayed.
|
|
|
|
*/
|
|
|
|
NS_HIDDEN_(void) Destroy();
|
|
|
|
|
|
|
|
// Placeholder frame functions
|
2012-02-15 13:28:21 +04:00
|
|
|
NS_HIDDEN_(nsPlaceholderFrame*) GetPlaceholderFrameFor(const nsIFrame* aFrame);
|
2004-02-24 00:29:06 +03:00
|
|
|
NS_HIDDEN_(nsresult)
|
|
|
|
RegisterPlaceholderFrame(nsPlaceholderFrame* aPlaceholderFrame);
|
|
|
|
|
|
|
|
NS_HIDDEN_(void)
|
|
|
|
UnregisterPlaceholderFrame(nsPlaceholderFrame* aPlaceholderFrame);
|
|
|
|
|
|
|
|
NS_HIDDEN_(void) ClearPlaceholderFrameMap();
|
|
|
|
|
|
|
|
// Mapping undisplayed content
|
|
|
|
NS_HIDDEN_(nsStyleContext*) GetUndisplayedContent(nsIContent* aContent);
|
|
|
|
NS_HIDDEN_(void) SetUndisplayedContent(nsIContent* aContent,
|
|
|
|
nsStyleContext* aStyleContext);
|
|
|
|
NS_HIDDEN_(void) ChangeUndisplayedContent(nsIContent* aContent,
|
|
|
|
nsStyleContext* aStyleContext);
|
|
|
|
NS_HIDDEN_(void) ClearUndisplayedContentIn(nsIContent* aContent,
|
|
|
|
nsIContent* aParentContent);
|
|
|
|
NS_HIDDEN_(void) ClearAllUndisplayedContentIn(nsIContent* aParentContent);
|
|
|
|
|
|
|
|
// Functions for manipulating the frame model
|
|
|
|
NS_HIDDEN_(nsresult) AppendFrames(nsIFrame* aParentFrame,
|
2011-08-25 00:54:30 +04:00
|
|
|
ChildListID aListID,
|
2011-04-30 03:02:33 +04:00
|
|
|
nsFrameList& aFrameList);
|
2004-02-24 00:29:06 +03:00
|
|
|
|
|
|
|
NS_HIDDEN_(nsresult) InsertFrames(nsIFrame* aParentFrame,
|
2011-08-25 00:54:30 +04:00
|
|
|
ChildListID aListID,
|
2004-02-24 00:29:06 +03:00
|
|
|
nsIFrame* aPrevFrame,
|
2009-07-30 21:23:32 +04:00
|
|
|
nsFrameList& aFrameList);
|
2004-02-24 00:29:06 +03:00
|
|
|
|
2011-08-25 00:54:30 +04:00
|
|
|
NS_HIDDEN_(nsresult) RemoveFrame(ChildListID aListID,
|
2012-08-29 09:39:31 +04:00
|
|
|
nsIFrame* aOldFrame);
|
2004-02-24 00:29:06 +03:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Notification that a frame is about to be destroyed. This allows any
|
|
|
|
* outstanding references to the frame to be cleaned up.
|
|
|
|
*/
|
|
|
|
NS_HIDDEN_(void) NotifyDestroyingFrame(nsIFrame* aFrame);
|
|
|
|
|
|
|
|
/*
|
2006-03-16 04:30:38 +03:00
|
|
|
* Reparent the style contexts of this frame subtree. The parent frame of
|
|
|
|
* aFrame must be changed to the new parent before this function is called;
|
|
|
|
* the new parent style context will be automatically computed based on the
|
|
|
|
* new position in the frame tree.
|
|
|
|
*
|
|
|
|
* @param aFrame the root of the subtree to reparent. Must not be null.
|
2004-02-24 00:29:06 +03:00
|
|
|
*/
|
2010-04-02 10:07:43 +04:00
|
|
|
NS_HIDDEN_(nsresult) ReparentStyleContext(nsIFrame* aFrame);
|
2004-02-24 00:29:06 +03:00
|
|
|
|
|
|
|
/*
|
2008-02-08 22:52:46 +03:00
|
|
|
* Re-resolve the style contexts for a frame tree, building
|
|
|
|
* aChangeList based on the resulting style changes, plus aMinChange
|
|
|
|
* applied to aFrame.
|
2004-02-24 00:29:06 +03:00
|
|
|
*/
|
2008-02-08 22:52:46 +03:00
|
|
|
NS_HIDDEN_(void)
|
2004-02-24 00:29:06 +03:00
|
|
|
ComputeStyleChangeFor(nsIFrame* aFrame,
|
|
|
|
nsStyleChangeList* aChangeList,
|
2010-06-18 20:23:05 +04:00
|
|
|
nsChangeHint aMinChange,
|
2010-06-18 20:23:05 +04:00
|
|
|
RestyleTracker& aRestyleTracker,
|
2011-09-29 10:19:26 +04:00
|
|
|
bool aRestyleDescendants);
|
2004-02-24 00:29:06 +03:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Capture/restore frame state for the frame subtree rooted at aFrame.
|
|
|
|
* aState is the document state storage object onto which each frame
|
2012-05-10 05:27:47 +04:00
|
|
|
* stores its state. Callers of CaptureFrameState are responsible for
|
|
|
|
* traversing next continuations of special siblings of aFrame as
|
|
|
|
* needed; this method will only work with actual frametree descendants
|
|
|
|
* of aFrame.
|
2004-02-24 00:29:06 +03:00
|
|
|
*/
|
|
|
|
|
|
|
|
NS_HIDDEN_(void) CaptureFrameState(nsIFrame* aFrame,
|
|
|
|
nsILayoutHistoryState* aState);
|
|
|
|
|
|
|
|
NS_HIDDEN_(void) RestoreFrameState(nsIFrame* aFrame,
|
|
|
|
nsILayoutHistoryState* aState);
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Add/restore state for one frame
|
|
|
|
*/
|
|
|
|
NS_HIDDEN_(void) CaptureFrameStateFor(nsIFrame* aFrame,
|
2012-11-15 10:40:17 +04:00
|
|
|
nsILayoutHistoryState* aState);
|
2004-02-24 00:29:06 +03:00
|
|
|
|
|
|
|
NS_HIDDEN_(void) RestoreFrameStateFor(nsIFrame* aFrame,
|
2012-11-15 10:40:17 +04:00
|
|
|
nsILayoutHistoryState* aState);
|
2004-02-24 00:29:06 +03:00
|
|
|
|
2012-06-25 23:59:42 +04:00
|
|
|
#ifdef DEBUG
|
2004-02-24 00:29:06 +03:00
|
|
|
/**
|
|
|
|
* DEBUG ONLY method to verify integrity of style tree versus frame tree
|
|
|
|
*/
|
|
|
|
NS_HIDDEN_(void) DebugVerifyStyleTree(nsIFrame* aFrame);
|
|
|
|
#endif
|
|
|
|
|
|
|
|
NS_HIDDEN_(nsIPresShell*) GetPresShell() const { return mPresShell; }
|
2004-08-01 03:15:21 +04:00
|
|
|
NS_HIDDEN_(nsPresContext*) GetPresContext() const {
|
2004-02-24 00:29:06 +03:00
|
|
|
return mPresShell->GetPresContext();
|
|
|
|
}
|
|
|
|
|
2006-08-08 14:40:11 +04:00
|
|
|
private:
|
2010-11-13 20:49:26 +03:00
|
|
|
enum DesiredA11yNotifications {
|
|
|
|
eSkipNotifications,
|
|
|
|
eSendAllNotifications,
|
|
|
|
eNotifyIfShown
|
|
|
|
};
|
|
|
|
|
|
|
|
enum A11yNotificationType {
|
|
|
|
eDontNotify,
|
|
|
|
eNotifyShown,
|
|
|
|
eNotifyHidden
|
|
|
|
};
|
|
|
|
|
2010-06-18 20:23:05 +04:00
|
|
|
// Use eRestyle_Self for the aRestyleHint argument to mean
|
|
|
|
// "reresolve our style context but not kids", use eRestyle_Subtree
|
|
|
|
// to mean "reresolve our style context and kids", and use
|
|
|
|
// nsRestyleHint(0) to mean recompute a new style context for our
|
|
|
|
// current parent and existing rulenode, and the same for kids.
|
2004-02-24 00:29:06 +03:00
|
|
|
NS_HIDDEN_(nsChangeHint)
|
2004-08-01 03:15:21 +04:00
|
|
|
ReResolveStyleContext(nsPresContext *aPresContext,
|
2004-02-24 00:29:06 +03:00
|
|
|
nsIFrame *aFrame,
|
|
|
|
nsIContent *aParentContent,
|
|
|
|
nsStyleChangeList *aChangeList,
|
2009-07-30 11:55:51 +04:00
|
|
|
nsChangeHint aMinChange,
|
2012-09-07 21:13:36 +04:00
|
|
|
nsChangeHint aParentFrameHintsNotHandledForDescendants,
|
2010-06-18 20:23:05 +04:00
|
|
|
nsRestyleHint aRestyleHint,
|
2010-11-13 20:49:26 +03:00
|
|
|
RestyleTracker& aRestyleTracker,
|
|
|
|
DesiredA11yNotifications aDesiredA11yNotifications,
|
2011-05-25 04:19:09 +04:00
|
|
|
nsTArray<nsIContent*>& aVisibleKidsOfHiddenElement,
|
|
|
|
TreeMatchContext &aTreeMatchContext);
|
2004-02-24 00:29:06 +03:00
|
|
|
};
|
|
|
|
|
|
|
|
#endif
|