Kwave::Splash Class Reference

#include <Splash.h>

Inheritance diagram for Kwave::Splash:

Collaboration diagram for Kwave::Splash:

Public Member Functions
	Splash (const QString &PNGFile)
virtual	~Splash () Q_DECL_OVERRIDE
virtual void	paintEvent (QPaintEvent *e) Q_DECL_OVERRIDE
virtual void	mousePressEvent (QMouseEvent *) Q_DECL_OVERRIDE
void	done ()

Static Public Member Functions
static void	showMessage (const QString &message)

Private Attributes
QFont	m_font
QPixmap	m_pixmap
QString	m_message

Static Private Attributes
static QPointer< Kwave::Splash >	m_splash = Q_NULLPTR

Detailed Description

Definition at line 34 of file Splash.h.

Constructor & Destructor Documentation

Splash()

Kwave::Splash::Splash ( const QString &  PNGFile )

explicit

Constructor

Parameters

PNGFile

name of a file to be shown as splashscreen, should be found in one of the "appdata" directories.

Definition at line 42 of file Splash.cpp.

References background, m_font, m_pixmap, m_splash, and rect().

    :QFrame(Q_NULLPTR, Qt::FramelessWindowHint | Qt::WindowStaysOnTopHint),
     m_font(),
     m_pixmap(QStandardPaths::locate(QStandardPaths::DataLocation, PNGFile)),
     m_message(_("   "))
{
    const int w = m_pixmap.width();
    const int h = m_pixmap.height();
    setFixedSize(w, h);

    QPainter p;
    p.begin(&m_pixmap);

    // get all the strings that we should display
    const KAboutData about_data = KAboutData::applicationData();
    QString version = i18nc("%1=Version number", "v%1", about_data.version());

    m_font.setBold(true);
    m_font.setStyleHint(QFont::Decorative);
    m_font.setWeight(QFont::Black);
    p.setFont(m_font);

    QFontMetrics fm(m_font);
    QRect rect = fm.boundingRect(version);

    // version
    const int r  = 5;
    const int th = rect.height();
    const int tw = rect.width();
    const int x  = w - 10 - tw;
    const int y  = h - 10 - th;

    const QBrush brush(palette().background().color());
    p.setBrush(brush);
    p.setOpacity(0.50);
    p.setPen(Qt::NoPen);
    p.drawRoundRect(
        x - r, y - r,
        tw + 2 * r, th + (2 * r),
        (200 * r) / th, (200 * r) / th
    );

    p.setOpacity(1.0);
    p.setPen(palette().buttonText().color());
    p.drawText(x, y, tw, th, Qt::AlignCenter, version);

    p.end();

    // center on the screen
    rect = QRect(QPoint(), m_pixmap.size());
    resize(rect.size());
    move(QApplication::desktop()->screenGeometry().center() - rect.center());

    m_splash = this;
}

Here is the call graph for this function:

~Splash()

Kwave::Splash::~Splash ( )

virtual

Destructor

Definition at line 109 of file Splash.cpp.

References m_splash.

{
    m_splash = Q_NULLPTR;
}

Member Function Documentation

done()

void Kwave::Splash::done

(

)

should be called when the splashscreen is no longer needed

Definition at line 99 of file Splash.cpp.

References m_splash.

Referenced by main(), and mousePressEvent().

{
    // check: start() must be called from the GUI thread only!
    Q_ASSERT(this->thread() == QThread::currentThread());
    Q_ASSERT(this->thread() == qApp->thread());
    m_splash = Q_NULLPTR;
    hide();
}

Here is the caller graph for this function:

mousePressEvent()

void Kwave::Splash::mousePressEvent ( QMouseEvent *  )

virtual

hides the splash screen on mouse click

Definition at line 150 of file Splash.cpp.

References done().

{
    done();
}

Here is the call graph for this function:

paintEvent()

void Kwave::Splash::paintEvent ( QPaintEvent *  e )

virtual

handles the painting of this splash screen

Definition at line 124 of file Splash.cpp.

References m_font, m_message, m_pixmap, m_splash, and rect().

{
    // special handling: a null message tells us to hide
    if (!m_message.length()) {
        m_splash = Q_NULLPTR;
        hide();
        return;
    }

    QRect rect(this->rect());
    const int border = 5;
    rect.setRect(
        rect.x() + border,
        rect.y() + border,
        rect.width()  - (2 * border),
        rect.height() - (2 * border)
    );

    QPainter p(this);
    p.drawPixmap(this->rect(), m_pixmap);
    p.setFont(m_font);
    p.setPen(palette().buttonText().color());
    p.drawText(rect, Qt::AlignLeft | Qt::AlignTop, m_message);
}

Here is the call graph for this function:

showMessage()

void Kwave::Splash::showMessage ( const QString &  message )

static

wrapper for QSplashScreen::showMessage with only one parameter

Definition at line 115 of file Splash.cpp.

References m_splash.

Referenced by Kwave::FileContext::init(), Kwave::TopWidget::loadFile(), Kwave::App::newInstance(), Kwave::App::newWindow(), and Kwave::TopWidget::showInSplashSreen().

{
    if (!m_splash) return;
    m_splash->m_message = message;
    m_splash->repaint();
    QApplication::processEvents(QEventLoop::AllEvents);
}

Here is the caller graph for this function:

Member Data Documentation

m_font

QFont Kwave::Splash::m_font

private

font to use for the status text and version number

Definition at line 64 of file Splash.h.

Referenced by paintEvent(), and Splash().

m_message

QString Kwave::Splash::m_message

private

last status message

Definition at line 70 of file Splash.h.

Referenced by paintEvent().

m_pixmap

QPixmap Kwave::Splash::m_pixmap

private

pixmap with the Kwave logo

Definition at line 67 of file Splash.h.

Referenced by paintEvent(), and Splash().

m_splash

QPointer< Kwave::Splash > Kwave::Splash::m_splash = Q_NULLPTR

staticprivate

static instance

Definition at line 73 of file Splash.h.

Referenced by done(), paintEvent(), showMessage(), Splash(), and ~Splash().

---

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

• kwave/Splash.h
• kwave/Splash.cpp