KisWelcomePageWidget Class Reference

A widget for displaying if no documents are open. This will display in the MDI area. More...

#include <KisWelcomePageWidget.h>

Inheritance diagram for KisWelcomePageWidget:

Public Slots
void	showDropAreaIndicator (bool show)
void	slotUpdateThemeColors ()

Public Member Functions
	KisWelcomePageWidget (QWidget *parent)
void	setMainWindow (KisMainWindow *m_mainWindow)
	~KisWelcomePageWidget () override

Protected Member Functions
void	changeEvent (QEvent *event) override
void	dragEnterEvent (QDragEnterEvent *event) override
void	dragLeaveEvent (QDragLeaveEvent *event) override
void	dragMoveEvent (QDragMoveEvent *event) override
void	dropEvent (QDropEvent *event) override
bool	eventFilter (QObject *watched, QEvent *event) override

Private Slots
bool	isDevelopmentBuild ()
QFont	largerFont ()
void	recentDocumentClicked (QModelIndex index)
void	slotNewFileClicked ()
void	slotOpenFileClicked ()
void	slotPaste ()
void	slotRecentDocContextMenuRequest (const QPoint &pos)
void	slotRecentFilesModelIsUpToDate ()
void	slotScrollerStateChanged (QScroller::State state)

Private Member Functions
void	setupNewsLangSelection (QMenu *newsOptionMenu)
void	showDevVersionHighlight ()

Private Attributes
const QString	analyticsString = "pk_campaign=startup-sceen&pk_kwd="
QColor	backgroundColor
QColor	blendedColor
QString	blendedStyle
KisMainWindow *	m_mainWindow {nullptr}
bool	m_networkIsAllowed {false}
QScopedPointer< RecentItemDelegate >	recentItemDelegate
QColor	textColor

Detailed Description

A widget for displaying if no documents are open. This will display in the MDI area.

Definition at line 37 of file KisWelcomePageWidget.h.

Constructor & Destructor Documentation

KisWelcomePageWidget()

KisWelcomePageWidget::KisWelcomePageWidget ( QWidget * parent )

explicit

