gecko-dev/webshell/public/nsIWebShell.h

/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
 *
 * The contents of this file are subject to the Netscape Public License
 * Version 1.0 (the "License"); you may not use this file except in
 * compliance with the License.  You may obtain a copy of the License at
 * http://www.mozilla.org/NPL/
 *
 * Software distributed under the License is distributed on an "AS IS"
 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied.  See
 * the License for the specific language governing rights and limitations
 * under the License.
 *
 * The Original Code is Mozilla Communicator client code.
 *
 * The Initial Developer of the Original Code is Netscape Communications
 * Corporation.  Portions created by Netscape are Copyright (C) 1998
 * Netscape Communications Corporation.  All Rights Reserved.
 */
#ifndef nsIWebShell_h___
#define nsIWebShell_h___

#include "nsweb.h"
#include "nsIWidget.h"
#include "nsIScrollableView.h"
#include "nsIContentViewerContainer.h"
#include "nsILoadAttribs.h"

class nsIFactory;
class nsIPostData;
class nsIStreamObserver;
class nsIDocumentLoader;
class nsIWebShell;
class nsIWebShellContainer;
class nsIPref;

// Interface ID for nsIWebShell
#define NS_IWEB_SHELL_IID \
 { 0xa6cf9058, 0x15b3, 0x11d2,{0x93, 0x2e, 0x00, 0x80, 0x5f, 0x8a, 0xdd, 0x32}}

// Interface ID for nsIWebShellContainer
#define NS_IWEB_SHELL_CONTAINER_IID \
 { 0xa6cf905a, 0x15b3, 0x11d2,{0x93, 0x2e, 0x00, 0x80, 0x5f, 0x8a, 0xdd, 0x32}}

// Class ID for an implementation of nsIWebShell
#define NS_WEB_SHELL_CID \
 { 0xa6cf9059, 0x15b3, 0x11d2,{0x93, 0x2e, 0x00, 0x80, 0x5f, 0x8a, 0xdd, 0x32}}

//----------------------------------------------------------------------

typedef enum {
  nsLoadURL,
  nsLoadHistory,
  nsLoadLink,
  nsLoadRefresh
} nsLoadType;

// Container for web shell's
class nsIWebShellContainer : public nsISupports {
public:
  // History control
  NS_IMETHOD WillLoadURL(nsIWebShell* aShell, const PRUnichar* aURL, nsLoadType aReason) = 0;
  NS_IMETHOD BeginLoadURL(nsIWebShell* aShell, const PRUnichar* aURL) = 0;

  // XXX not yet implemented; should we?
  NS_IMETHOD ProgressLoadURL(nsIWebShell* aShell, const PRUnichar* aURL, PRInt32 aProgress, PRInt32 aProgressMax) = 0;
  NS_IMETHOD EndLoadURL(nsIWebShell* aShell, const PRUnichar* aURL, PRInt32 aStatus) = 0;

  //instances
  NS_IMETHOD NewWebShell(nsIWebShell *&aNewWebShell) = 0;
  NS_IMETHOD FindWebShellWithName(const PRUnichar* aName,
                                  nsIWebShell*& aResult) = 0;

  // NS_IMETHOD SetHistoryIndex(PRInt32 aIndex, PRInt32 aMaxIndex) = 0;

  // Link traversing control
};

// Return value from WillLoadURL
#define NS_WEB_SHELL_CANCEL_URL_LOAD      0xC0E70000

//----------------------------------------------------------------------

/**
 * The web shell is a container for implementations of nsIContentViewer.
 * It is a content-viewer-container and also knows how to delegate certain
 * behavior to an nsIWebShellContainer.
 *
 * Web shells can be arranged in a tree.
 *
 * Web shells are also nsIWebShellContainer's because they can contain
 * other web shells.
 */
class nsIWebShell : public nsIContentViewerContainer {
public:
  NS_IMETHOD Init(nsNativeWidget aNativeParent,
                  PRInt32 x, PRInt32 y, PRInt32 w, PRInt32 h,
                  nsScrollPreference aScrolling = nsScrollPreference_kAuto,
                  PRBool aAllowPlugins = PR_TRUE,
                  PRBool aIsSunkenBorder = PR_TRUE) = 0;

  NS_IMETHOD Destroy() = 0;

  NS_IMETHOD GetBounds(PRInt32 &x, PRInt32 &y, PRInt32 &w, PRInt32 &h) = 0;

  NS_IMETHOD SetBounds(PRInt32 x, PRInt32 y, PRInt32 w, PRInt32 h) = 0;

  NS_IMETHOD MoveTo(PRInt32 aX, PRInt32 aY) = 0;

  NS_IMETHOD Show() = 0;

  NS_IMETHOD Hide() = 0;

  NS_IMETHOD SetFocus() = 0;
  NS_IMETHOD RemoveFocus() = 0;

