Added attribute for setting and getting the nsIDocShellTreeOwner.

docshell/base/nsDocShell.cpp

@@ -366,6 +366,23 @@ NS_IMETHODIMP nsDocShell::SetParent(nsIDocShell* aParent)
   return NS_OK;
 }
 
+NS_IMETHODIMP nsDocShell::GetTreeOwner(nsIDocShellTreeOwner** aTreeOwner)
+{
+   NS_ENSURE_ARG_POINTER(aTreeOwner);
+
+   //XXXIMPL Implement this!
+   NS_WARN_IF_FALSE(PR_FALSE, "Not Implemented");
+   return NS_OK;
+}
+
+NS_IMETHODIMP nsDocShell::SetTreeOwner(nsIDocShellTreeOwner* aTreeOwner)
+{
+   //XXXIMPL Implement this!
+   NS_WARN_IF_FALSE(PR_FALSE, "Not Implemented");
+
+   return NS_OK;
+}
+
 NS_IMETHODIMP nsDocShell::GetParentURIContentListener(nsIURIContentListener**
    aParent)
 {

docshell/base/nsIDocShell.idl

@@ -42,6 +42,8 @@
 [ptr] native nsIDocumentLoaderObserver(nsIDocumentLoaderObserver);
 [ptr] native nsIContentViewer(nsIContentViewer);
 
+interface nsIDocShellTreeOwner;
+
 [scriptable, uuid(69E5DE00-7B8B-11d3-AF61-00A024FFC08C)]
 interface nsIDocShell : nsISupports
 {
@@ -128,6 +130,21 @@ interface nsIDocShell : nsISupports
 	*/
 	attribute nsIDocShell parent;
 
+	/*
+	The owner of the DocShell Tree.  This interface will be called upon when
+	the docshell has things it needs to tell to the owner of the docshell.
+	
+	Note implementers of this interface should NOT effect the lifetime of the 
+	parent DocShell by holding this reference as it creates a cycle.  Owners
+	when releasing this interface should set the treeOwner to nsnull.
+	Implementers of this interface are guaranteed that when treeOwner is
+	set that the poitner is valid without having to addref.
+	
+	Further note however when others try to get the interface it should be 
+	addref'd before handing it to them. 
+	*/
+	attribute nsIDocShellTreeOwner treeOwner;
+
 	/*
 	URI content listener parent
 	*/
@@ -155,7 +172,6 @@ interface nsIDocShell : nsISupports
 	*/
 	attribute float zoom;
 
-
 	/*
 	XXX Comment here!
 	*/

docshell/base/nsWebShell.cpp

@@ -4306,6 +4306,22 @@ NS_IMETHODIMP nsWebShell::SetParent(nsIDocShell* aParent)
    return NS_OK;
 }
 
+NS_IMETHODIMP nsWebShell::GetTreeOwner(nsIDocShellTreeOwner** aTreeOwner)
+{
+   NS_ENSURE_ARG_POINTER(aTreeOwner);
+
+   //XXXIMPL
+   NS_WARN_IF_FALSE(PR_FALSE, "Not Implemented!");
+   return NS_OK;
+}
+
+NS_IMETHODIMP nsWebShell::SetTreeOwner(nsIDocShellTreeOwner* aTreeOwner)
+{
+   //XXXIMPL
+   NS_WARN_IF_FALSE(PR_FALSE, "Not Implemented!");
+   return NS_OK;
+}
+
 NS_IMETHODIMP nsWebShell::GetParentURIContentListener(nsIURIContentListener**
    aParent)
 {

webshell/src/nsWebShell.cpp

@@ -4306,6 +4306,22 @@ NS_IMETHODIMP nsWebShell::SetParent(nsIDocShell* aParent)
    return NS_OK;
 }
 
+NS_IMETHODIMP nsWebShell::GetTreeOwner(nsIDocShellTreeOwner** aTreeOwner)
+{
+   NS_ENSURE_ARG_POINTER(aTreeOwner);
+
+   //XXXIMPL
+   NS_WARN_IF_FALSE(PR_FALSE, "Not Implemented!");
+   return NS_OK;
+}
+
+NS_IMETHODIMP nsWebShell::SetTreeOwner(nsIDocShellTreeOwner* aTreeOwner)
+{
+   //XXXIMPL
+   NS_WARN_IF_FALSE(PR_FALSE, "Not Implemented!");
+   return NS_OK;
+}
+
 NS_IMETHODIMP nsWebShell::GetParentURIContentListener(nsIURIContentListener**
    aParent)
 {