qdesigner_internal::WidgetBoxTreeWidget Class Reference

WidgetBoxTreeWidget: A tree of categories. More...

Inheritance diagram for qdesigner_internal::WidgetBoxTreeWidget:

Collaboration diagram for qdesigner_internal::WidgetBoxTreeWidget:

Public Types
typedef QDesignerWidgetBoxInterface::Category	Category
typedef QDesignerWidgetBoxInterface::CategoryList	CategoryList
typedef QDesignerWidgetBoxInterface::Widget	Widget

Public Slots
void	filter (const QString &)

Signals
void	pressed (const QString name, const QString dom_xml, const QPoint &global_mouse_pos)

Public Member Functions
	WidgetBoxTreeWidget (SampleDesignerInterface *core, QWidget *parent=0)
virtual	~WidgetBoxTreeWidget ()
void	addCategory (const Category &cat)
void	addWidget (int cat_idx, const Widget &wgt)
Category	category (int cat_idx) const
int	categoryCount () const
void	dropWidgets (const QList< QDesignerDnDItemInterface * > &item_list)
QString	fileName () const
QIcon	iconForWidget (QString iconName) const
bool	load (QDesignerWidgetBox::LoadMode loadMode)
bool	loadContents (const QString &contents)
void	removeCategory (int cat_idx)
void	removeWidget (int cat_idx, int wgt_idx)
bool	save ()
void	setFileName (const QString &file_name)
Widget	widget (int cat_idx, int wgt_idx) const
int	widgetCount (int cat_idx) const

Protected Member Functions
virtual void	contextMenuEvent (QContextMenuEvent *e)
virtual void	resizeEvent (QResizeEvent *e)

Private Types
typedef QHash< QString, QIcon >	IconCache

Private Slots
void	deleteScratchpad ()
void	handleMousePress (QTreeWidgetItem *item)
void	slotIconMode ()
void	slotLastScratchPadItemDeleted ()
void	slotListMode ()
void	slotSave ()
void	slotScratchPadItemDeleted ()

Private Member Functions
WidgetBoxCategoryListView *	addCategoryView (QTreeWidgetItem *parent, bool iconMode)
void	addCustomCategories (bool replace)
void	adjustSubListSize (QTreeWidgetItem *cat_item)
WidgetBoxCategoryListView *	categoryViewAt (int idx) const
int	ensureScratchpad ()
int	indexOfCategory (const QString &name) const
int	indexOfScratchpad () const
CategoryList	loadCustomCategoryList () const
void	restoreExpandedState ()
void	saveExpandedState () const
void	updateViewMode ()
void	writeCategories (QXmlStreamWriter &writer, const CategoryList &cat_list) const

Static Private Member Functions
static bool	readCategories (const QString &fileName, const QString &xml, CategoryList *cats, QString *errorMessage)
static bool	readWidget (Widget *w, const QString &xml, QXmlStreamReader &r)

Private Attributes
SampleDesignerInterface *	m_core
QString	m_file_name
bool	m_iconMode
IconCache	m_pluginIcons
QTimer *	m_scratchPadDeleteTimer

Detailed Description

WidgetBoxTreeWidget: A tree of categories.

Definition at line 68 of file widgetboxtreewidget.h.

Member Typedef Documentation

Category

typedef QDesignerWidgetBoxInterface::Category qdesigner_internal::WidgetBoxTreeWidget::Category

Definition at line 73 of file widgetboxtreewidget.h.

CategoryList

typedef QDesignerWidgetBoxInterface::CategoryList qdesigner_internal::WidgetBoxTreeWidget::CategoryList

Definition at line 74 of file widgetboxtreewidget.h.

IconCache

typedef QHash<QString, QIcon> qdesigner_internal::WidgetBoxTreeWidget::IconCache

private

Definition at line 141 of file widgetboxtreewidget.h.

Widget

typedef QDesignerWidgetBoxInterface::Widget qdesigner_internal::WidgetBoxTreeWidget::Widget

Definition at line 72 of file widgetboxtreewidget.h.

Constructor & Destructor Documentation

WidgetBoxTreeWidget()

qdesigner_internal::WidgetBoxTreeWidget::WidgetBoxTreeWidget ( SampleDesignerInterface *  core, QWidget *  parent = 0  )

explicit

Definition at line 111 of file widgetboxtreewidget.cpp.

    : QTreeWidget(parent), m_core(core), m_iconMode(false), m_scratchPadDeleteTimer(nullptr)
{
    setFocusPolicy(Qt::NoFocus);
    setIndentation(0);
    setRootIsDecorated(false);
    setColumnCount(1);
    header()->hide();
#if QT_VERSION >= 0x050000
    header()->setSectionResizeMode(QHeaderView::Stretch);
#endif
    setTextElideMode(Qt::ElideMiddle);
    setVerticalScrollMode(ScrollPerPixel);
 
    setItemDelegate(new SheetDelegate(this, this));
 
    connect(this, SIGNAL(itemPressed(QTreeWidgetItem*, int)), this,
            SLOT(handleMousePress(QTreeWidgetItem*)));
}

References handleMousePress().

Here is the call graph for this function:

~WidgetBoxTreeWidget()

qdesigner_internal::WidgetBoxTreeWidget::~WidgetBoxTreeWidget ( )

virtual

Definition at line 165 of file widgetboxtreewidget.cpp.

{
    saveExpandedState();
}

References saveExpandedState().

Here is the call graph for this function:

Member Function Documentation

addCategory()

void qdesigner_internal::WidgetBoxTreeWidget::addCategory

(

const Category &

cat

)

Definition at line 630 of file widgetboxtreewidget.cpp.

