File indexing completed on 2024-04-28 15:29:21

 /*
     This file is part of the KDE project
     SPDX-FileCopyrightText: 1999 Simon Hausmann <hausmann@kde.org>
     SPDX-FileCopyrightText: 1999 David Faure <faure@kde.org>
 
     SPDX-License-Identifier: LGPL-2.0-or-later
 */
 
 #ifndef __MAINWINDOW_H
 #define __MAINWINDOW_H
 
 #include <kparts/part.h>
 
 #include <KXmlGuiWindow>
 #include <memory>
 
 class QString;
 
 namespace KParts
 {
 class MainWindowPrivate;
 
 /**
  * @class MainWindow mainwindow.h <KParts/MainWindow>
  *
  * @short A KPart-aware main window, whose user interface is described in XML.
  *
  * It implements all internal interfaces in the case of a
  * KMainWindow as host: the builder and servant interface (for menu
  * merging).
  *
  * Inherit your main window from this class
  * and make sure to call @c setXMLFile() and @c setupGUI() before you
  * call @c createGUI() on the KPart.
  *
  * For example:
  * \code
  * setCentralWidget(m_part->widget());
  * setXMLFile(QStringLiteral("appui.rc"));
  * setupGUI(ToolBar | Keys | StatusBar | Save); // Never Create flag here
  * createGUI(m_part);
  * \endcode
  *
  * @warning You should not pass the @c Default flag set to @c setupGUI(),
  * since it contains the @c Create flag, which is not supposed to be used
  * from this class.
  * @see KXmlGuiWindow::Create, @see setupGUI, @see createGUI
  *
  */
 class KPARTS_EXPORT MainWindow : public KXmlGuiWindow, virtual public PartBase
 {
     Q_OBJECT
 public:
     /**
      * Constructor, same signature as KMainWindow.
      */
     explicit MainWindow(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags());
     /**
      * Destructor.
      */
     ~MainWindow() override;
 
 public Q_SLOTS:
     void configureToolbars() override;
 
 protected Q_SLOTS:
 
     /**
      * Create the GUI (by merging the host's and the active part's)
      * You _must_ call this in order to see any GUI being created.
      *
      * In a main window with multiple parts being shown (e.g. as in Konqueror)
      * you need to connect this slot to the
      * KPartManager::activePartChanged() signal
      *
      * @param part The active part (set to 0L if no part).
      */
     void createGUI(KParts::Part *part);
 
     /**
      * Enable or disable the automatic setting of window titles by the part's document title.
      * By default, a part always changes the window title when the document changes.
      * @note This value must be set before calling createGUI().
      *
      * @param enabled boolean to enable or disable the window title handling
      * @since 5.24
      */
     void setWindowTitleHandling(bool enabled);
 
     /**
      * Called when the active part wants to change the statusbar message
      * Reimplement if your mainwindow has a complex statusbar
      * (with several items)
      */
     virtual void slotSetStatusBarText(const QString &);
 
     /**
      * Rebuilds the GUI after KEditToolBar changed the toolbar layout.
      * @see configureToolbars()
      */
     void saveNewToolbarConfig() override;
 
 protected:
     virtual void createShellGUI(bool create = true);
 
 private:
     std::unique_ptr<MainWindowPrivate> const d;
 };
 
 }
 
 #endif