Definition at line 118 of file KisWelcomePageWidget.cpp.

    : QWidget(parent)
{
    setupUi(this);
 
    // URLs that go to web browser...
    devBuildIcon->setIcon(KisIconUtils::loadIcon("warning"));
    devBuildLabel->setVisible(false);
    updaterFrame->setVisible(false);
    versionNotificationLabel->setVisible(false);
    bnVersionUpdate->setVisible(false);
    bnErrorDetails->setVisible(false);
 
    // Recent docs...
    recentDocumentsListView->setDragEnabled(false);
    recentDocumentsListView->viewport()->setAutoFillBackground(false);
    recentDocumentsListView->setSpacing(2);
    recentDocumentsListView->installEventFilter(this);
    recentDocumentsListView->setViewMode(QListView::IconMode);
    recentDocumentsListView->setSelectionMode(QAbstractItemView::NoSelection);
 
//    m_recentItemDelegate.reset(new RecentItemDelegate(this));
//    m_recentItemDelegate->setItemHeight(KisRecentDocumentsModelWrapper::ICON_SIZE_LENGTH);
//    recentDocumentsListView->setItemDelegate(m_recentItemDelegate.data());
    recentDocumentsListView->setIconSize(QSize(KisRecentDocumentsModelWrapper::ICON_SIZE_LENGTH, KisRecentDocumentsModelWrapper::ICON_SIZE_LENGTH));
    recentDocumentsListView->setVerticalScrollMode(QListView::ScrollPerPixel);
    recentDocumentsListView->verticalScrollBar()->setSingleStep(50);
    {
        QScroller* scroller = KisKineticScroller::createPreconfiguredScroller(recentDocumentsListView);
        if (scroller) {
            connect(scroller, SIGNAL(stateChanged(QScroller::State)), this, SLOT(slotScrollerStateChanged(QScroller::State)));
        }
    }
    recentDocumentsListView->setContextMenuPolicy(Qt::CustomContextMenu);
    connect(recentDocumentsListView, SIGNAL(customContextMenuRequested(QPoint)), SLOT(slotRecentDocContextMenuRequest(QPoint)));
 
    // News widget...
    QMenu *newsOptionsMenu = new QMenu(this);
    newsOptionsMenu->setToolTipsVisible(true);
    ShowNewsAction *showNewsAction = new ShowNewsAction(i18n("Enable news and check for new releases"), newsOptionsMenu);
    newsOptionsMenu->addAction(showNewsAction);
    showNewsAction->setToolTip(i18n("Show news about Krita: this needs internet to retrieve information from the krita.org website"));
    showNewsAction->setCheckable(true);
 
    newsOptionsMenu->addSection(i18n("Language"));
    QAction *newsInfoAction = newsOptionsMenu->addAction(i18n("English news is always up to date."));
    newsInfoAction->setEnabled(false);
 
    setupNewsLangSelection(newsOptionsMenu);
    btnNewsOptions->setMenu(newsOptionsMenu);
 
    labelSupportText->setFont(largerFont());
    donationLink->setFont(largerFont());
 
    connect(showNewsAction, SIGNAL(toggled(bool)), newsWidget, SLOT(setVisible(bool)));
    connect(showNewsAction, SIGNAL(toggled(bool)), labelNoFeed, SLOT(setHidden(bool)));
    connect(showNewsAction, SIGNAL(toggled(bool)), newsWidget, SLOT(toggleNews(bool)));
    connect(labelNoFeed, SIGNAL(linkActivated(QString)), showNewsAction, SLOT(enableFromLink(QString)));
 
    labelNoFeed->setDismissable(false);
 
#ifdef ENABLE_UPDATERS
    connect(showNewsAction, SIGNAL(toggled(bool)), this, SLOT(slotToggleUpdateChecks(bool)));
#endif
 
    donationLink->hide();
    supporterBadge->hide();
#ifdef Q_OS_ANDROID
    initDonations();
#endif
 
    // configure the News area
    KisConfig cfg(true);
    m_networkIsAllowed = cfg.readEntry<bool>("FetchNews", false);
 
 
#ifdef ENABLE_UPDATERS
#ifndef Q_OS_ANDROID
    // Setup version updater, but do not check for them, unless the user explicitly
    // wants to check for updates.
    // * No updater is created for Linux/Steam, Windows/Steam and Windows/Store distributions,
    // as those stores have their own updating mechanism.
    // * STEAMAPPID(Windows)/SteamAppId(Linux) environment variable is set when Krita is run from Steam.
    // The environment variables are not public API.
    // * MS Store version runs as a package (though we cannot know if it was
    // installed from the Store or manually with the .msix package)
#if defined Q_OS_LINUX
    if (!qEnvironmentVariableIsSet("SteamAppId")) { // do not create updater for linux/steam
        if (qEnvironmentVariableIsSet("APPIMAGE")) {
            m_versionUpdater.reset(new KisAppimageUpdater());
        } else {
            m_versionUpdater.reset(new KisManualUpdater());
        }
    }
#elif defined Q_OS_WIN
    if (!KisWindowsPackageUtils::isRunningInPackage() && !qEnvironmentVariableIsSet("STEAMAPPID")) {
        m_versionUpdater.reset(new KisManualUpdater());
        KisUsageLogger::log("Non-store package - creating updater");
    } else {
        KisUsageLogger::log("detected appx or steam package - not creating the updater");
    }
#else
    // always create updater for MacOS
    m_versionUpdater.reset(new KisManualUpdater());
#endif // Q_OS_*
    if (!m_versionUpdater.isNull()) {
        connect(bnVersionUpdate, SIGNAL(clicked()), this, SLOT(slotRunVersionUpdate()));
        connect(bnErrorDetails, SIGNAL(clicked()), this, SLOT(slotShowUpdaterErrorDetails()));
        connect(m_versionUpdater.data(), SIGNAL(sigUpdateCheckStateChange(KisUpdaterStatus)),
                this, SLOT(slotSetUpdateStatus(const KisUpdaterStatus&)));
 
        if (m_networkIsAllowed) { // only if the user wants them
            m_versionUpdater->checkForUpdate();
        }
    }
#endif // ifndef Q_OS_ANDROID
#endif // ENABLE_UPDATERS
 
 
    showNewsAction->setChecked(m_networkIsAllowed);
    newsWidget->setVisible(m_networkIsAllowed);
    versionNotificationLabel->setEnabled(m_networkIsAllowed);
 
    // Drop area..
    setAcceptDrops(true);
}