{
    if (cat.widgetCount() == 0)
        return;
 
    const bool isScratchPad = cat.type() == Category::Scratchpad;
    WidgetBoxCategoryListView* categoryView;
    QTreeWidgetItem* cat_item;
 
    if (isScratchPad) {
        const int idx = ensureScratchpad();
        categoryView = categoryViewAt(idx);
        cat_item = topLevelItem(idx);
    } else {
        const int existingIndex = indexOfCategory(cat.name());
        if (existingIndex == -1) {
            cat_item = new QTreeWidgetItem();
            cat_item->setText(0, cat.name());
            setTopLevelRole(NORMAL_ITEM, cat_item);
            // insert before scratchpad
            const int scratchPadIndex = indexOfScratchpad();
            if (scratchPadIndex == -1) {
                addTopLevelItem(cat_item);
            } else {
                insertTopLevelItem(scratchPadIndex, cat_item);
            }
#if QT_VERSION >= QT_VERSION_CHECK(5, 13, 0)
            cat_item->setExpanded(true);
#else
            setItemExpanded(cat_item, true);
#endif
 
            categoryView = addCategoryView(cat_item, m_iconMode);
        } else {
            categoryView = categoryViewAt(existingIndex);
            cat_item = topLevelItem(existingIndex);
        }
    }
    // The same categories are read from the file $HOME, avoid duplicates
    const int widgetCount = cat.widgetCount();
    for (int i = 0; i < widgetCount; ++i) {
        const Widget w = cat.widget(i);
        if (!categoryView->containsWidget(w.name()))
            categoryView->addWidget(w, iconForWidget(w.iconName()), isScratchPad);
    }
    adjustSubListSize(cat_item);
}

References addCategoryView(), qdesigner_internal::WidgetBoxCategoryListView::addWidget(), adjustSubListSize(), categoryViewAt(), qdesigner_internal::WidgetBoxCategoryListView::containsWidget(), ensureScratchpad(), iconForWidget(), indexOfCategory(), indexOfScratchpad(), m_iconMode, NORMAL_ITEM, setTopLevelRole(), and widgetCount().

Referenced by qdesigner_internal::WidgetBox::addCategory(), addCustomCategories(), and loadContents().

Here is the call graph for this function:

addCategoryView()

WidgetBoxCategoryListView * qdesigner_internal::WidgetBoxTreeWidget::addCategoryView ( QTreeWidgetItem *  parent, bool  iconMode  )

private

Definition at line 240 of file widgetboxtreewidget.cpp.

{
    QTreeWidgetItem* embed_item = new QTreeWidgetItem(parent);
    embed_item->setFlags(Qt::ItemIsEnabled);
    WidgetBoxCategoryListView* categoryView = new WidgetBoxCategoryListView(m_core, this);
    categoryView->setViewMode(iconMode ? QListView::IconMode : QListView::ListMode);
    connect(categoryView, SIGNAL(scratchPadChanged()), this, SLOT(slotSave()));
    connect(categoryView, SIGNAL(pressed(QString, QString, QPoint)), this,
            SIGNAL(pressed(QString, QString, QPoint)));
    connect(categoryView, SIGNAL(itemRemoved()), this, SLOT(slotScratchPadItemDeleted()));
    connect(categoryView, SIGNAL(lastItemRemoved()), this, SLOT(slotLastScratchPadItemDeleted()));
    setItemWidget(embed_item, 0, categoryView);
    return categoryView;
}

References m_core, pressed(), qdesigner_internal::WidgetBoxCategoryListView::setViewMode(), slotLastScratchPadItemDeleted(), slotSave(), and slotScratchPadItemDeleted().

Referenced by addCategory(), and ensureScratchpad().

Here is the call graph for this function:

addCustomCategories()

void qdesigner_internal::WidgetBoxTreeWidget::addCustomCategories ( bool  replace )

private

Definition at line 314 of file widgetboxtreewidget.cpp.

{
    if (replace) {
        // clear out all existing custom widgets
        if (const int numTopLevels = topLevelItemCount()) {
            for (int t = 0; t < numTopLevels; ++t)
                categoryViewAt(t)->removeCustomWidgets();
        }
    }
    // re-add
    const CategoryList customList = loadCustomCategoryList();
    const CategoryList::const_iterator cend = customList.constEnd();
    for (CategoryList::const_iterator it = customList.constBegin(); it != cend; ++it)
        addCategory(*it);
}

References addCategory(), categoryViewAt(), loadCustomCategoryList(), and qdesigner_internal::WidgetBoxCategoryListView::removeCustomWidgets().

Referenced by load().

Here is the call graph for this function:

addWidget()

void qdesigner_internal::WidgetBoxTreeWidget::addWidget	(	int	cat_idx,
		const Widget &	wgt
	)

Definition at line 702 of file widgetboxtreewidget.cpp.

{
    if (cat_idx >= topLevelItemCount())
        return;
 
    QTreeWidgetItem* cat_item = topLevelItem(cat_idx);
    WidgetBoxCategoryListView* categoryView = categoryViewAt(cat_idx);
 
    const bool scratch = topLevelRole(cat_item) == SCRATCHPAD_ITEM;
    categoryView->addWidget(wgt, iconForWidget(wgt.iconName()), scratch);
    adjustSubListSize(cat_item);
}

References qdesigner_internal::WidgetBoxCategoryListView::addWidget(), adjustSubListSize(), categoryViewAt(), iconForWidget(), SCRATCHPAD_ITEM, and topLevelRole().

Referenced by qdesigner_internal::WidgetBox::addWidget().

Here is the call graph for this function:

adjustSubListSize()

void qdesigner_internal::WidgetBoxTreeWidget::adjustSubListSize ( QTreeWidgetItem *  cat_item )

private

Definition at line 585 of file widgetboxtreewidget.cpp.

{
    QTreeWidgetItem* embedItem = cat_item->child(0);
    if (embedItem == nullptr)
        return;
 
    WidgetBoxCategoryListView* list_widget =
        static_cast<WidgetBoxCategoryListView*>(itemWidget(embedItem, 0));
    list_widget->setFixedWidth(header()->width());
    list_widget->doItemsLayout();
    const int height = qMax(list_widget->contentsSize().height(), 1);
    list_widget->setFixedHeight(height);
    embedItem->setSizeHint(0, QSize(-1, height - 1));
}

