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, 270 insertions, 0 deletions

diff --git a/kcontrol/konqhtml/jspolicies.h b/kcontrol/konqhtml/jspolicies.h
new file mode 100644
index 000000000..a955abc96
--- /dev/null
+++ b/kcontrol/konqhtml/jspolicies.h
@@ -0,0 +1,270 @@
+/*
+  Copyright (c) 2002 Leo Savernik <[email protected]>
+  Derived from jsopt.h, code copied from there is copyrighted to its
+  respective owners.
+
+  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; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+
+*/
+
+#ifndef __JSPOLICIES_H__
+#define __JSPOLICIES_H__
+
+#include <qgroupbox.h>
+#include <qstring.h>
+
+#include <khtml_settings.h>
+
+#include "policies.h"
+
+class KConfig;
+class QRadioButton;
+class QButtonGroup;
+
+// special value for inheriting a global policy
+#define INHERIT_POLICY		32767
+
+/**
+ * @short Contains all the JavaScript policies and methods for their manipulation.
+ *
+ * This class provides access to the JavaScript policies.
+ *
+ * @author Leo Savernik
+ */
+class JSPolicies : public Policies {
+public:
+#if 0
+  /**
+   * Enumeration for all policies
+   */
+  enum Policies { JavaScriptEnabled = 0, WindowOpen, WindowResize,
+  		WindowMove, WindowFocus, WindowStatus, NumPolicies };
+#endif
+
+  /**
+   * constructor
+   * @param config configuration to initialize this instance from
+   * @param group config group to use if this instance contains the global
+   *	policies (global == true)
+   * @param global true if this instance contains the global policy settings,
+   *	false if this instance contains policies specific for a domain.
+   * @param domain name of the domain this instance is used to configure the
+   *	policies for (case insensitive, ignored if global == true)
+   */
+  JSPolicies(KConfig* config, const QString &group, bool global,
+  		const QString &domain = QString::null);
+		
+  /**
+   * dummy constructor to make QMap happy.
+   *
+   * Never construct an object by using this.
+   * @internal
+   */
+  JSPolicies();
+
+  virtual ~JSPolicies();
+
+  /**
+   * Returns whether the WindowOpen policy is inherited.
+   */
+  bool isWindowOpenPolicyInherited() const {
+    return window_open == INHERIT_POLICY;
+  }
+  /**
+   * Returns the current value of the WindowOpen policy.
+   *
+   * This will return an illegal value if isWindowOpenPolicyInherited is
+   * true.
+   */
+  KHTMLSettings::KJSWindowOpenPolicy windowOpenPolicy() const {
+    return (KHTMLSettings::KJSWindowOpenPolicy)window_open;
+  }
+
+  /**
+   * Returns whether the WindowResize policy is inherited.
+   */
+  bool isWindowResizePolicyInherited() const {
+    return window_resize == INHERIT_POLICY;
+  }
+  /**
+   * Returns the current value of the WindowResize policy.
+   *
+   * This will return an illegal value if isWindowResizePolicyInherited is
+   * true.
+   */
+  KHTMLSettings::KJSWindowResizePolicy windowResizePolicy() const {
+    return (KHTMLSettings::KJSWindowResizePolicy)window_resize;
+  }
+
+  /**
+   * Returns whether the WindowMove policy is inherited.
+   */
+  bool isWindowMovePolicyInherited() const {
+    return window_move == INHERIT_POLICY;
+  }
+  /**
+   * Returns the current value of the WindowMove policy.
+   *
+   * This will return an illegal value if isWindowMovePolicyInherited is
+   * true.
+   */
+  KHTMLSettings::KJSWindowMovePolicy windowMovePolicy() const {
+    return (KHTMLSettings::KJSWindowMovePolicy)window_move;
+  }
+
+  /**
+   * Returns whether the WindowFocus policy is inherited.
+   */
+  bool isWindowFocusPolicyInherited() const {
+    return window_focus == INHERIT_POLICY;
+  }
+  /**
+   * Returns the current value of the WindowFocus policy.
+   *
+   * This will return an illegal value if isWindowFocusPolicyInherited is
+   * true.
+   */
+  KHTMLSettings::KJSWindowFocusPolicy windowFocusPolicy() const {
+    return (KHTMLSettings::KJSWindowFocusPolicy)window_focus;
+  }
+
+  /**
+   * Returns whether the WindowStatus policy is inherited.
+   */
+  bool isWindowStatusPolicyInherited() const {
+    return window_status == INHERIT_POLICY;
+  }
+  /**
+   * Returns the current value of the WindowStatus policy.
+   *
+   * This will return an illegal value if isWindowStatusPolicyInherited is
+   * true.
+   */
+  KHTMLSettings::KJSWindowStatusPolicy windowStatusPolicy() const {
+    return (KHTMLSettings::KJSWindowStatusPolicy)window_status;
+  }
+
+  /**
+   * (re)loads settings from configuration file given in the constructor.
+   */
+  virtual void load();
+  /**
+   * saves current settings to the configuration file given in the constructor
+   */
+  virtual void save();
+  /**
+   * restores the default settings
+   */
+  virtual void defaults();
+
+private:
+  // one of KHTMLSettings::KJSWindowOpenPolicy or INHERIT_POLICY
+  unsigned int window_open;
+  // one of KHTMLSettings::KJSWindowResizePolicy or INHERIT_POLICY
+  unsigned int window_resize;
+  // one of KHTMLSettings::KJSWindowMovePolicy or INHERIT_POLICY
+  unsigned int window_move;
+  // one of KHTMLSettings::KJSWindowFocusPolicy or INHERIT_POLICY
+  unsigned int window_focus;
+  // one of KHTMLSettings::KJSWindowStatusPolicy or INHERIT_POLICY
+  unsigned int window_status;
+
+  friend class JSPoliciesFrame;	// for changing policies
+};
+
+/**
+ * @short Provides a framed widget with controls for the JavaScript policy settings.
+ *
+ * This widget contains controls for changing all JavaScript policies
+ * except the JavaScript enabled policy itself. The rationale behind this is
+ * that the enabled policy be separate from the rest in a prominent
+ * place.
+ *
+ * It is suitable for the global policy settings as well as for the
+ * domain-specific settings.
+ *
+ * The difference between global and domain-specific is the existence of
+ * a special inheritance option in the latter case. That way domain-specific
+ * policies can inherit their value from the global policies.
+ *
+ * @author Leo Savernik
+ */
+class JSPoliciesFrame : public QGroupBox {
+  Q_OBJECT
+public:
+  /**
+   * constructor
+   * @param policies associated object containing the policy values. This
+   *	object will be updated accordingly as the settings are changed.
+   * @param title title for group box
+   * @param parent parent widget
+   */
+  JSPoliciesFrame(JSPolicies *policies, const QString &title,
+		QWidget* parent = 0);
+
+  virtual ~JSPoliciesFrame();
+
+  /**
+   * updates the controls to resemble the status of the underlying
+   * JSPolicies object.
+   */
+  void refresh();
+  /**
+   * (re)loads settings from configuration file given in the constructor.
+   */
+  void load() {
+    policies->load();
+    refresh();
+  }
+  /**
+   * saves current settings to the configuration file given in the constructor
+   */
+  void save() {
+    policies->save();
+  }
+  /**
+   * restores the default settings
+   */
+  void defaults() {
+    policies->defaults();
+    refresh();
+  }
+
+signals:
+  /**
+   * emitted every time an option has been changed
+   */
+  void changed();
+
+private slots:
+  void setWindowOpenPolicy(int id);
+  void setWindowResizePolicy(int id);
+  void setWindowMovePolicy(int id);
+  void setWindowFocusPolicy(int id);
+  void setWindowStatusPolicy(int id);
+
+private:
+
+  JSPolicies *policies;
+  QButtonGroup *js_popup;
+  QButtonGroup *js_resize;
+  QButtonGroup *js_move;
+  QButtonGroup *js_focus;
+  QButtonGroup *js_statusbar;
+};
+
+
+#endif		// __JSPOLICIES_H__
+