References KisKineticScroller::createPreconfiguredScroller(), KisRecentDocumentsModelWrapper::ICON_SIZE_LENGTH, KisWindowsPackageUtils::isRunningInPackage(), largerFont(), KisIconUtils::loadIcon(), KisUsageLogger::log(), m_networkIsAllowed, KisConfig::readEntry(), setupNewsLangSelection(), slotRecentDocContextMenuRequest(), and slotScrollerStateChanged().

~KisWelcomePageWidget()

KisWelcomePageWidget::~KisWelcomePageWidget ( )

override

Definition at line 245 of file KisWelcomePageWidget.cpp.

{
}

Member Function Documentation

changeEvent()

void KisWelcomePageWidget::changeEvent ( QEvent * event )

overrideprotected

Definition at line 478 of file KisWelcomePageWidget.cpp.

{
    if (event->type() == QEvent::FontChange) {
        labelSupportText->setFont(largerFont());
        donationLink->setFont(largerFont());
    }
}

References largerFont().

dragEnterEvent()

void KisWelcomePageWidget::dragEnterEvent ( QDragEnterEvent * event )

overrideprotected

Definition at line 416 of file KisWelcomePageWidget.cpp.

{
    showDropAreaIndicator(true);
    if (event->mimeData()->hasUrls() ||
        event->mimeData()->hasFormat("application/x-krita-node-internal-pointer") ||
        event->mimeData()->hasFormat("application/x-qt-image")) {
        return event->accept();
    }
 
    return event->ignore();
}

References showDropAreaIndicator().

dragLeaveEvent()

void KisWelcomePageWidget::dragLeaveEvent ( QDragLeaveEvent * event )

overrideprotected

Definition at line 472 of file KisWelcomePageWidget.cpp.

{
    showDropAreaIndicator(false);
    m_mainWindow->dragLeave();
}

References KisMainWindow::dragLeave(), m_mainWindow, and showDropAreaIndicator().

dragMoveEvent()

void KisWelcomePageWidget::dragMoveEvent ( QDragMoveEvent * event )

overrideprotected

Definition at line 459 of file KisWelcomePageWidget.cpp.

{
    m_mainWindow->dragMoveEvent(event);
 
    if (event->mimeData()->hasUrls() ||
        event->mimeData()->hasFormat("application/x-krita-node-internal-pointer") ||
        event->mimeData()->hasFormat("application/x-qt-image")) {
        return event->accept();
    }
 
    return event->ignore();
}

References KisMainWindow::dragMoveEvent(), and m_mainWindow.

dropEvent()

void KisWelcomePageWidget::dropEvent ( QDropEvent * event )

overrideprotected

Definition at line 428 of file KisWelcomePageWidget.cpp.

{
    showDropAreaIndicator(false);
 
    if (event->mimeData()->hasUrls() && !event->mimeData()->urls().empty()) {
        Q_FOREACH (const QUrl &url, event->mimeData()->urls()) {
            if (url.toLocalFile().endsWith(".bundle", Qt::CaseInsensitive)) {
                bool r = m_mainWindow->installBundle(url.toLocalFile());
                if (!r) {
                    qWarning() << "Could not install bundle" << url.toLocalFile();
                }
            } else if (!url.isLocalFile()) {
                QScopedPointer<QTemporaryFile> tmp(new QTemporaryFile());
                tmp->setFileName(url.fileName());
 
                KisRemoteFileFetcher fetcher;
 
                if (!fetcher.fetchFile(url, tmp.data())) {
                    qWarning() << "Fetching" << url << "failed";
                    continue;
                }
                const auto localUrl = QUrl::fromLocalFile(tmp->fileName());
 
                m_mainWindow->openDocument(localUrl.toLocalFile(), KisMainWindow::None);
            } else {
                m_mainWindow->openDocument(url.toLocalFile(), KisMainWindow::None);
            }
        }
    }
}

References KisRemoteFileFetcher::fetchFile(), KisMainWindow::installBundle(), m_mainWindow, KisMainWindow::None, KisMainWindow::openDocument(), and showDropAreaIndicator().

eventFilter()

bool KisWelcomePageWidget::eventFilter ( QObject * watched, QEvent * event )

overrideprotected

Definition at line 486 of file KisWelcomePageWidget.cpp.

