KisDockerHud Class Reference

#include <KisDockerHud.h>

Inheritance diagram for KisDockerHud:

Classes
struct	Private

Public Slots
void	borrowDocker ()
void	borrowOrReturnDocker ()
void	returnDocker (bool beingTaken=false)
void	setIsShown (bool isShown)
void	slotUpdateIcons ()

Public Member Functions
	KisDockerHud (QString borrowerName, QString configId)
	~KisDockerHud () override

Protected Member Functions
void	hideEvent (QHideEvent *event) override
void	showEvent (QShowEvent *event) override

Private Slots
void	hideBorrowerLabel ()
QString	readCurrentDocker ()
void	readDockerList ()
void	showBorrowerLabel (QString borrowerName)
void	showDockerConfig ()
void	tryConnectToDockers ()
void	writeCurrentDocker ()
void	writeDockerList (QList< QVariant >)

Private Attributes
const QScopedPointer< Private >	m_d

Static Private Attributes
static QHash< QString, QList< QString > >	borrowedWidgetOwners = QHash<QString, QList<QString>>()

Detailed Description

Definition at line 13 of file KisDockerHud.h.

Constructor & Destructor Documentation

KisDockerHud()

KisDockerHud::KisDockerHud	(	QString	borrowerName,
		QString	configId )

Definition at line 43 of file KisDockerHud.cpp.

    : QWidget(),
      m_d(new Private)
{
    this->setObjectName(configId + "DockerHud");
    this->setAutoFillBackground(true); // so that it's not transparent
 
    m_d->borrowerName = borrowerName;
    m_d->configId = configId;
 
    QVBoxLayout *layout = new QVBoxLayout();
    QHBoxLayout *menuLayout = new QHBoxLayout();
 
    // Put the docker config button before the combobox,
    // so it cannot go offscreen in case of a wide widget.
    m_d->dockerMenu = new QToolButton();
    m_d->dockerMenu->setAutoRaise(true);
    m_d->dockerMenu->setToolTip(i18n("Configure docker panel"));
    connect(m_d->dockerMenu, SIGNAL(clicked()), this, SLOT(showDockerConfig()));
    menuLayout->addWidget(m_d->dockerMenu);
 
    m_d->dockerComboBox = new QComboBox();
    menuLayout->addWidget(m_d->dockerComboBox);
 
    layout->addLayout(menuLayout);
    layout->addWidget(new KSeparator());
    m_d->dockerLayout = new QVBoxLayout();
    layout->addLayout(m_d->dockerLayout);
    this->setLayout(layout);
 
    m_d->dockerIOULabel = new QLabel(i18nc("%1 is the name of the widget", "Docker is open in %1. Close %1 to show here.", borrowerName));
    m_d->dockerIOULabel->setWordWrap(true);
    m_d->dockerIOULabel->setAlignment(Qt::AlignCenter);
 
    tryConnectToDockers();
 
    slotUpdateIcons();
}

References connect(), m_d, showDockerConfig(), slotUpdateIcons(), and tryConnectToDockers().

~KisDockerHud()

KisDockerHud::~KisDockerHud ( )

override

Definition at line 82 of file KisDockerHud.cpp.

{
    delete m_d->dockerIOULabel;
}

References m_d.

Member Function Documentation

borrowDocker

void KisDockerHud::borrowDocker ( )

slot

