From ce4a32fe52ef09d8f5ff1dd22c001110902b60a2 Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: 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/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- khtml/khtml_iface.h | 242 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 242 insertions(+) create mode 100644 khtml/khtml_iface.h (limited to 'khtml/khtml_iface.h') diff --git a/khtml/khtml_iface.h b/khtml/khtml_iface.h new file mode 100644 index 000000000..9719eb21b --- /dev/null +++ b/khtml/khtml_iface.h @@ -0,0 +1,242 @@ +/* This file is part of the KDE project + * Copyright (C) 2002 Stephan Kulow + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Library General Public + * License as published by the Free Software Foundation; either + * version 2 of the License, or (at your option) any later version. + * + * This library 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 + * Library General Public License for more details. + * + * You should have received a copy of the GNU Library General Public License + * along with this library; see the file COPYING.LIB. If not, write to + * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, + * Boston, MA 02110-1301, USA. +*/ + +#ifndef __khtml_Iface_h__ +#define __khtml_Iface_h__ + +#include +#include +#include + +class KHTMLPart; + +/** + * DCOP interface for KHTML + */ +class KHTMLPartIface : public DCOPObject +{ + K_DCOP + +public: + + KHTMLPartIface( KHTMLPart * ); + virtual ~KHTMLPartIface(); + +k_dcop: + /** + * @return the current URL + */ + KURL url() const; + + bool closeURL(); + + /** + * Enable/disable Javascript support. Note that this will + * in either case permanently override the default usersetting. + * If you want to have the default UserSettings, don't call this + * method. + */ + void setJScriptEnabled( bool enable ); + + /** + * Returns @p true if Javascript support is enabled or @p false + * otherwise. + */ + bool jScriptEnabled() const; + + /** + * Enable/disable the automatic forwarding by + */ + void setMetaRefreshEnabled( bool enable ); + + /** + * Returns @p true if automtaic forwarding is enabled. + */ + bool metaRefreshEnabled() const; + + /** + * Enables or disables Drag'n'Drop support. A drag operation is started if + * the users drags a link. + */ + void setDNDEnabled( bool b ); + + /** + * Returns whether Dragn'n'Drop support is enabled or not. + */ + bool dndEnabled() const; + + /** + * Enables/disables Java applet support. Note that calling this function + * will permanently override the User settings about Java applet support. + * Not calling this function is the only way to let the default settings + * apply. + */ + void setJavaEnabled( bool enable ); + + /** + * Return if Java applet support is enabled/disabled. + */ + bool javaEnabled() const; + + + /** + * Enables or disables plugins via, default is enabled + */ + void setPluginsEnabled( bool enable ); + + /** + * Returns trie if plugins are enabled/disabled. + */ + bool pluginsEnabled() const; + + /** + * Specifies whether images contained in the document should be loaded + * automatically or not. + * + * @note Request will be ignored if called before begin(). + */ + void setAutoloadImages( bool enable ); + + /** + * Returns whether images contained in the document are loaded automatically + * or not. + * @note that the returned information is unrelieable as long as no begin() + * was called. + */ + bool autoloadImages() const; + + /** + * Security option. + * + * Specify whether only local references ( stylesheets, images, scripts, subdocuments ) + * should be loaded. ( default false - everything is loaded, if the more specific + * options allow ) + */ + void setOnlyLocalReferences(bool enable); + + /** + * Returns whether references should be loaded ( default false ) + **/ + bool onlyLocalReferences() const; + + /** + * Sets the encoding the page uses. + * + * This can be different from the charset. The widget will try to reload + * the current page in the new encoding, if url() is not empty. + */ + bool setEncoding( const QString &name ); + + /** + * Returns the encoding the page currently uses. + * + * Note that the encoding might be different from the charset. + */ + QString encoding() const; + + /** + * Sets a user defined style sheet to be used on top of the HTML 4 + * default style sheet. + * + * This gives a wide range of possibilities to + * change the layout of the page. + */ + void setUserStyleSheet(const QString &styleSheet); + + /** + * Sets the fixed font style. + * + * @param name The font name to use for fixed text, e.g. + * the <pre> tag. + */ + void setFixedFont( const QString &name ); + + /** + * Finds the anchor named @p name. + * + * If the anchor is found, the widget + * scrolls to the closest position. Returns @p true if the anchor has + * been found. + */ + bool gotoAnchor( const QString &name ); + + /** + * Go to next Anchor. + * + * This is useful to navigate from outside of the navigator. + * @since 3.2 + */ + bool nextAnchor(); + + /** + * Go to previous Anchor. + * @since 3.2 + */ + bool prevAnchor(); + + /** + * Activate the node that currently has the focus + * (emulates pressing Return) + */ + void activateNode(); + + /** + * Returns the text the user has marked. + */ + QString selectedText() const; + + /** + * Marks all text in the document as selected. + */ + void selectAll(); + + /** + * Last-modified date (in raw string format), if received in the [HTTP] headers. + */ + QString lastModified() const; + + /** + * Print the contents of the current html view. + * @param quick if true, fully automated printing, without the print dialog. + */ + ASYNC print( bool quick ); + + void debugRenderTree(); + void debugDOMTree(); + void viewDocumentSource(); + void viewFrameSource(); + void saveBackground(const QString &url); + void saveDocument(const QString &url); + + /** + * Evaluate a given piece of Javascript code + */ + QString evalJS(const QString &script); + + /** + * Stops display of animated images + */ + void stopAnimations(); + +private: + KHTMLPart *part; +}; + +#endif + -- cgit v1.2.1