{
    if (watched == recentDocumentsListView && event->type() == QEvent::Leave) {
        recentDocumentsListView->clearSelection();
    }
    return QWidget::eventFilter(watched, event);
}

isDevelopmentBuild

bool KisWelcomePageWidget::isDevelopmentBuild ( )

privateslot

Definition at line 645 of file KisWelcomePageWidget.cpp.

{
    return KritaVersionWrapper::isDevelopersBuild();
}

References KritaVersionWrapper::isDevelopersBuild().

largerFont

QFont KisWelcomePageWidget::largerFont ( )

privateslot

Definition at line 830 of file KisWelcomePageWidget.cpp.

{
    QFont larger = font();
    // Font size may be in pixels (on Android) or points (everywhere else.)
    qreal ratio = 1.1;
    if (larger.pixelSize() == -1) {
        larger.setPointSizeF(larger.pointSizeF() * ratio);
    } else {
        larger.setPixelSize(qRound(larger.pixelSize() * ratio));
    }
    return larger;
}

recentDocumentClicked

void KisWelcomePageWidget::recentDocumentClicked ( QModelIndex index )

privateslot

Definition at line 623 of file KisWelcomePageWidget.cpp.

{
    QString fileUrl = index.data(Qt::ToolTipRole).toString();
    m_mainWindow->openDocument(fileUrl, KisMainWindow::None );
}

References m_mainWindow, KisMainWindow::None, and KisMainWindow::openDocument().

setMainWindow()

void KisWelcomePageWidget::setMainWindow

(

KisMainWindow *

m_mainWindow

)

Definition at line 249 of file KisWelcomePageWidget.cpp.

{
    if (mainWin) {
        m_mainWindow = mainWin;
 
        // set the shortcut links from actions (only if a shortcut exists)
        if ( mainWin->viewManager()->actionManager()->actionByName("file_new")->shortcut().toString() != "") {
            newFileLinkShortcut->setText(
                QString("(") + mainWin->viewManager()->actionManager()->actionByName("file_new")->shortcut().toString(QKeySequence::NativeText) + QString(")"));
        }
        if (mainWin->viewManager()->actionManager()->actionByName("file_open")->shortcut().toString()  != "") {
            openFileShortcut->setText(
                QString("(") + mainWin->viewManager()->actionManager()->actionByName("file_open")->shortcut().toString(QKeySequence::NativeText) + QString(")"));
        }
        connect(recentDocumentsListView, SIGNAL(clicked(QModelIndex)), this, SLOT(recentDocumentClicked(QModelIndex)));
        // we need the view manager to actually call actions, so don't create the connections
        // until after the view manager is set
        connect(newFileLink, SIGNAL(clicked(bool)), this, SLOT(slotNewFileClicked()));
        connect(openFileLink, SIGNAL(clicked(bool)), this, SLOT(slotOpenFileClicked()));
        connect(clearRecentFilesLink, SIGNAL(clicked(bool)), mainWin, SLOT(clearRecentFiles()));
 
        KisAction *pasteAction = mainWin->viewManager()->actionManager()->actionByName("edit_paste");
        connect(pasteAction, SIGNAL(triggered()), this, SLOT(slotPaste()));
 
        slotUpdateThemeColors();
 
        // allows RSS news items to apply analytics tracking.
        newsWidget->setAnalyticsTracking("?" + analyticsString);
 
        KisRecentDocumentsModelWrapper *recentFilesModel = KisRecentDocumentsModelWrapper::instance();
        connect(recentFilesModel, SIGNAL(sigModelIsUpToDate()), this, SLOT(slotRecentFilesModelIsUpToDate()));
        recentDocumentsListView->setModel(&recentFilesModel->model());
        slotRecentFilesModelIsUpToDate();
    }
}

References KisActionManager::actionByName(), KisViewManager::actionManager(), analyticsString, KisRecentDocumentsModelWrapper::instance(), m_mainWindow, KisRecentDocumentsModelWrapper::model(), recentDocumentClicked(), slotNewFileClicked(), slotOpenFileClicked(), slotPaste(), slotRecentFilesModelIsUpToDate(), slotUpdateThemeColors(), and KisMainWindow::viewManager.

setupNewsLangSelection()

void KisWelcomePageWidget::setupNewsLangSelection ( QMenu * newsOptionMenu )

private

Definition at line 521 of file KisWelcomePageWidget.cpp.