Referenced by addCategory(), addWidget(), dropWidgets(), filter(), resizeEvent(), slotScratchPadItemDeleted(), and updateViewMode().

category()

WidgetBoxTreeWidget::Category qdesigner_internal::WidgetBoxTreeWidget::category

(

int

cat_idx

)

const

Definition at line 605 of file widgetboxtreewidget.cpp.

{
    if (cat_idx >= topLevelItemCount())
        return Category();
 
    QTreeWidgetItem* cat_item = topLevelItem(cat_idx);
 
    QTreeWidgetItem* embedItem = cat_item->child(0);
    WidgetBoxCategoryListView* categoryView =
        static_cast<WidgetBoxCategoryListView*>(itemWidget(embedItem, 0));
 
    Category result = categoryView->category();
    result.setName(cat_item->text(0));
 
    switch (topLevelRole(cat_item)) {
    case SCRATCHPAD_ITEM:
        result.setType(Category::Scratchpad);
        break;
    default:
        result.setType(Category::Default);
        break;
    }
    return result;
}

References qdesigner_internal::WidgetBoxCategoryListView::category(), SCRATCHPAD_ITEM, and topLevelRole().

Referenced by qdesigner_internal::WidgetBox::category(), readCategories(), save(), and writeCategories().

Here is the call graph for this function:

categoryCount()

int qdesigner_internal::WidgetBoxTreeWidget::categoryCount

(

)

const

Definition at line 600 of file widgetboxtreewidget.cpp.

{
    return topLevelItemCount();
}

Referenced by qdesigner_internal::WidgetBox::categoryCount(), ensureScratchpad(), and save().

categoryViewAt()

WidgetBoxCategoryListView * qdesigner_internal::WidgetBoxTreeWidget::categoryViewAt ( int  idx ) const

private

Definition at line 144 of file widgetboxtreewidget.cpp.

{
    WidgetBoxCategoryListView* rc = nullptr;
    if (QTreeWidgetItem* cat_item = topLevelItem(idx))
        if (QTreeWidgetItem* embedItem = cat_item->child(0))
            rc = qobject_cast<WidgetBoxCategoryListView*>(itemWidget(embedItem, 0));
    ASSERT(rc);
    return rc;
}

References ASSERT.

Referenced by addCategory(), addCustomCategories(), addWidget(), dropWidgets(), filter(), removeWidget(), updateViewMode(), widget(), and widgetCount().

contextMenuEvent()

void qdesigner_internal::WidgetBoxTreeWidget::contextMenuEvent ( QContextMenuEvent *  e )

protectedvirtual

Definition at line 800 of file widgetboxtreewidget.cpp.

{
    QTreeWidgetItem* item = itemAt(e->pos());
 
    const bool scratchpad_menu = item != nullptr && item->parent() != nullptr
                                 && topLevelRole(item->parent()) == SCRATCHPAD_ITEM;
 
    QMenu menu;
    menu.addAction("Expand all", this, SLOT(expandAll()));
    menu.addAction("Collapse all", this, SLOT(collapseAll()));
    menu.addSeparator();
 
    QAction* listModeAction = menu.addAction("List View");
    QAction* iconModeAction = menu.addAction("Icon View");
    listModeAction->setCheckable(true);
    iconModeAction->setCheckable(true);
    QActionGroup* viewModeGroup = new QActionGroup(&menu);
    viewModeGroup->addAction(listModeAction);
    viewModeGroup->addAction(iconModeAction);
    if (m_iconMode)
        iconModeAction->setChecked(true);
    else
        listModeAction->setChecked(true);
    connect(listModeAction, SIGNAL(triggered()), SLOT(slotListMode()));
    connect(iconModeAction, SIGNAL(triggered()), SLOT(slotIconMode()));
 
    if (scratchpad_menu) {
        menu.addSeparator();
        menu.addAction("Remove", itemWidget(item, 0), SLOT(removeCurrentItem()));
        if (!m_iconMode)
            menu.addAction("Edit name", itemWidget(item, 0), SLOT(editCurrentItem()));
    }
    e->accept();
    menu.exec(mapToGlobal(e->pos()));
}

References m_iconMode, SCRATCHPAD_ITEM, slotIconMode(), slotListMode(), and topLevelRole().

Here is the call graph for this function:

deleteScratchpad

void qdesigner_internal::WidgetBoxTreeWidget::deleteScratchpad ( )

privateslot

Definition at line 751 of file widgetboxtreewidget.cpp.

{
    const int idx = indexOfScratchpad();
    if (idx == -1)
        return;
    delete takeTopLevelItem(idx);
    save();
}

References indexOfScratchpad(), and save().

Referenced by slotLastScratchPadItemDeleted().

Here is the call graph for this function:

dropWidgets()

void qdesigner_internal::WidgetBoxTreeWidget::dropWidgets

(

const QList< QDesignerDnDItemInterface * > &

item_list

)

Definition at line 836 of file widgetboxtreewidget.cpp.