Definition at line 99 of file KisDockerHud.cpp.

                                {
    KisMainWindow *mainWindow = KisPart::instance()->currentMainwindow();
 
 
    const QString dockerId = m_d->dockerComboBox->currentData().toString();
    QDockWidget *docker = mainWindow->findChild<QDockWidget*>(dockerId);
    if (docker == nullptr) {
        return;
    }
 
    QList<QString> &owners = borrowedWidgetOwners[dockerId];
 
    // If the docker is being borrowed by another widget, request its return
    if (!owners.empty() && owners.last() != this->objectName()) {
        KisDockerHud *prevOwner = mainWindow->findChild<KisDockerHud*>(owners.last());
        prevOwner->returnDocker(true);
    }
 
    // Notify any waiting borrowers that we own it now
    Q_FOREACH(QString waitingWidgetId, owners) {
        KisDockerHud *waitingWidget = mainWindow->findChild<KisDockerHud*>(waitingWidgetId);
        waitingWidget->showBorrowerLabel(m_d->borrowerName);
    }
 
    if (!owners.contains(this->objectName())) {
        owners.append(this->objectName());
    }
 
    // Now actually borrow it.
 
    m_d->oldDockerParent = docker;
 
    // Animation dockers have playback controls and such in the titlebar,
    // so we borrow those as well.
    if (docker->objectName() == "AnimationCurvesDocker" || docker->objectName() == "TimelineDocker") {
        KisUtilityTitleBar *titleBar = dynamic_cast<KisUtilityTitleBar*>(docker->titleBarWidget());
        KIS_SAFE_ASSERT_RECOVER_NOOP(titleBar);
        if (titleBar) {
            QWidget *widgetArea = titleBar->widgetArea();
            m_d->dockerLayout->addWidget(widgetArea);
        }
    }
 
    m_d->dockerLayout->addWidget(docker->widget());
    docker->setWidget(m_d->dockerIOULabel);
 
    // Hack: somewhat fixes Animation Curves's titlebar being too tall
    m_d->dockerLayout->setStretch(m_d->dockerLayout->count()-1, 1);
 
    m_d->isBorrowing = true;
}

References borrowedWidgetOwners, KisPart::currentMainwindow(), KisPart::instance(), KIS_SAFE_ASSERT_RECOVER_NOOP, m_d, returnDocker(), showBorrowerLabel(), and KisUtilityTitleBar::widgetArea().

borrowOrReturnDocker

void KisDockerHud::borrowOrReturnDocker ( )

slot

Definition at line 87 of file KisDockerHud.cpp.

{
    if (m_d->isBorrowing) { // then return it
        returnDocker();
    }
 
    // If really visible, borrow it
    if (this->isVisible() && m_d->isShown) {
        borrowDocker();
    }
}

References borrowDocker(), m_d, and returnDocker().

hideBorrowerLabel

void KisDockerHud::hideBorrowerLabel ( )

privateslot

Definition at line 315 of file KisDockerHud.cpp.

{
    m_d->dockerIOULabel->hide();
    m_d->dockerLayout->takeAt(0)->widget();
    m_d->dockerIOULabel->setText(i18nc("%1 is the name of the widget",
                                        "Docker is open in %1. Close %1 to show here.", m_d->borrowerName));
}

References m_d.

hideEvent()

void KisDockerHud::hideEvent ( QHideEvent * event )

overrideprotected

Definition at line 280 of file KisDockerHud.cpp.

{
    borrowOrReturnDocker();
 
    QWidget::hideEvent(event);
}

References borrowOrReturnDocker().

readCurrentDocker

QString KisDockerHud::readCurrentDocker ( )

privateslot

Definition at line 256 of file KisDockerHud.cpp.

{
    return KisConfig(true).readEntry(m_d->configId+"/currentDocker", QString("BrushHudDocker"));
}

References m_d, and KisConfig::readEntry().

readDockerList

void KisDockerHud::readDockerList ( )

privateslot

Definition at line 236 of file KisDockerHud.cpp.

{
    m_d->dockerComboBox->clear();
    const QList<QString> defaultDockers = QList<QString>({"BrushHudDocker", "KisLayerBox"});
    const QList<QString> dockerList = KisConfig(true).readList(m_d->configId+"/dockerList", defaultDockers);
 
    KisMainWindow *mainWindow = KisPart::instance()->currentMainwindow();
    // for an ordered list
    Q_FOREACH(QString objName, dockerList) {
        QDockWidget *docker = mainWindow->findChild<QDockWidget*>(objName);
        if (docker != nullptr) {
            m_d->dockerComboBox->addItem(docker->windowTitle(), docker->objectName());
        }
    }
}