{
    // Hard-coded news language data:
    // These are languages in which the news items should be regularly
    // translated into as of 04-09-2024.
    // The language display names should not be translated. This reflects
    // the language selection box on the Krita website.
    struct Lang {
        const QString siteCode;
        const QString name;
    };
    static const std::array<Lang, 22> newsLangs = {{
        {QString("en"), QStringLiteral("English")},
        {QString("jp"), QStringLiteral("日本語")},
        {QString("zh"), QStringLiteral("中文 (简体)")},
        {QString("zh-tw"), QStringLiteral("中文 (台灣正體)")},
        {QString("zh-hk"), QStringLiteral("廣東話 (香港)")},
        {QString("ca"), QStringLiteral("Català")},
        {QString("ca@valencia"), QStringLiteral("Català de Valencia")},
        {QString("cs"), QStringLiteral("Čeština")},
        {QString("de"), QStringLiteral("Deutsch")},
        {QString("eo"), QStringLiteral("Esperanto")},
        {QString("es"), QStringLiteral("Español")},
        {QString("eu"), QStringLiteral("Euskara")},
        {QString("fr"), QStringLiteral("Français")},
        {QString("it"), QStringLiteral("Italiano")},
        {QString("lt"), QStringLiteral("lietuvių")},
        {QString("nl"), QStringLiteral("Nederlands")},
        {QString("pt"), QStringLiteral("Português")},
        {QString("sk"), QStringLiteral("Slovenský")},
        {QString("sl"), QStringLiteral("Slovenski")},
        {QString("sv"), QStringLiteral("Svenska")},
        {QString("tr"), QStringLiteral("Türkçe")},
        {QString("uk"), QStringLiteral("Українська")}
    }};
 
    static const QString newsLangConfigName = QStringLiteral("FetchNewsLanguages");
 
    QSharedPointer<QSet<QString>> enabledNewsLangs = QSharedPointer<QSet<QString>>::create();
    {
        // Initialize with the config.
        KisConfig cfg(true);
        auto languagesList = cfg.readList<QString>(newsLangConfigName);
        *enabledNewsLangs = QSet(languagesList.begin(), languagesList.end());
    }
 
    // If no languages are selected in the config, use the automatic selection.
    if (enabledNewsLangs->isEmpty()) {
        enabledNewsLangs->insert(QString(getAutoNewsLang()));
    }
 
    for (const auto &lang : newsLangs) {
        QAction *langItem = newsOptionsMenu->addAction(lang.name);
        langItem->setCheckable(true);
        // We can copy `code` into the lambda because its backing string is a
        // static string literal.
        const QString code = lang.siteCode;
        connect(langItem, &QAction::toggled, newsWidget, [=](bool checked) {
            newsWidget->toggleNewsLanguage(code, checked);
        });
 
        // Set the initial checked state.
        if (enabledNewsLangs->contains(code)) {
            langItem->setChecked(true);
        }
 
        // Connect this lambda after setting the initial checked state because
        // we don't want to overwrite the config when doing the initial setup.
        connect(langItem, &QAction::toggled, [=](bool checked) {
            KisConfig cfg(false);
            // It is safe to modify `enabledNewsLangs` here, because the slots
            // are called synchronously on the UI thread so there is no need
            // for explicit synchronization.
            if (checked) {
                enabledNewsLangs->insert(QString(code));
            } else {
                enabledNewsLangs->remove(QString(code));
            }
            cfg.writeList(newsLangConfigName, enabledNewsLangs->values());
        });
    }
}

References KisConfig::readList(), and KisConfig::writeList().

showDevVersionHighlight()

void KisWelcomePageWidget::showDevVersionHighlight ( )

private

Definition at line 604 of file KisWelcomePageWidget.cpp.

{
    // always flag development version
    if (isDevelopmentBuild()) {
        QString devBuildLabelText = QString("<a style=\"color: " +
                                           blendedColor.name() +
                                           " \" href=\"https://docs.krita.org/en/untranslatable_pages/triaging_bugs.html?"
                                           + analyticsString + "dev-build" + "\">")
                                  .append(i18n("DEV BUILD")).append("</a>");
 
        devBuildLabel->setText(devBuildLabelText);
        devBuildIcon->setVisible(true);
        devBuildLabel->setVisible(true);
    } else {
        devBuildIcon->setVisible(false);
        devBuildLabel->setVisible(false);
    }
}