{
    QTreeWidgetItem* scratch_item = nullptr;
    WidgetBoxCategoryListView* categoryView = nullptr;
    bool added = false;
 
    for (QDesignerDnDItemInterface* item : item_list) {
        QWidget* w = item->widget();
        if (w == nullptr)
            continue;
 
        DomUI* dom_ui = item->domUi();
        if (dom_ui == nullptr)
            continue;
 
        const int scratch_idx = ensureScratchpad();
        scratch_item = topLevelItem(scratch_idx);
        categoryView = categoryViewAt(scratch_idx);
 
        // Temporarily remove the fake toplevel in-between
        DomWidget* fakeTopLevel = dom_ui->takeElementWidget();
        DomWidget* firstWidget = nullptr;
        if (fakeTopLevel && !fakeTopLevel->elementWidget().isEmpty()) {
            firstWidget = fakeTopLevel->elementWidget().first();
            dom_ui->setElementWidget(firstWidget);
        } else {
            dom_ui->setElementWidget(fakeTopLevel);
            continue;
        }
        // Serialize to XML
        QString xml;
        {
            QXmlStreamWriter writer(&xml);
            writer.setAutoFormatting(true);
            writer.setAutoFormattingIndent(1);
            writer.writeStartDocument();
            dom_ui->write(writer);
            writer.writeEndDocument();
        }
        // Insert fake toplevel again
        dom_ui->takeElementWidget();
        dom_ui->setElementWidget(fakeTopLevel);
 
        const Widget wgt = Widget(w->objectName(), xml);
        categoryView->addWidget(wgt, iconForWidget(wgt.iconName()), true);
#if QT_VERSION >= QT_VERSION_CHECK(5, 13, 0)
        scratch_item->setExpanded(true);
#else
        setItemExpanded(scratch_item, true);
#endif
 
        added = true;
    }
    if (added) {
        save();
        QApplication::setActiveWindow(this);
        // Is the new item visible in filtered mode?
        const WidgetBoxCategoryListView::EAccessMode am = WidgetBoxCategoryListView::FILTERED;
        if (const int count = categoryView->count(am))
            categoryView->setCurrentItem(am, count - 1);
        categoryView->adjustSize(); // XXX
        adjustSubListSize(scratch_item);
    }
}

References qdesigner_internal::WidgetBoxCategoryListView::addWidget(), adjustSubListSize(), categoryViewAt(), qdesigner_internal::WidgetBoxCategoryListView::count(), DomWidget::elementWidget(), ensureScratchpad(), qdesigner_internal::WidgetBoxCategoryListView::FILTERED, iconForWidget(), save(), qdesigner_internal::WidgetBoxCategoryListView::setCurrentItem(), DomUI::setElementWidget(), DomUI::takeElementWidget(), and DomUI::write().

Referenced by qdesigner_internal::WidgetBox::dropWidgets().

Here is the call graph for this function:

ensureScratchpad()

int qdesigner_internal::WidgetBoxTreeWidget::ensureScratchpad ( )

private

Definition at line 227 of file widgetboxtreewidget.cpp.

{
    const int existingIndex = indexOfScratchpad();
    if (existingIndex != -1)
        return existingIndex;
 
    QTreeWidgetItem* scratch_item = new QTreeWidgetItem(this);
    scratch_item->setText(0, "Scratchpad");
    setTopLevelRole(SCRATCHPAD_ITEM, scratch_item);
    addCategoryView(scratch_item, false); // Scratchpad in list mode.
    return categoryCount() - 1;
}

References addCategoryView(), categoryCount(), indexOfScratchpad(), SCRATCHPAD_ITEM, and setTopLevelRole().

Referenced by addCategory(), and dropWidgets().

Here is the call graph for this function:

fileName()

QString qdesigner_internal::WidgetBoxTreeWidget::fileName

(

)

const

Definition at line 175 of file widgetboxtreewidget.cpp.

{
    return m_file_name;
}

References m_file_name.

Referenced by qdesigner_internal::WidgetBox::fileName(), load(), readCategories(), and save().

filter

void qdesigner_internal::WidgetBoxTreeWidget::filter ( const QString &  f )

slot

Definition at line 901 of file widgetboxtreewidget.cpp.

{
    const bool empty = f.isEmpty();
    QRegExp re = empty ? QRegExp() : QRegExp(f, Qt::CaseInsensitive, QRegExp::FixedString);
    const int numTopLevels = topLevelItemCount();
    bool changed = false;
    for (int i = 0; i < numTopLevels; i++) {
        QTreeWidgetItem* tl = topLevelItem(i);
        WidgetBoxCategoryListView* categoryView = categoryViewAt(i);
        // Anything changed? -> Enable the category
        const int oldCount = categoryView->count(WidgetBoxCategoryListView::FILTERED);
        categoryView->filter(re);
        const int newCount = categoryView->count(WidgetBoxCategoryListView::FILTERED);
        if (oldCount != newCount) {
            changed = true;
            const bool categoryEnabled = newCount > 0 || empty;
            if (categoryEnabled) {
                categoryView->adjustSize();
                adjustSubListSize(tl);
            }
            setRowHidden(i, QModelIndex(), !categoryEnabled);
        }
    }
    if (changed)
        updateGeometries();
}

References adjustSubListSize(), categoryViewAt(), qdesigner_internal::WidgetBoxCategoryListView::count(), qdesigner_internal::WidgetBoxCategoryListView::filter(), and qdesigner_internal::WidgetBoxCategoryListView::FILTERED.

Here is the call graph for this function:

handleMousePress

void qdesigner_internal::WidgetBoxTreeWidget::handleMousePress ( QTreeWidgetItem *  item )

privateslot

Definition at line 209 of file widgetboxtreewidget.cpp.

{
    if (item == nullptr)
        return;
 
    if (QApplication::mouseButtons() != Qt::LeftButton)
        return;
 
    if (item->parent() == nullptr) {
#if QT_VERSION >= QT_VERSION_CHECK(5, 13, 0)
        item->setExpanded(!item->isExpanded());
#else
        setItemExpanded(item, !isItemExpanded(item));
#endif
        return;
    }
}

Referenced by WidgetBoxTreeWidget().

iconForWidget()

QIcon qdesigner_internal::WidgetBoxTreeWidget::iconForWidget

(

QString

iconName

)

const

Definition at line 131 of file widgetboxtreewidget.cpp.

