gecko-dev/embedding/browser/webBrowser/nsIWebBrowserChrome.idl

/* -*- Mode: IDL; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*-
 *
 * The contents of this file are subject to the Mozilla Public
 * License Version 1.1 (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/MPL/
 * 
 * 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 the Mozilla browser.
 * 
 * The Initial Developer of the Original Code is Netscape
 * Communications, Inc.  Portions created by Netscape are
 * Copyright (C) 1999, Mozilla.  All Rights Reserved.
 * 
 * Contributor(s):
 *   Travis Bogard <travis@netscape.com>
 */

#include "nsISupports.idl"

interface nsIWebBrowser;
interface nsIDocShellTreeItem;

/**
 * The nsIWebBrowserChrome
 */

[scriptable, uuid(BA434C60-9D52-11d3-AFB0-00A024FFC08C)]
interface nsIWebBrowserChrome : nsISupports
{
	const unsigned long STATUS_SCRIPT         = 0x00000001;
	const unsigned long STATUS_SCRIPT_DEFAULT = 0x00000002;
	const unsigned long STATUS_LINK           = 0x00000003;

	/*
	    Called when the status text in the chrome needs to be updated.
		The statusType indicates what is setting the text, the text is nsnull
		when there is no longer any status
    */
	void setStatus(in unsigned long statusType, in wstring status);

	/*
		This is the currently loaded webBrowser.  The browser chrome may be
		told to set the webBrowser object to a new object via setting of this
		attribute.  In this case the implementer is responsible for taking the 
		new webBrowser object and doing any necessary initialization or setup 
		as if it had created the webBrowser itself.  This includes positioning
		setting up listeners etc.
	*/
	attribute nsIWebBrowser webBrowser;

	/*
		Definitions for the chrome masks
	*/
	const unsigned long CHROME_DEFAULT = 0x00000001;
	const unsigned long CHROME_WINDOW_BORDERS = 0x00000002;
	const unsigned long CHROME_WINDOW_CLOSE = 0x00000004;
	const unsigned long CHROME_WINDOW_RESIZE = 0x00000008;
	const unsigned long CHROME_MENUBAR = 0x00000010;
	const unsigned long CHROME_TOOLBAR = 0x00000020;
	const unsigned long CHROME_LOCATIONBAR = 0x00000040;
	const unsigned long CHROME_STATUSBAR = 0x00000080;
	const unsigned long CHROME_PERSONAL_TOOLBAR = 0x00000100;
	const unsigned long CHROME_SCROLLBARS = 0x00000200;
	const unsigned long CHROME_TITLEBAR = 0x00000400;
	const unsigned long CHROME_EXTRA = 0x00000800;

	const unsigned long CHROME_WINDOW_RAISED = 0x02000000;
	const unsigned long CHROME_WINDOW_LOWERED = 0x04000000;
	const unsigned long CHROME_CENTER_SCREEN = 0x08000000;
	const unsigned long CHROME_DEPENDENT = 0x10000000;
	// Note: The modal style bit just affects the way the window looks and does
	//       mean it's actually modal.
	const unsigned long CHROME_MODAL = 0x20000000; 
	const unsigned long CHROME_OPENAS_DIALOG = 0x40000000;
	const unsigned long CHROME_OPENAS_CHROME = 0x80000000;

	const unsigned long CHROME_ALL = 0x00000ffe;

	/*
		The chrome flags for this browser chrome
	*/
	attribute unsigned long chromeFlags;

	/*
		Tells the implementer of this interface to create a new webBrowserChrome
		object for it.  Typically this means the implemetor will create a new 
		top level window that is represented by nsIWebBrowserChrome.  This
		most often will be called when for instance there is a need for a new
		JS window, etc.  Soon after this new object is returned, the webBrowser
		attribute will checked, if one does not exist, one will be created and
		setWebBrowser will be called with the new widget to instantiate in this 
		new window.	
	*/

	nsIWebBrowser createBrowserWindow(in unsigned long chromeFlags);


	/*
	Return the child DocShellTreeItem with the specified name.  To implement this
	an embedder should call nsIDocShellTreeItem::findItemWithName on all the open
	webBrowser objects.  If one succeeds this should be returned.  If they all fail
	simply return null.
	@param aName - This is the name of the item that is trying to be found.
	*/
	nsIDocShellTreeItem findNamedBrowserItem(in wstring aName);

	/*
		Tells the chrome to size itself such that the browser will be the 
		specified size.
	*/
	void sizeBrowserTo(in long aCX, in long aCY);

	/*
		Shows the window as a modal window.
	*/
	void showAsModal();

    /**
        Exit a modal event loop if we're in one. The implementation
        should also exit out of the loop if the window is destroyed.
        @param aStatus - the result code to return from showAsModal
    */
    void exitModalEventLoop(in nsresult aStatus);

	/*
	Sets the persistence of different dimensions of the window.
	*/
	void setPersistence(in boolean persistX, in boolean persistY, 
		in boolean persistCX, in boolean persistCY,
		in boolean persistSizeMode);

	/*
	Gets the current persistence states of the window.
	*/
	void getPersistence(out boolean persistX, out boolean persistY, 
		out boolean persistCX, out boolean persistCY,
		out boolean persistSizeMode);

};