References analyticsString, blendedColor, and isDevelopmentBuild().

showDropAreaIndicator

void KisWelcomePageWidget::showDropAreaIndicator ( bool show )

slot

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

Definition at line 286 of file KisWelcomePageWidget.cpp.

{
    if (!show) {
        QString dropFrameStyle = QStringLiteral("QFrame#dropAreaIndicator { border: 2px solid transparent }");
        dropFrameBorder->setStyleSheet(dropFrameStyle);
    } else {
        QColor textColor = qApp->palette().color(QPalette::Text);
        QColor backgroundColor = qApp->palette().color(QPalette::Window);
        QColor blendedColor = KisPaintingTweaks::blendColors(textColor, backgroundColor, 0.8);
 
        // QColor.name() turns it into a hex/web format
        QString dropFrameStyle = QString("QFrame#dropAreaIndicator { border: 2px dotted ").append(blendedColor.name()).append(" }") ;
        dropFrameBorder->setStyleSheet(dropFrameStyle);
    }
}

References backgroundColor, KisPaintingTweaks::blendColors(), blendedColor, and textColor.

slotNewFileClicked

void KisWelcomePageWidget::slotNewFileClicked ( )

privateslot

Definition at line 650 of file KisWelcomePageWidget.cpp.

{
    m_mainWindow->slotFileNew();
}

References m_mainWindow, and KisMainWindow::slotFileNew().

slotOpenFileClicked

void KisWelcomePageWidget::slotOpenFileClicked ( )

privateslot

Definition at line 655 of file KisWelcomePageWidget.cpp.

{
    m_mainWindow->slotFileOpen();
}

References m_mainWindow, and KisMainWindow::slotFileOpen().

slotPaste

void KisWelcomePageWidget::slotPaste ( )

privateslot

Definition at line 660 of file KisWelcomePageWidget.cpp.

{
    if (!this->isVisible())
        return;
 
    // Don't do anything if there's no image in the clipboard
    if (!KisClipboard::instance()->hasImage())
        return;
 
    KisDlgCreateNewDocument *dlg = new KisDlgCreateNewDocument(this);
 
    dlg->SelectPage(KisDlgCreateNewDocument::Page::CreateFromClipboard);
    dlg->exec();
    dlg->deleteLater();
}

References KisDlgCreateNewDocument::CreateFromClipboard, KisClipboard::instance(), and KisDlgCreateNewDocument::SelectPage().

slotRecentDocContextMenuRequest

void KisWelcomePageWidget::slotRecentDocContextMenuRequest ( const QPoint & pos )

privateslot

Definition at line 629 of file KisWelcomePageWidget.cpp.

{
    QMenu contextMenu;
    QModelIndex index = recentDocumentsListView->indexAt(pos);
    QAction *actionForget = 0;
    if (index.isValid()) {
        actionForget = new QAction(i18n("Forget \"%1\"", index.data(Qt::DisplayRole).toString()), &contextMenu);
        contextMenu.addAction(actionForget);
    }
    QAction *triggered = contextMenu.exec(recentDocumentsListView->mapToGlobal(pos));
 
    if (index.isValid() && triggered == actionForget) {
        m_mainWindow->removeRecentFile(index.data(Qt::ToolTipRole).toString());
    }
}

References m_mainWindow, and KisMainWindow::removeRecentFile().

slotRecentFilesModelIsUpToDate

void KisWelcomePageWidget::slotRecentFilesModelIsUpToDate ( )

privateslot

Once all files in the recent documents model are checked, cleanup the UI if the model is empty

Definition at line 676 of file KisWelcomePageWidget.cpp.

{
    KisRecentDocumentsModelWrapper *recentFilesModel = KisRecentDocumentsModelWrapper::instance();
    const bool modelIsEmpty = recentFilesModel->model().rowCount() == 0;
 
    if (modelIsEmpty) {
        recentDocsStackedWidget->setCurrentWidget(labelNoRecentDocs);
    } else {
        recentDocsStackedWidget->setCurrentWidget(recentDocumentsListView);
    }
    clearRecentFilesLink->setVisible(!modelIsEmpty);
}

References KisRecentDocumentsModelWrapper::instance(), and KisRecentDocumentsModelWrapper::model().

slotScrollerStateChanged