{
    if (iconName.isEmpty())
        iconName = QLatin1String(qtLogoC);
 
    if (iconName.startsWith(QLatin1String(iconPrefixC))) {
        const IconCache::const_iterator it = m_pluginIcons.constFind(iconName);
        if (it != m_pluginIcons.constEnd())
            return it.value();
    }
    return createIconSet(iconName);
}

References createIconSet(), iconPrefixC, m_pluginIcons, and qtLogoC.

Referenced by addCategory(), addWidget(), dropWidgets(), and qdesigner_internal::WidgetBox::iconForWidget().

Here is the call graph for this function:

indexOfCategory()

int qdesigner_internal::WidgetBoxTreeWidget::indexOfCategory ( const QString &  name ) const

private

Definition at line 267 of file widgetboxtreewidget.cpp.

{
    const int topLevelCount = topLevelItemCount();
    for (int i = 0; i < topLevelCount; ++i) {
        if (topLevelItem(i)->text(0) == name)
            return i;
    }
    return -1;
}

References RealSpace::Particles::name().

Referenced by addCategory().

Here is the call graph for this function:

indexOfScratchpad()

int qdesigner_internal::WidgetBoxTreeWidget::indexOfScratchpad ( ) const

private

Definition at line 256 of file widgetboxtreewidget.cpp.

{
    if (const int numTopLevels = topLevelItemCount()) {
        for (int i = numTopLevels - 1; i >= 0; --i) {
            if (topLevelRole(topLevelItem(i)) == SCRATCHPAD_ITEM)
                return i;
        }
    }
    return -1;
}

References SCRATCHPAD_ITEM, and topLevelRole().

Referenced by addCategory(), deleteScratchpad(), ensureScratchpad(), and slotScratchPadItemDeleted().

Here is the call graph for this function:

load()

bool qdesigner_internal::WidgetBoxTreeWidget::load

(

QDesignerWidgetBox::LoadMode

loadMode

)

Definition at line 277 of file widgetboxtreewidget.cpp.

{
    switch (loadMode) {
    case QDesignerWidgetBox::LoadReplace:
        clear();
        break;
    case QDesignerWidgetBox::LoadCustomWidgetsOnly:
        addCustomCategories(true);
        updateGeometries();
        return true;
    default:
        break;
    }
    const QString name = fileName();
 
    QFile f(name);
    if (!f.open(QIODevice::ReadOnly)) // Might not exist at first startup
        return false;
 
    const QString contents = QString::fromUtf8(f.readAll());
    return loadContents(contents);
}

References addCustomCategories(), fileName(), loadContents(), qdesigner_internal::QDesignerWidgetBox::LoadCustomWidgetsOnly, qdesigner_internal::QDesignerWidgetBox::LoadReplace, and RealSpace::Particles::name().

Referenced by qdesigner_internal::WidgetBox::load().

Here is the call graph for this function:

loadContents()

bool qdesigner_internal::WidgetBoxTreeWidget::loadContents

(

const QString &

contents

)

Definition at line 300 of file widgetboxtreewidget.cpp.

{
    QString errorMessage;
    CategoryList cat_list;
    if (!readCategories(m_file_name, contents, &cat_list, &errorMessage)) {
        qdesigner_internal::designerWarning(errorMessage);
        return false;
    }
    for (const Category& cat : cat_list)
        addCategory(cat);
 
    return true;
}

References addCategory(), qdesigner_internal::designerWarning(), m_file_name, and readCategories().

Referenced by load(), and qdesigner_internal::WidgetBox::loadContents().

Here is the call graph for this function:

loadCustomCategoryList()

WidgetBoxTreeWidget::CategoryList qdesigner_internal::WidgetBoxTreeWidget::loadCustomCategoryList ( ) const

private

Definition at line 576 of file widgetboxtreewidget.cpp.

{
    CategoryList result;
 
    std::cout << "WidgetBoxTreeWidget::loadCustomCategoryList() -> XXX Not implemented."
              << std::endl;
    return result;
}

Referenced by addCustomCategories().

pressed

void qdesigner_internal::WidgetBoxTreeWidget::pressed ( const QString  name, const QString  dom_xml, const QPoint &  global_mouse_pos  )

signal

Referenced by addCategoryView().

readCategories()

bool qdesigner_internal::WidgetBoxTreeWidget::readCategories ( const QString &  fileName, const QString &  xml, CategoryList *  cats, QString *  errorMessage  )

staticprivate

Definition at line 337 of file widgetboxtreewidget.cpp.

{
    // Read widget box XML:
    //
    //<widgetbox version="4.5">
    // <category name="Layouts">
    //  <categoryentry name="Vertical Layout" icon="win/editvlayout.png" type="default">
    //   <widget class="QListWidget" ...>
    // ...
 
    QXmlStreamReader reader(contents);
 
    // Entries of category with name="invisible" should be ignored
    bool ignoreEntries = false;
 
    while (!reader.atEnd()) {
        switch (reader.readNext()) {
        case QXmlStreamReader::StartElement: {
            const QStringRef tag = reader.name();
            if (tag == QLatin1String(widgetBoxRootElementC)) {
                //<widgetbox version="4.5">
                continue;
            }
            if (tag == QLatin1String(categoryElementC)) {
                // <category name="Layouts">
                const QXmlStreamAttributes attributes = reader.attributes();
                const QString categoryName =
                    attributes.value(QLatin1String(nameAttributeC)).toString();
                if (categoryName == QLatin1String(invisibleNameC)) {
                    ignoreEntries = true;
                } else {
                    Category category(categoryName);
                    if (attributes.value(QLatin1String(typeAttributeC))
                        == QLatin1String(scratchPadValueC))
                        category.setType(Category::Scratchpad);
                    cats->push_back(category);
                }
                continue;
            }
            if (tag == QLatin1String(categoryEntryElementC)) {
                //  <categoryentry name="Vertical Layout" icon="win/editvlayout.png" type="default">
                if (!ignoreEntries) {
                    QXmlStreamAttributes attr = reader.attributes();
                    const QString widgetName = attr.value(QLatin1String(nameAttributeC)).toString();
                    const QString widgetIcon = attr.value(QLatin1String(iconAttributeC)).toString();
                    const WidgetBoxTreeWidget::Widget::Type widgetType =
                        attr.value(QLatin1String(typeAttributeC)).toString()
                                == QLatin1String(customValueC)
                            ? WidgetBoxTreeWidget::Widget::Custom
                            : WidgetBoxTreeWidget::Widget::Default;
 
                    Widget w;
                    w.setName(widgetName);
                    w.setIconName(widgetIcon);
                    w.setType(widgetType);
                    if (!readWidget(&w, contents, reader))
                        continue;
 
                    cats->back().addWidget(w);
                } // ignoreEntries
                continue;
            }
            break;
        }
        case QXmlStreamReader::EndElement: {
            const QStringRef tag = reader.name();
            if (tag == QLatin1String(widgetBoxRootElementC)) {
                continue;
            }
            if (tag == QLatin1String(categoryElementC)) {
                ignoreEntries = false;
                continue;
            }
            if (tag == QLatin1String(categoryEntryElementC)) {
                continue;
            }
            break;
        }
        default:
            break;
        }
    }
 
    if (reader.hasError()) {
        *errorMessage = msgXmlError(fileName, reader);
        return false;
    }
 
    return true;
}