References KisPart::currentMainwindow(), KisPart::instance(), m_d, and KisConfig::readList().

returnDocker

void KisDockerHud::returnDocker ( bool beingTaken = false )

slot

Definition at line 150 of file KisDockerHud.cpp.

                                               {
    QString dockerId = m_d->oldDockerParent->objectName();
    QList<QString>* owners = &borrowedWidgetOwners[dockerId];
 
    if (!owners->isEmpty()) {
        const int idx = owners->indexOf(this->objectName());
        const bool wasOwner = idx == owners->count()-1;
        if (!beingTaken) {
            owners->removeAt(idx); // we don't want it anymore
        }
 
        // If we don't own it, just remove our label
        if (!wasOwner) {
            hideBorrowerLabel();
            return;
        }
    }
 
    // If we own it, actually return it.
 
    if (m_d->dockerLayout->count() == 2) {
        // Return the animation dockers' titlebar widget as well
        KisUtilityTitleBar *titleBar = dynamic_cast<KisUtilityTitleBar*>(m_d->oldDockerParent->titleBarWidget());
        KIS_SAFE_ASSERT_RECOVER_NOOP(titleBar);
        if (titleBar) {
            titleBar->setWidgetArea(m_d->dockerLayout->takeAt(0)->widget());
        }
    }
 
    QWidget* dockerInside = m_d->dockerLayout->takeAt(0)->widget();
    m_d->oldDockerParent->setWidget(dockerInside);
    dockerInside->setParent(m_d->oldDockerParent);
 
    m_d->oldDockerParent = nullptr;
    m_d->isBorrowing = false;
 
    // If another borrower is in line, tell it to take it.
    if (!beingTaken && !owners->empty()) {
        KisMainWindow *mainWindow = KisPart::instance()->currentMainwindow();
        KisDockerHud *newOwner = mainWindow->findChild<KisDockerHud*>(owners->last());
        newOwner->borrowDocker();
    }
}

References borrowDocker(), borrowedWidgetOwners, KisPart::currentMainwindow(), hideBorrowerLabel(), KisPart::instance(), KIS_SAFE_ASSERT_RECOVER_NOOP, m_d, and KisUtilityTitleBar::setWidgetArea().

setIsShown

void KisDockerHud::setIsShown ( bool isShown )

slot

Definition at line 287 of file KisDockerHud.cpp.

{
    m_d->isShown = isShown;
}

References m_d.

showBorrowerLabel

void KisDockerHud::showBorrowerLabel ( QString borrowerName )

privateslot

Definition at line 306 of file KisDockerHud.cpp.

{
    m_d->dockerIOULabel->setText(i18nc("%1 is the name of the widget",
                                       "Docker is open in %1. Close %1 to show here.", borrowerName));
    m_d->dockerLayout->addWidget(m_d->dockerIOULabel);
    m_d->dockerLayout->setStretchFactor(m_d->dockerIOULabel, 1); // push the other widgets to the top
    m_d->dockerIOULabel->show();
}

References m_d.

showDockerConfig

void KisDockerHud::showDockerConfig ( )

privateslot

Definition at line 194 of file KisDockerHud.cpp.

