File indexing completed on 2024-05-12 16:40:55

 /* This file is part of the KDE project
    Copyright (C) 2004-2012 Jarosław Staniek <staniek@kde.org>
 
    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 KEXINAMEDIALOG_H
 #define KEXINAMEDIALOG_H
 
 #include "kexiextwidgets_export.h"
 #include <core/kexiproject.h>
 #include <core/kexipart.h>
 
 #include <QDialog>
 
 class QDialogButtonBox;
 class KexiNameWidget;
 class KexiNameDialog;
 
 //! Validator that can be used to check validity of data entered into KexiNameDialog
 class KEXIEXTWIDGETS_EXPORT KexiNameDialogValidator
 {
 public:
     KexiNameDialogValidator();
     virtual ~KexiNameDialogValidator();
 
     //! For implementation. Validates data entered into dialog @a dialog.
     //! @return true if the data if valid.
     virtual bool validate(KexiNameDialog *dialog) const = 0;
 };
 
 //! A dialog displaying object's name and caption and allowing editing.
 //! @see KexiNameWidget
 class KEXIEXTWIDGETS_EXPORT KexiNameDialog : public QDialog
 {
     Q_OBJECT
 
 public:
     explicit KexiNameDialog(const QString& message, QWidget * parent = 0);
 
     KexiNameDialog(const QString& message,
                    const QString& nameLabel, const QString& nameText,
                    const QString& captionLabel, const QString& captionText,
                    QWidget * parent = 0);
 
     virtual ~KexiNameDialog();
 
     KexiNameWidget* widget() const;
 
     QDialogButtonBox* buttonBox();
 
     void setDialogIcon(const QString &iconName);
 
     /*! Shows the dialog as a modal dialog, blocking until the user closes it, like QDialog::exec()
         but uses @a project and @a part to check if object of given type and name already exists.
         If so, warning or question is displayed.
         You can check @a overwriteNeeded after calling this method.
         If it's true, user agreed on overwriting, if it's false, user picked
         nonexisting name, so no overwrite will be needed. */
     int execAndCheckIfObjectExists(const KexiProject &project, const KexiPart::Part &part,
                                    bool *overwriteNeeded);
 
     //! If set to true, the dialog will ask for overwriting the existing object if needed.
     //! If set to false, the dialog will inform about existing object and reject renaming.
     //! False by default.
     void setAllowOverwriting(bool set);
 
     //! Sets validator that will be used to check validity of data entered into this KexiNameDialog.
     //! Validation occurs before any other checks.
     //! Passes ownership of @a validator to this name dialog.
     //! Previous validator is removed. 0 an be passed.
     void setValidator(KexiNameDialogValidator *validator);
 
 protected Q_SLOTS:
     void slotTextChanged();
     virtual void accept() override;
     void updateSize();
 
 protected:
     void init();
     virtual void showEvent(QShowEvent * event) override;
     //! Checks if specified name already exists.
     bool canOverwrite();
 
 private:
     class Private;
     Private * const d;
 };
 
 #endif