apps/konqueror/settings/konqhtml/policydlg.h

   1 /*
   2  * Copyright (C) < 2002 to whoever created and edited this file before
   3  * Copyright (C) 2002 Leo Savernik <l.savernik@aon.at>
   4  *     Generalizing the policy dialog
   5  *
   6  */
   7
   8 #ifndef _POLICYDLG_H
   9 #define _POLICYDLG_H
  10
  11 #include <kdialog.h>
  12
  13 #include <QtGui/QLineEdit>
  14 #include <QtCore/QStringList>
  15
  16 class QLabel;
  17 class QComboBox;
  18 class QString;
  19 class QVBoxLayout;
  20 class QPushButton;
  21
  22 class Policies;
  23
  24 /**
  25  * A dialog for editing domain-specific policies.
  26  *
  27  * Each dialog must be associated with a relevant Policies instance which
  28  * will be updated within this dialog appropriately.
  29  *
  30  * Additionally you can insert your own widget containing controls for
  31  * specific policies with addPolicyPanel.
  32  *
  33  * @author unknown
  34  */
  35 class PolicyDialog : public KDialog
  36 {
  37     Q_OBJECT
  38
  39 public:
  40     /**
  41      * Enumerates the possible return values for the "feature enabled"
  42      * policy
  43      */
  44     enum FeatureEnabledPolicy { InheritGlobal = 0, Accept, Reject };
  45
  46     /** constructor
  47      * @param policies policies object this dialog will write the settings
  48      *          into. Note that it always reflects the current settings,
  49      *          even if the dialog has been canceled.
  50      * @param parent parent widget this belongs to
  51      * @param name internal name
  52      */
  53     explicit PolicyDialog(Policies *policies, QWidget *parent = 0, const char *name = 0 );
  54
  55     virtual ~PolicyDialog() {}
  56
  57     /*
  58     * @return whether this feature should be activated, deactivated or
  59     *   inherited from the respective global policy.
  60     */
  61     FeatureEnabledPolicy featureEnabledPolicy() const;
  62
  63     /**
  64      * @return the textual representation of the current "feature enabled"
  65      * policy
  66      */
  67     QString featureEnabledPolicyText() const;
  68
  69     /*
  70     * @return the hostname for which the policy is being set
  71     */
  72     QString domain() const { return le_domain->text(); }
  73
  74     /*
  75     * Sets the line-edit to be enabled/disabled.
  76     *
  77     * This method will set the text in the lineedit if the
  78     * value is not null.
  79     *
  80     * @param state @p true to enable the line-edit, otherwise disabled.
  81     * @param text  the text to be set in the line-edit. Default is NULL.
  82     */
  83     void setDisableEdit( bool /*state*/, const QString& text = QString() );
  84
  85     /**
  86      * Sets the label for the "feature enabled" policy
  87      * @param text label text
  88      */
  89     void setFeatureEnabledLabel(const QString &text);
  90
  91     /**
  92      * Sets the "What's This" text for the "feature enabled" policy
  93      * combo box.
  94      * @param text what's-this text
  95      */
  96     void setFeatureEnabledWhatsThis(const QString &text);
  97
  98     /**
  99      * Syncs the controls with the current content of the
 100      * associated policies object.
 101      */
 102     void refresh();
 103
 104     /**
 105      * Adds another panel which contains controls for more policies.
 106      *
 107      * The widget is inserted between the "feature enabled" combo box and
 108      * the dialog buttons at the bottom.
 109      *
 110      * Currently at most one widget can be added.
 111      * @param panel pointer to widget to insert. The dialog takes ownership
 112      *          of it, but does not reparent it.
 113      */
 114     void addPolicyPanel(QWidget *panel);
 115
 116 protected Q_SLOTS:
 117
 118     virtual void accept();
 119     void slotTextChanged( const QString &text);
 120
 121 private:
 122     Policies *policies;
 123     QVBoxLayout *topl;
 124     int insertIdx;
 125     QLineEdit *le_domain;
 126     QLabel *l_feature_policy;
 127     QComboBox *cb_feature_policy;
 128     QWidget *panel;
 129     QStringList policy_values;
 130     QPushButton *okButton;
 131 };
 132
 133 #endif