  NS_IMETHOD Repaint(PRBool aForce) = 0;

  // SetContextView moved to bottom to keep branch/tip interfaces
  // compatible
  NS_IMETHOD GetContentViewer(nsIContentViewer*& aResult) = 0;

  NS_IMETHOD SetContainer(nsIWebShellContainer* aContainer) = 0;
  NS_IMETHOD GetContainer(nsIWebShellContainer*& aResult) = 0;

  NS_IMETHOD SetObserver(nsIStreamObserver* anObserver) = 0;
  NS_IMETHOD GetObserver(nsIStreamObserver*& aResult) = 0;

  NS_IMETHOD SetPrefs(nsIPref* aPrefs) = 0;
  NS_IMETHOD GetPrefs(nsIPref*& aPrefs) = 0;

  NS_IMETHOD GetRootWebShell(nsIWebShell*& aResult) = 0;
  NS_IMETHOD SetParent(nsIWebShell* aParent) = 0;
  NS_IMETHOD GetParent(nsIWebShell*& aParent) = 0;
  NS_IMETHOD GetChildCount(PRInt32& aResult) = 0;
  NS_IMETHOD AddChild(nsIWebShell* aChild) = 0;
  NS_IMETHOD ChildAt(PRInt32 aIndex, nsIWebShell*& aResult) = 0;
  NS_IMETHOD GetName(PRUnichar** aName) = 0;
  NS_IMETHOD SetName(const PRUnichar* aName) = 0;
  NS_IMETHOD FindChildWithName(const PRUnichar* aName,
                               nsIWebShell*& aResult) = 0;

  // Document load api's
  NS_IMETHOD GetDocumentLoader(nsIDocumentLoader*& aResult) = 0;
  NS_IMETHOD LoadURL(const PRUnichar *aURLSpec,
                     nsIPostData* aPostData=nsnull,
                     PRBool aModifyHistory=PR_TRUE,
                     nsURLReloadType aType=nsURLReload,
                     const PRUint32 aLocalIP=0) = 0;
  NS_IMETHOD Stop(void) = 0;
  NS_IMETHOD Reload(nsURLReloadType aType) = 0;
  
  // History api's
  NS_IMETHOD Back() = 0;
  NS_IMETHOD CanBack() = 0;
  NS_IMETHOD Forward() = 0;
  NS_IMETHOD CanForward() = 0;
  NS_IMETHOD GoTo(PRInt32 aHistoryIndex) = 0;
  NS_IMETHOD GetHistoryIndex(PRInt32& aResult) = 0;
  NS_IMETHOD GetURL(PRInt32 aHistoryIndex, PRUnichar **aURLResult) = 0;

  // Chrome api's
  NS_IMETHOD SetTitle(const PRUnichar *aTitle) = 0;

  NS_IMETHOD GetTitle(PRUnichar **aResult) = 0;
  // SetToolBar
  // SetMenuBar
  // SetStatusBar

  NS_IMETHOD SetContentViewer(nsIContentViewer* aViewer) = 0;
  // XXX these are here until there a better way to pass along info to a sub doc
  NS_IMETHOD GetMarginWidth (PRInt32& aWidth)  = 0;
  NS_IMETHOD SetMarginWidth (PRInt32  aWidth)  = 0;
  NS_IMETHOD GetMarginHeight(PRInt32& aWidth)  = 0;
  NS_IMETHOD SetMarginHeight(PRInt32  aHeight) = 0;

  // Selection Related Methods
  /**
    * Returns the whether there is a selection or not
   */
  NS_IMETHOD IsSelection(PRBool & aIsSelection) = 0;

  /**
    * Returns the whether the selection can be cut (editor or a form control)
   */
  NS_IMETHOD IsSelectionCutable(PRBool & aIsSelection) = 0;

  /**
    * Returns whether the data can be pasted (editor or a form control)
   */
  NS_IMETHOD IsSelectionPastable(PRBool & aIsSelection) = 0;

  /**
    * Copies the Selection from the content or a form control
   */
  NS_IMETHOD GetSelection(PRUnichar *& aSelection) = 0;

  /**
    * Cuts the Selection from the content or a form control
   */
  NS_IMETHOD CutSelection(PRUnichar *& aSelection) = 0;

  /**
    * Pastes the Selection into the content or a form control
   */
  NS_IMETHOD PasteSelection(const PRUnichar * aSelection) = 0;

  /**
    * Selects all the Content
   */
  NS_IMETHOD SelectAll() = 0;

  /**
    * Finds text in content
   */
  NS_IMETHOD FindNext(const PRUnichar * aSearchStr, PRBool aMatchCase, PRBool aSearchDown, PRBool &aIsFound) = 0;

};

extern "C" NS_WEB nsresult
NS_NewWebShellFactory(nsIFactory** aFactory);

#endif /* nsIWebShell_h___ */