References category(), categoryElementC, categoryEntryElementC, customValueC, fileName(), iconAttributeC, invisibleNameC, qdesigner_internal::msgXmlError(), nameAttributeC, readWidget(), scratchPadValueC, typeAttributeC, and widgetBoxRootElementC.

Referenced by loadContents().

Here is the call graph for this function:

readWidget()

bool qdesigner_internal::WidgetBoxTreeWidget::readWidget ( Widget *  w, const QString &  xml, QXmlStreamReader &  r  )

staticprivate

Read out a widget within a category. This can either be enclosed in a <ui> element or a (legacy) <widget> element which may contain nested <widget> elements.

Examples:

<ui language="c++"> <widget class="MultiPageWidget" name="multipagewidget"> ... </widget> <customwidgets>...</customwidgets> <ui>

or

<widget> <widget> ... </widget> ... <widget>

Returns true on success, false if end was reached or an error has been encountered in which case the reader has its error flag set. If successful, the current item of the reader will be the closing element (</ui> or </widget>)

Definition at line 452 of file widgetboxtreewidget.cpp.

{
    qint64 startTagPosition = 0, endTagPosition = 0;
 
    int nesting = 0;
    bool endEncountered = false;
    bool parsedWidgetTag = false;
    QString outmostElement;
    while (!endEncountered) {
        const qint64 currentPosition = r.characterOffset();
        switch (r.readNext()) {
        case QXmlStreamReader::StartElement:
            if (nesting++ == 0) {
                // First element must be <ui> or (legacy) <widget>
                const QStringRef name = r.name();
                if (name == QLatin1String(uiElementC)) {
                    startTagPosition = currentPosition;
                } else {
                    if (name == QLatin1String(widgetElementC)) {
                        startTagPosition = currentPosition;
                        parsedWidgetTag = true;
                    } else {
                        r.raiseError(QString("Unexpected element <%1> encountered when "
                                             "parsing for <widget> or <ui>")
                                         .arg(name.toString()));
                        return false;
                    }
                }
            } else {
                // We are within <ui> looking for the first <widget> tag
                if (!parsedWidgetTag && r.name() == QLatin1String(widgetElementC)) {
                    parsedWidgetTag = true;
                }
            }
            break;
        case QXmlStreamReader::EndElement:
            // Reached end of widget?
            if (--nesting == 0) {
                endTagPosition = r.characterOffset();
                endEncountered = true;
            }
            break;
        case QXmlStreamReader::EndDocument:
            r.raiseError("Unexpected end of file encountered when parsing widgets.");
            return false;
        case QXmlStreamReader::Invalid:
            return false;
        default:
            break;
        }
    }
    if (!parsedWidgetTag) {
        r.raiseError("A widget element could not be found.");
        return false;
    }
    // Oddity: Startposition is 1 off
    QString widgetXml = xml.mid(startTagPosition, endTagPosition - startTagPosition);
    const QChar lessThan = QLatin1Char('<');
    if (!widgetXml.startsWith(lessThan))
        widgetXml.prepend(lessThan);
    w->setDomXml(widgetXml);
    return true;
}

References RealSpace::Particles::name(), uiElementC, and widgetElementC.

Referenced by readCategories().

Here is the call graph for this function:

removeCategory()

void qdesigner_internal::WidgetBoxTreeWidget::removeCategory

(

int

cat_idx

)

Definition at line 678 of file widgetboxtreewidget.cpp.

{
    if (cat_idx >= topLevelItemCount())
        return;
    delete takeTopLevelItem(cat_idx);
}

Referenced by qdesigner_internal::WidgetBox::removeCategory().

removeWidget()

void qdesigner_internal::WidgetBoxTreeWidget::removeWidget	(	int	cat_idx,
		int	wgt_idx
	)

Definition at line 715 of file widgetboxtreewidget.cpp.

{
    if (cat_idx >= topLevelItemCount())
        return;
 
    WidgetBoxCategoryListView* categoryView = categoryViewAt(cat_idx);
 
    // SDK functions want unfiltered access
    const WidgetBoxCategoryListView::EAccessMode am = WidgetBoxCategoryListView::UNFILTERED;
    if (wgt_idx >= categoryView->count(am))
        return;
 
    categoryView->removeRow(am, wgt_idx);
}

References categoryViewAt(), qdesigner_internal::WidgetBoxCategoryListView::count(), qdesigner_internal::WidgetBoxCategoryListView::removeRow(), and qdesigner_internal::WidgetBoxCategoryListView::UNFILTERED.

Referenced by qdesigner_internal::WidgetBox::removeWidget().