void KisWelcomePageWidget::slotScrollerStateChanged ( QScroller::State state )

inlineprivateslot

Definition at line 72 of file KisWelcomePageWidget.h.

{ KisKineticScroller::updateCursor(this, state); }

References KisKineticScroller::updateCursor().

slotUpdateThemeColors

void KisWelcomePageWidget::slotUpdateThemeColors ( )

slot

Definition at line 302 of file KisWelcomePageWidget.cpp.

{
    textColor = qApp->palette().color(QPalette::Text);
    backgroundColor = qApp->palette().color(QPalette::Window);
 
    // make the welcome screen labels a subtle color so it doesn't clash with the main UI elements
    blendedColor = KisPaintingTweaks::blendColors(textColor, backgroundColor, 0.8);
    // only apply color to the widget itself, not to the tooltip or something
    blendedStyle = "QWidget{color: " + blendedColor.name() + "}";
 
    // what labels to change the color...
    startTitleLabel->setStyleSheet(blendedStyle);
    recentDocumentsLabel->setStyleSheet(blendedStyle);
    helpTitleLabel->setStyleSheet(blendedStyle);
    newsTitleLabel->setStyleSheet(blendedStyle);
    newFileLinkShortcut->setStyleSheet(blendedStyle);
    openFileShortcut->setStyleSheet(blendedStyle);
    clearRecentFilesLink->setStyleSheet(blendedStyle);
    recentDocumentsListView->setStyleSheet(blendedStyle);
    newsWidget->setStyleSheet(blendedStyle);
 
#ifdef Q_OS_ANDROID
    blendedStyle = blendedStyle + "\nQPushButton { padding: 10px }";
#endif
 
    newFileLink->setStyleSheet(blendedStyle);
    openFileLink->setStyleSheet(blendedStyle);
 
    // make drop area QFrame have a dotted line
    dropFrameBorder->setObjectName("dropAreaIndicator");
    QString dropFrameStyle = QString("QFrame#dropAreaIndicator { border: 4px dotted ").append(blendedColor.name()).append("}");
    dropFrameBorder->setStyleSheet(dropFrameStyle);
 
    // only show drop area when we have a document over the empty area
    showDropAreaIndicator(false);
 
    // add icons for new and open settings to make them stand out a bit more
    openFileLink->setIconSize(QSize(48, 48));
    newFileLink->setIconSize(QSize(48, 48));
 
    openFileLink->setIcon(KisIconUtils::loadIcon("document-open"));
    newFileLink->setIcon(KisIconUtils::loadIcon("document-new"));
 
    btnNewsOptions->setIcon(KisIconUtils::loadIcon("view-choose"));
    btnNewsOptions->setFlat(true);
 
    supportKritaIcon->setIcon(KisIconUtils::loadIcon(QStringLiteral("support-krita")));
    userManualIcon->setIcon(KisIconUtils::loadIcon(QStringLiteral("bookmarks")));
    gettingStartedIcon->setIcon(KisIconUtils::loadIcon(QStringLiteral("get_started")));
    userCommunityIcon->setIcon(KisIconUtils::loadIcon(QStringLiteral("comunity")));
    kritaWebsiteIcon->setIcon(KisIconUtils::loadIcon(QStringLiteral("website")));
    sourceCodeIcon->setIcon(KisIconUtils::loadIcon(QStringLiteral("code")));
    kdeIcon->setIcon(KisIconUtils::loadIcon(QStringLiteral("kde")));
 
    // HTML links seem to be a bit more stubborn with theme changes... setting inline styles to help with color change
    userCommunityLink->setText(QString("<a style=\"color: " + blendedColor.name() + " \" href=\"https://krita-artists.org\">")
                               .append(i18n("User Community")).append("</a>"));
 
    gettingStartedLink->setText(QString("<a style=\"color: " + blendedColor.name() + " \" href=\"https://docs.krita.org/user_manual/getting_started.html\">")
                                .append(i18n("Getting Started")).append("</a>"));
 
    manualLink->setText(QString("<a style=\"color: " + blendedColor.name() + " \" href=\"https://docs.krita.org\">")
                        .append(i18n("User Manual")).append("</a>"));
 
    supportKritaLink->setText(QString("<a style=\"color: " + blendedColor.name() + " \" href=\"https://krita.org/support-us/donations?" + analyticsString + "donations" + "\">")
                              .append(i18n("Support Krita")).append("</a>"));
 
    kritaWebsiteLink->setText(QString("<a style=\"color: " + blendedColor.name() + " \" href=\"https://www.krita.org?" + analyticsString + "marketing-site" + "\">")
                              .append(i18n("Krita Website")).append("</a>"));
 
    sourceCodeLink->setText(QString("<a style=\"color: " + blendedColor.name() + " \" href=\"https://invent.kde.org/graphics/krita\">")
                            .append(i18n("Source Code")).append("</a>"));
 
    poweredByKDELink->setText(QString("<a style=\"color: " + blendedColor.name() + " \" href=\"https://userbase.kde.org/What_is_KDE\">")
                              .append(i18n("Powered by KDE")).append("</a>"));
 
    QString translationNoFeed = i18n("You can <a href=\"ignored\" style=\"color: COLOR_PLACEHOLDER; text-decoration: underline;\">enable news</a> from krita.org in various languages with the menu above");
    labelNoFeed->setText(translationNoFeed.replace("COLOR_PLACEHOLDER", blendedColor.name()));
 
    const QColor faintTextColor = KisPaintingTweaks::blendColors(textColor, backgroundColor, 0.4);
    const QString &faintTextStyle = "QWidget{color: " + faintTextColor.name() + "}";
    labelNoRecentDocs->setStyleSheet(faintTextStyle);
    labelNoFeed->setStyleSheet(faintTextStyle);
 
    const QColor frameColor = KisPaintingTweaks::blendColors(textColor, backgroundColor, 0.1);
    const QString &frameQss = "{border: 1px solid " + frameColor.name() + "}";
    recentDocsStackedWidget->setStyleSheet("QStackedWidget#recentDocsStackedWidget" + frameQss);
    newsFrame->setStyleSheet("QFrame#newsFrame" + frameQss);
 
    // show the dev version labels, if dev version is detected
    showDevVersionHighlight();
 
#ifdef ENABLE_UPDATERS
    updateVersionUpdaterFrame(); // updater frame
#endif
 
#ifdef Q_OS_ANDROID
    donationLink->setText(
        QStringLiteral("<a href=\"#\">%1</a>").arg(QString(i18n("Get your Krita Supporter Badge here!"))));
#endif
 
#ifdef Q_OS_MACOS
    // macOS store version should not contain external links containing donation buttons or forms
    if (KisMacosEntitlements().sandbox()) {
        supportKritaLink->hide();
        supportKritaIcon->hide();
        labelSupportText->hide();
        kritaWebsiteLink->hide();
        kritaWebsiteIcon->hide();
        donationLink->hide();
    }
#endif
}

