File indexing completed on 2024-05-19 04:29:22

 /* This file is part of the KDE project
  * SPDX-FileCopyrightText: 2018 Scott Petrovic <scottpetrovic@gmail.com>
  *
  * SPDX-License-Identifier: LGPL-2.0-or-later
  */
 
 #ifndef KISWELCOMEPAGEWIDGET_H
 #define KISWELCOMEPAGEWIDGET_H
 
 #include "kritaui_export.h"
 #include "KisViewManager.h"
 #include <KisUpdaterBase.h>
 #include <KisKineticScroller.h>
 
 #include <QAction>
 #include <QWidget>
 #include "ui_KisWelcomePage.h"
 #include <QStandardItemModel>
 #include <QScopedPointer>
 #include <QFont>
 
 #include "config-updaters.h"
 class RecentItemDelegate;
 class KisMainWindow;
 
 // Custom QAction to bridge a QLabel::linkActivated signal to a QAction::setChecked signal
 class ShowNewsAction : public QAction
 {
   Q_OBJECT
 public:
     using QAction::QAction;
 private Q_SLOTS:
     void enableFromLink(QString unused_url);
 };
 
 /// A widget for displaying if no documents are open. This will display in the MDI area
 class KRITAUI_EXPORT KisWelcomePageWidget : public QWidget, public Ui::KisWelcomePage
 {
     Q_OBJECT
 
     public:
     explicit KisWelcomePageWidget(QWidget *parent);
     ~KisWelcomePageWidget() override;
 
     void setMainWindow(KisMainWindow* m_mainWindow);
 
 public Q_SLOTS:
     /// if a document is placed over this area, a dotted line will appear as an indicator
     /// that it is a droppable area. KisMainwindow is what triggers this
     void showDropAreaIndicator(bool show);
 
     void slotUpdateThemeColors();
 
 #ifdef ENABLE_UPDATERS
     void slotSetUpdateStatus(KisUpdaterStatus updateStatus);
     void slotShowUpdaterErrorDetails();
 #endif
 
 #ifdef Q_OS_ANDROID
     void slotStartDonationFlow();
 #endif
 
 private Q_SLOTS:
     void slotNewFileClicked();
     void slotOpenFileClicked();
     void slotBannerClicked();
 
     void recentDocumentClicked(QModelIndex index);
     void slotRecentDocContextMenuRequest(const QPoint &pos);
 
     /**
      * Once all files in the recent documents model are checked, cleanup the UI if the model is empty
      */
     void slotRecentFilesModelIsUpToDate();
 
     void slotScrollerStateChanged(QScroller::State state){ KisKineticScroller::updateCursor(this, state); }
 
 #ifdef ENABLE_UPDATERS
     void slotRunVersionUpdate();
     void slotToggleUpdateChecks(bool state);
 #endif
 
     bool isDevelopmentBuild();
 
     QFont largerFont();
 
 protected:
 
     // QWidget overrides
     void dragEnterEvent(QDragEnterEvent * event) override;
     void dropEvent(QDropEvent * event) override;
     void dragMoveEvent(QDragMoveEvent * event) override;
     void dragLeaveEvent(QDragLeaveEvent * event) override;
     void changeEvent(QEvent *event) override;
 
     bool eventFilter(QObject *watched, QEvent *event) override;
 
 
 private:
     void setupBanner();
     void setupNewsLangSelection(QMenu *newsOptionMenu);
     void showDevVersionHighlight();
 
 #ifdef ENABLE_UPDATERS
     void updateVersionUpdaterFrame();
 #endif
 
     KisMainWindow *m_mainWindow {nullptr};
 
     /// help us see how many people are clicking startup screen links
     /// you can see the results in Matomo (stats.kde.org)
     /// this will be listed in the "Acquisition" section of Matomo
     /// just append some text to this to associate it with an event/page
     const QString analyticsString = "pk_campaign=startup-sceen&pk_kwd=";
 
 
     // keeping track of link colors with theme change
     QColor textColor;
     QColor backgroundColor;
     QColor blendedColor;
     QString blendedStyle;
 
 #ifdef ENABLE_UPDATERS
     QScopedPointer<KisUpdaterBase> m_versionUpdater;
     KisUpdaterStatus m_updaterStatus;
 #endif
     bool m_networkIsAllowed {false};
 
 #ifdef Q_OS_ANDROID
 public:
     static QPushButton* donationLink;
     static QLabel* donationBannerImage;
 #endif
     QScopedPointer<RecentItemDelegate> recentItemDelegate;
 
     QString m_bannerUrl;
     QImage m_bannerImage;
     bool m_bannerOverride {false};
     bool m_showBanner {true};
 
 };
 
 #endif // KISWELCOMEPAGEWIDGET_H