Here is the call graph for this function:

resizeEvent()

void qdesigner_internal::WidgetBoxTreeWidget::resizeEvent ( QResizeEvent *  e )

protectedvirtual

Definition at line 791 of file widgetboxtreewidget.cpp.

{
    QTreeWidget::resizeEvent(e);
    if (const int numTopLevels = topLevelItemCount()) {
        for (int i = numTopLevels - 1; i >= 0; --i)
            adjustSubListSize(topLevelItem(i));
    }
}

References adjustSubListSize().

Here is the call graph for this function:

restoreExpandedState()

void qdesigner_internal::WidgetBoxTreeWidget::restoreExpandedState ( )

private

Definition at line 159 of file widgetboxtreewidget.cpp.

{
    std::cout << "WidgetBoxTreeWidget::restoreExpandedState() -> XXX Not implemented." << std::endl;
    return;
}

save()

bool qdesigner_internal::WidgetBoxTreeWidget::save

(

)

Definition at line 180 of file widgetboxtreewidget.cpp.

{
    if (fileName().isEmpty())
        return false;
 
    QFile file(fileName());
    if (!file.open(QIODevice::WriteOnly))
        return false;
 
    CategoryList cat_list;
    const int count = categoryCount();
    for (int i = 0; i < count; ++i)
        cat_list.append(category(i));
 
    QXmlStreamWriter writer(&file);
    writer.setAutoFormatting(true);
    writer.setAutoFormattingIndent(1);
    writer.writeStartDocument();
    writeCategories(writer, cat_list);
    writer.writeEndDocument();
 
    return true;
}

References category(), categoryCount(), fileName(), and writeCategories().

Referenced by deleteScratchpad(), dropWidgets(), qdesigner_internal::WidgetBox::save(), slotSave(), and slotScratchPadItemDeleted().

Here is the call graph for this function:

saveExpandedState()

void qdesigner_internal::WidgetBoxTreeWidget::saveExpandedState ( ) const

private

Definition at line 154 of file widgetboxtreewidget.cpp.

{
    return;
}

Referenced by ~WidgetBoxTreeWidget().

setFileName()

void qdesigner_internal::WidgetBoxTreeWidget::setFileName

(

const QString &

file_name

)

Definition at line 170 of file widgetboxtreewidget.cpp.

{
    m_file_name = file_name;
}

References m_file_name.

Referenced by qdesigner_internal::WidgetBox::setFileName().

slotIconMode

void qdesigner_internal::WidgetBoxTreeWidget::slotIconMode ( )

privateslot

Definition at line 766 of file widgetboxtreewidget.cpp.

{
    m_iconMode = true;
    updateViewMode();
}

References m_iconMode, and updateViewMode().

Referenced by contextMenuEvent().

Here is the call graph for this function:

slotLastScratchPadItemDeleted

void qdesigner_internal::WidgetBoxTreeWidget::slotLastScratchPadItemDeleted ( )

privateslot

Definition at line 738 of file widgetboxtreewidget.cpp.

{
    // Remove the scratchpad in the next idle loop
    if (!m_scratchPadDeleteTimer) {
        m_scratchPadDeleteTimer = new QTimer(this);
        m_scratchPadDeleteTimer->setSingleShot(true);
        m_scratchPadDeleteTimer->setInterval(0);
        connect(m_scratchPadDeleteTimer, SIGNAL(timeout()), this, SLOT(deleteScratchpad()));
    }
    if (!m_scratchPadDeleteTimer->isActive())
        m_scratchPadDeleteTimer->start();
}

References deleteScratchpad(), and m_scratchPadDeleteTimer.

Referenced by addCategoryView().

Here is the call graph for this function:

slotListMode

void qdesigner_internal::WidgetBoxTreeWidget::slotListMode ( )

privateslot

Definition at line 760 of file widgetboxtreewidget.cpp.

{
    m_iconMode = false;
    updateViewMode();
}

References m_iconMode, and updateViewMode().

Referenced by contextMenuEvent().

Here is the call graph for this function:

slotSave

void qdesigner_internal::WidgetBoxTreeWidget::slotSave ( )

privateslot

Definition at line 204 of file widgetboxtreewidget.cpp.

{
    save();
}

References save().

Referenced by addCategoryView().

Here is the call graph for this function:

slotScratchPadItemDeleted

void qdesigner_internal::WidgetBoxTreeWidget::slotScratchPadItemDeleted ( )

privateslot

Definition at line 730 of file widgetboxtreewidget.cpp.

{
    const int scratch_idx = indexOfScratchpad();
    QTreeWidgetItem* scratch_item = topLevelItem(scratch_idx);
    adjustSubListSize(scratch_item);
    save();
}

References adjustSubListSize(), indexOfScratchpad(), and save().

Referenced by addCategoryView().

Here is the call graph for this function:

updateViewMode()

void qdesigner_internal::WidgetBoxTreeWidget::updateViewMode ( )

private

Definition at line 772 of file widgetboxtreewidget.cpp.

{
    if (const int numTopLevels = topLevelItemCount()) {
        for (int i = numTopLevels - 1; i >= 0; --i) {
            QTreeWidgetItem* topLevel = topLevelItem(i);
            // Scratch pad stays in list mode.
            const QListView::ViewMode viewMode =
                m_iconMode && (topLevelRole(topLevel) != SCRATCHPAD_ITEM) ? QListView::IconMode
                                                                          : QListView::ListMode;
            WidgetBoxCategoryListView* categoryView = categoryViewAt(i);
            if (viewMode != categoryView->viewMode()) {
                categoryView->setViewMode(viewMode);
                adjustSubListSize(topLevelItem(i));
            }
        }
    }
    updateGeometries();
}

References adjustSubListSize(), categoryViewAt(), m_iconMode, SCRATCHPAD_ITEM, and topLevelRole().

Referenced by slotIconMode(), and slotListMode().