References analyticsString, backgroundColor, KisPaintingTweaks::blendColors(), blendedColor, blendedStyle, KisIconUtils::loadIcon(), showDevVersionHighlight(), showDropAreaIndicator(), and textColor.

Member Data Documentation

analyticsString

const QString KisWelcomePageWidget::analyticsString = "pk_campaign=startup-sceen&pk_kwd="

private

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

Definition at line 117 of file KisWelcomePageWidget.h.

backgroundColor

QColor KisWelcomePageWidget::backgroundColor

private

Definition at line 122 of file KisWelcomePageWidget.h.

blendedColor

QColor KisWelcomePageWidget::blendedColor

private

Definition at line 123 of file KisWelcomePageWidget.h.

blendedStyle

QString KisWelcomePageWidget::blendedStyle

private

Definition at line 124 of file KisWelcomePageWidget.h.

m_mainWindow

KisMainWindow* KisWelcomePageWidget::m_mainWindow {nullptr}

private

Definition at line 111 of file KisWelcomePageWidget.h.

{nullptr};

m_networkIsAllowed

bool KisWelcomePageWidget::m_networkIsAllowed {false}

private

Definition at line 130 of file KisWelcomePageWidget.h.

{false};

recentItemDelegate

QScopedPointer<RecentItemDelegate> KisWelcomePageWidget::recentItemDelegate

private

Definition at line 132 of file KisWelcomePageWidget.h.

textColor

QColor KisWelcomePageWidget::textColor

private

Definition at line 121 of file KisWelcomePageWidget.h.

---

The documentation for this class was generated from the following files:

• libs/ui/KisWelcomePageWidget.h
• libs/ui/KisWelcomePageWidget.cpp