File indexing completed on 2024-12-01 09:53:45

 /*
     This file is part of the KDE libraries
     SPDX-FileCopyrightText: 2000 Wilco Greven <greven@kde.org>
 
     SPDX-License-Identifier: LGPL-2.0-or-later
 */
 
 #ifndef KURLREQUESTERDIALOG_H
 #define KURLREQUESTERDIALOG_H
 
 #include "kiowidgets_export.h"
 #include <QDialog>
 #include <QUrl>
 
 #include <memory>
 
 class KUrlRequester;
 class QFileDialog;
 class KUrlRequesterDialogPrivate;
 
 /**
  * @class KUrlRequesterDialog kurlrequesterdialog.h <KUrlRequesterDialog>
  *
  * Dialog in which a user can enter a filename or url. It is a dialog
  * encapsulating KUrlRequester.
  *
  * @short Simple dialog to enter a filename/url.
  * @author Wilco Greven <greven@kde.org>
  */
 class KIOWIDGETS_EXPORT KUrlRequesterDialog : public QDialog
 {
     Q_OBJECT
 
 public:
     /**
      * Constructs a KUrlRequesterDialog.
      *
      * @param url    The url of the directory to start in. Use QString()
      *               to start in the current working directory, or the last
      *               directory where a file has been selected.
      * @param parent The parent object of this widget.
      */
     explicit KUrlRequesterDialog(const QUrl &url, QWidget *parent = nullptr);
 
     /**
      * Constructs a KUrlRequesterDialog.
      *
      * @param url    The url of the directory to start in. Use QString()
      *               to start in the current working directory, or the last
      *               directory where a file has been selected.
      * @param text   Text of the label
      * @param parent The parent object of this widget.
      */
     KUrlRequesterDialog(const QUrl &url, const QString &text, QWidget *parent);
     /**
      * Destructs the dialog.
      */
     ~KUrlRequesterDialog() override;
 
     /**
      * Returns the fully qualified filename.
      */
     QUrl selectedUrl() const;
 
     /**
      * Creates a modal dialog, executes it and returns the selected URL.
      *
      * @param url This specifies the initial path of the input line.
      * @param parent The widget the dialog will be centered on initially.
      * @param title The title to use for the dialog.
      */
     static QUrl getUrl(const QUrl &url = QUrl(), QWidget *parent = nullptr, const QString &title = QString());
 
 #if KIOWIDGETS_ENABLE_DEPRECATED_SINCE(5, 0)
     /**
      * Returns a pointer to the file dialog used by the KUrlRequester.
      * @deprecated since 5.0, use urlRequester() methods instead.
      */
     KIOWIDGETS_DEPRECATED_VERSION(5, 0, "Use KUrlRequesterDialog::urlRequester() and methods on it")
     QFileDialog *fileDialog();
 #endif
 
     /**
      * Returns a pointer to the KUrlRequester.
      */
     KUrlRequester *urlRequester();
 
 private:
     friend class KUrlRequesterDialogPrivate;
     std::unique_ptr<KUrlRequesterDialogPrivate> const d;
 
     Q_DISABLE_COPY(KUrlRequesterDialog)
 };
 
 #endif // KURLREQUESTERDIALOG_H