Here is the call graph for this function:

widget()

WidgetBoxTreeWidget::Widget qdesigner_internal::WidgetBoxTreeWidget::widget	(	int	cat_idx,
		int	wgt_idx
	)		const

Definition at line 693 of file widgetboxtreewidget.cpp.

{
    if (cat_idx >= topLevelItemCount())
        return Widget();
    // SDK functions want unfiltered access
    WidgetBoxCategoryListView* categoryView = categoryViewAt(cat_idx);
    return categoryView->widgetAt(WidgetBoxCategoryListView::UNFILTERED, wgt_idx);
}

References categoryViewAt(), qdesigner_internal::WidgetBoxCategoryListView::UNFILTERED, and qdesigner_internal::WidgetBoxCategoryListView::widgetAt().

Referenced by qdesigner_internal::WidgetBox::widget().

Here is the call graph for this function:

widgetCount()

int qdesigner_internal::WidgetBoxTreeWidget::widgetCount

(

int

cat_idx

)

const

Definition at line 685 of file widgetboxtreewidget.cpp.

{
    if (cat_idx >= topLevelItemCount())
        return 0;
    // SDK functions want unfiltered access
    return categoryViewAt(cat_idx)->count(WidgetBoxCategoryListView::UNFILTERED);
}

References categoryViewAt(), qdesigner_internal::WidgetBoxCategoryListView::count(), and qdesigner_internal::WidgetBoxCategoryListView::UNFILTERED.

Referenced by addCategory(), qdesigner_internal::WidgetBox::widgetCount(), and writeCategories().

Here is the call graph for this function:

writeCategories()

void qdesigner_internal::WidgetBoxTreeWidget::writeCategories ( QXmlStreamWriter &  writer, const CategoryList &  cat_list  ) const

private

Definition at line 516 of file widgetboxtreewidget.cpp.

{
    const QString widgetbox = QLatin1String(widgetBoxRootElementC);
    const QString name = QLatin1String(nameAttributeC);
    const QString type = QLatin1String(typeAttributeC);
    const QString icon = QLatin1String(iconAttributeC);
    const QString defaultType = QLatin1String(defaultTypeValueC);
    const QString category = QLatin1String(categoryElementC);
    const QString categoryEntry = QLatin1String(categoryEntryElementC);
    const QString iconPrefix = QLatin1String(iconPrefixC);
    const QString widgetTag = QLatin1String(widgetElementC);
 
    //
    // <widgetbox>
    //   <category name="Layouts">
    //     <categoryEntry name="Vertical Layout" type="default" icon="win/editvlayout.png">
    //       <ui>
    //        ...
    //       </ui>
    //     </categoryEntry>
    //     ...
    //   </category>
    //   ...
    // </widgetbox>
    //
 
    writer.writeStartElement(widgetbox);
 
    for (const Category& cat : cat_list) {
        writer.writeStartElement(category);
        writer.writeAttribute(name, cat.name());
        if (cat.type() == Category::Scratchpad)
            writer.writeAttribute(type, QLatin1String(scratchPadValueC));
 
        const int widgetCount = cat.widgetCount();
        for (int i = 0; i < widgetCount; ++i) {
            const Widget wgt = cat.widget(i);
            if (wgt.type() == Widget::Custom)
                continue;
 
            writer.writeStartElement(categoryEntry);
            writer.writeAttribute(name, wgt.name());
            if (!wgt.iconName().startsWith(iconPrefix))
                writer.writeAttribute(icon, wgt.iconName());
            writer.writeAttribute(type, defaultType);
 
            const DomUI* domUI = QDesignerWidgetBox::xmlToUi(
                wgt.name(), WidgetBoxCategoryListView::widgetDomXml(wgt), false);
            if (domUI) {
                domUI->write(writer);
                delete domUI;
            }
            writer.writeEndElement(); // categoryEntry
        }
        writer.writeEndElement(); // categoryEntry
    }
    writer.writeEndElement(); // widgetBox
}

References category(), categoryElementC, categoryEntryElementC, defaultTypeValueC, iconAttributeC, iconPrefixC, RealSpace::Particles::name(), nameAttributeC, scratchPadValueC, typeAttributeC, widgetBoxRootElementC, widgetCount(), qdesigner_internal::WidgetBoxCategoryListView::widgetDomXml(), widgetElementC, DomUI::write(), and qdesigner_internal::QDesignerWidgetBox::xmlToUi().

Referenced by save().

Here is the call graph for this function:

Member Data Documentation

m_core

SampleDesignerInterface* qdesigner_internal::WidgetBoxTreeWidget::m_core

private

Definition at line 139 of file widgetboxtreewidget.h.

Referenced by addCategoryView().

m_file_name

QString qdesigner_internal::WidgetBoxTreeWidget::m_file_name

private

Definition at line 140 of file widgetboxtreewidget.h.

Referenced by fileName(), loadContents(), and setFileName().

m_iconMode

bool qdesigner_internal::WidgetBoxTreeWidget::m_iconMode

private

Definition at line 143 of file widgetboxtreewidget.h.

Referenced by addCategory(), contextMenuEvent(), slotIconMode(), slotListMode(), and updateViewMode().

m_pluginIcons

IconCache qdesigner_internal::WidgetBoxTreeWidget::m_pluginIcons

mutableprivate

Definition at line 142 of file widgetboxtreewidget.h.

Referenced by iconForWidget().

m_scratchPadDeleteTimer

QTimer* qdesigner_internal::WidgetBoxTreeWidget::m_scratchPadDeleteTimer

private

Definition at line 144 of file widgetboxtreewidget.h.

Referenced by slotLastScratchPadItemDeleted().

---

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

• /home/www/ba/GUI/coregui/Views/widgetbox/widgetboxtreewidget.h
• /home/www/ba/GUI/coregui/Views/widgetbox/widgetboxtreewidget.cpp