Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdebase@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 189 insertions, 0 deletions

diff --git a/konqueror/KonquerorIface.h b/konqueror/KonquerorIface.h
new file mode 100644
index 000000000..ba5fd41dd
--- /dev/null
+++ b/konqueror/KonquerorIface.h
@@ -0,0 +1,189 @@
+/* This file is part of the KDE project
+   Copyright (C) 2000 Simon Hausmann <[email protected]>
+   Copyright (C) 2000 David Faure <[email protected]>
+
+   This program is free software; you can redistribute it and/or
+   modify it under the terms of the GNU General Public
+   License as published by the Free Software Foundation; either
+   version 2 of the License, or (at your option) any later version.
+
+   This program is distributed in the hope that it will be useful,
+   but WITHOUT ANY WARRANTY; without even the implied warranty of
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    General Public License for more details.
+
+   You should have received a copy of the GNU General Public License
+   along with this program; see the file COPYING.  If not, write to
+   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+   Boston, MA 02110-1301, USA.
+*/
+
+#ifndef __KonquerorIface_h__
+#define __KonquerorIface_h__
+
+#include <dcopobject.h>
+#include <qvaluelist.h>
+#include <dcopref.h>
+
+#include <qstringlist.h>
+/**
+ * DCOP interface for konqueror
+ */
+class KonquerorIface : virtual public DCOPObject
+{
+  K_DCOP
+public:
+
+  KonquerorIface();
+  ~KonquerorIface();
+
+k_dcop:
+
+  /**
+   * Opens a new window for the given @p url (using createSimpleWindow, i.e. a single view)
+   */
+  DCOPRef openBrowserWindow( const QString &url );
+  /**
+   * Like @ref openBrowserWindow , with setting the application startup notification ( ASN )
+   * property on the window.
+   */
+  DCOPRef openBrowserWindowASN( const QString &url, const QCString &startup_id );
+
+  /**
+   * Opens a new window for the given @p url (using createNewWindow, i.e. with an appropriate profile)
+   */
+  DCOPRef createNewWindow( const QString &url );
+  /**
+   * Like @ref createNewWindow , with setting the application startup notification ( ASN )
+   * property on the window.
+   */
+  DCOPRef createNewWindowASN( const QString &url, const QCString &startup_id, bool tempFile );
+
+  /**
+   * Opens a new window like @ref createNewWindow, then selects the given @p filesToSelect
+   */
+  DCOPRef createNewWindowWithSelection( const QString &url, QStringList filesToSelect );
+  /**
+   * Like @ref createNewWindowWithSelection, with setting the application startup notification ( ASN )
+   * property on the window.
+   */
+  DCOPRef createNewWindowWithSelectionASN( const QString &url, QStringList filesToSelect, const QCString &startup_id );
+
+  /**
+   * Opens a new window for the given @p url (using createNewWindow, i.e. with an appropriate profile)
+   * @param mimetype to speed it up.
+   */
+  DCOPRef createNewWindow( const QString &url, const QString & mimetype, bool tempFile );
+  /**
+   * Like @ref createNewWindow , with setting the application startup notification ( ASN )
+   * property on the window.
+   */
+  DCOPRef createNewWindowASN( const QString &url, const QString & mimetype,
+      const QCString &startup_id, bool tempFile );
+
+  /**
+   * As the name says, this creates a window from a profile.
+   * Used for instance by khelpcenter.
+   */
+  DCOPRef createBrowserWindowFromProfile( const QString &path );
+  /**
+   * Like @ref createBrowserWindowFromProfile , with setting the application startup
+   * notification ( ASN ) property on the window.
+   */
+  DCOPRef createBrowserWindowFromProfileASN( const QString &path, const QCString &startup_id );
+
+  /**
+   * As the name says, this creates a window from a profile.
+   * Used for instance by kfmclient.
+   * @param path full path to the profile file
+   * @param filename name of the profile file, if under the profiles dir
+   */
+  DCOPRef createBrowserWindowFromProfile( const QString &path, const QString &filename );
+  /**
+   * Like @ref createBrowserWindowFromProfile , with setting the application startup
+   * notification ( ASN ) property on the window.
+   */
+  DCOPRef createBrowserWindowFromProfileASN( const QString &path, const QString &filename,
+      const QCString &startup_id );
+
+  /**
+   * Creates a window from a profile and a URL.
+   * Used by kfmclient to open http URLs with the webbrowsing profile
+   * and others with the filemanagement profile.
+   * @param path full path to the profile file
+   * @param filename name of the profile file, if under the profiles dir
+   * @param url the URL to open
+   */
+  DCOPRef createBrowserWindowFromProfileAndURL( const QString &path, const QString &filename, const QString &url );
+  /**
+   * Like @ref createBrowserWindowFromProfileAndURL , with setting the application startup
+   * notification ( ASN ) property on the window.
+   */
+  DCOPRef createBrowserWindowFromProfileAndURLASN( const QString &path, const QString &filename, const QString &url,
+      const QCString &startup_id );
+
+  /**
+   * Creates a window the fastest way : the caller has to provide
+   * profile, URL, and mimetype.
+   * @param path full path to the profile file
+   * @param filename name of the profile file, if under the profiles dir
+   * @param url the URL to open
+   * @param mimetype the mimetype that the URL we want to open has
+   */
+  DCOPRef createBrowserWindowFromProfileAndURL( const QString &path, const QString &filename, const QString &url, const QString &mimetype );
+  /**
+   * Like @ref createBrowserWindowFromProfileAndURL , with setting the application startup
+   * notification ( ASN ) property on the window.
+   */
+  DCOPRef createBrowserWindowFromProfileAndURLASN( const QString &path, const QString &filename, const QString &url, const QString &mimetype,
+      const QCString& startup_id );
+
+  /**
+   * Called by kcontrol when the global configuration changes
+   */
+  ASYNC reparseConfiguration();
+
+  /**
+   * @return the name of the instance's crash log file
+   */
+  QString crashLogFile();
+
+  /**
+   * @return a list of references to all the windows
+   */
+  QValueList<DCOPRef> getWindows();
+
+  /**
+   *  Called internally as broadcast when the user adds/removes/renames a view profile
+    */
+  ASYNC updateProfileList();
+
+  /**
+   * Called internally as broadcast when a URL is to be added to the combobox.
+   */
+  ASYNC addToCombo( QString, QCString );
+
+  /**
+   * Called internall as broadcast when a URL has to be removed from the combo.
+   */
+  ASYNC removeFromCombo( QString, QCString );
+
+  /**
+   * Called internally as a broadcast when the combobox was cleared.
+   */
+  ASYNC comboCleared( QCString );
+
+  /**
+   * Used by kfmclient when the 'minimize memory usage' setting is set
+   * to find out if this konqueror can be used.
+   */
+  bool processCanBeReused( int screen );
+
+  /**
+   * Called from konqy_preloader to terminate this Konqueror instance,
+   * if it's in the preloaded mode, and there are too many preloaded Konqy's
+   */
+  ASYNC terminatePreloaded();
+};
+
+#endif