{
    QList<QString> currentDockerNames;
    QList<QVariant> currentDockerIds;
    for(int i = 0; i < m_d->dockerComboBox->count(); i++) {
        currentDockerNames.append(m_d->dockerComboBox->itemText(i));
        currentDockerIds.append(m_d->dockerComboBox->itemData(i));
    }
 
    KisMainWindow *mainWindow = KisPart::instance()->currentMainwindow();
    const QList<QDockWidget*> dockers = mainWindow->dockWidgets();
 
    QList<QString> dockerNames;
    QList<QVariant> dockerIds;
    Q_FOREACH(QDockWidget* docker, dockers) {
        if (!currentDockerIds.contains(docker->objectName())) {
            dockerNames.append(docker->windowTitle());
            dockerIds.append(docker->objectName());
        }
    }
 
    KisDlgListPicker config = KisDlgListPicker(i18nc("%1 is the name of the widget", "Configure %1 dockers", m_d->borrowerName),
                                                    i18n("Available dockers"), i18n("Current dockers"),
                                                    dockerNames, dockerIds, currentDockerNames, currentDockerIds, this);
 
    if (config.exec() == QDialog::Accepted) {
        writeDockerList(config.getChosenData());
        const QString currentDocker = readCurrentDocker();
        readDockerList();
        m_d->dockerComboBox->setCurrentIndex(m_d->dockerComboBox->findData(currentDocker, Qt::UserRole));
 
        // If the current docker was removed from the list, use the first one.
        if (m_d->dockerComboBox->currentData().isNull() && m_d->dockerComboBox->count() != 0) {
            m_d->dockerComboBox->setCurrentIndex(0);
        }
    }
}

References KisPart::currentMainwindow(), KisMainWindow::dockWidgets(), KisDlgListPicker::getChosenData(), KisPart::instance(), m_d, readCurrentDocker(), readDockerList(), and writeDockerList().

showEvent()

void KisDockerHud::showEvent ( QShowEvent * event )

overrideprotected

Definition at line 267 of file KisDockerHud.cpp.

{
    // In case we were loaded before the dockers were (as in the toolbar), 
    // try connecting to them here.
    if (!m_d->isConnected) {
        tryConnectToDockers();
    }
 
    borrowOrReturnDocker();
 
    QWidget::showEvent(event);
}

References borrowOrReturnDocker(), m_d, and tryConnectToDockers().

slotUpdateIcons

void KisDockerHud::slotUpdateIcons ( )

slot

Definition at line 262 of file KisDockerHud.cpp.

{
    m_d->dockerMenu->setIcon(KisIconUtils::loadIcon("applications-system"));
}

References KisIconUtils::loadIcon(), and m_d.

tryConnectToDockers

void KisDockerHud::tryConnectToDockers ( )

privateslot

Definition at line 292 of file KisDockerHud.cpp.

{
    if (KisPart::instance()->currentMainwindow() == nullptr) {
        return;
    }
 
    readDockerList();
    m_d->dockerComboBox->setCurrentIndex(m_d->dockerComboBox->findData(readCurrentDocker()));
    connect(m_d->dockerComboBox, SIGNAL(currentIndexChanged(int)), this, SLOT(borrowOrReturnDocker()));
    connect(m_d->dockerComboBox, SIGNAL(currentIndexChanged(int)), this, SLOT(writeCurrentDocker()));
 
    m_d->isConnected = true;
}

References borrowOrReturnDocker(), connect(), KisPart::instance(), m_d, readCurrentDocker(), readDockerList(), and writeCurrentDocker().

writeCurrentDocker

void KisDockerHud::writeCurrentDocker ( )

privateslot

Definition at line 252 of file KisDockerHud.cpp.

{
    KisConfig(false).writeEntry(m_d->configId+"/currentDocker", m_d->dockerComboBox->currentData(Qt::UserRole));
}

References m_d, and KisConfig::writeEntry().

writeDockerList

void KisDockerHud::writeDockerList ( QList< QVariant > currentList )

privateslot

Definition at line 232 of file KisDockerHud.cpp.

{
    KisConfig(false).writeList(m_d->configId+"/dockerList", currentList);
}

References m_d, and KisConfig::writeList().

Member Data Documentation

borrowedWidgetOwners

QHash< QString, QList< QString > > KisDockerHud::borrowedWidgetOwners = QHash<QString, QList<QString>>()

staticprivate

Definition at line 45 of file KisDockerHud.h.

m_d

const QScopedPointer<Private> KisDockerHud::m_d

private

Definition at line 43 of file KisDockerHud.h.

---

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

• libs/ui/widgets/KisDockerHud.h
• libs/ui/widgets/KisDockerHud.cpp