vasilito
1b5c19b22a
Kirigami: remove stub .cpp, add Qt platform integration headers for QML gate. Matches KDE src/pattern for direct header-only builds. Cookbook: add --no-backup-if-mismatch to patch invocation (fetch.rs). Kernel: consolidate patch chain, add debug-scheme-serial-fix. Docs: archive old audit reports, add CHANGELOG and hardware validation matrix. Update AGENTS.md with Linux reference source policy. Scripts: add test-network-qemu.sh, test-storage-qemu.sh. .gitignore: add local/reference/ exclusion.
246 lines
8.8 KiB
C++
246 lines
8.8 KiB
C++
/*
|
|
* SPDX-FileCopyrightText: 2020 Arjen Hiemstra <ahiemstra@heimr.nl>
|
|
*
|
|
* SPDX-License-Identifier: LGPL-2.1-only OR LGPL-3.0-only OR LicenseRef-KDE-Accepted-LGPL
|
|
*/
|
|
|
|
#ifndef TOOLBARLAYOUT_H
|
|
#define TOOLBARLAYOUT_H
|
|
|
|
#include <QQuickItem>
|
|
#include <memory>
|
|
|
|
class ToolBarLayoutPrivate;
|
|
|
|
/**
|
|
* Attached property for ToolBarLayout delegates.
|
|
*/
|
|
class ToolBarLayoutAttached : public QObject
|
|
{
|
|
Q_OBJECT
|
|
/**
|
|
* The action this delegate was created for.
|
|
*/
|
|
Q_PROPERTY(QObject *action READ action CONSTANT FINAL)
|
|
public:
|
|
ToolBarLayoutAttached(QObject *parent = nullptr);
|
|
|
|
QObject *action() const;
|
|
void setAction(QObject *action);
|
|
|
|
private:
|
|
QObject *m_action = nullptr;
|
|
};
|
|
|
|
/**
|
|
* An item that creates delegates for actions and lays them out in a row.
|
|
*
|
|
* This effectively combines RowLayout and Repeater in a single item, with the
|
|
* addition of some extra performance enhancing tweaks. It will create instances
|
|
* of ::fullDelegate and ::itemDelegate for each action in ::actions . These are
|
|
* then positioned horizontally. Any action that ends up being placed outside
|
|
* the width of the item is hidden and will be part of ::hiddenActions.
|
|
*
|
|
* The items created as delegates are always created asynchronously, to avoid
|
|
* creation lag spikes. Each delegate has access to the action it was created
|
|
* for through the ToolBarLayoutAttached attached property.
|
|
*/
|
|
class ToolBarLayout : public QQuickItem
|
|
{
|
|
Q_OBJECT
|
|
QML_ELEMENT
|
|
QML_ATTACHED(ToolBarLayoutAttached)
|
|
/**
|
|
* The actions this layout should create delegates for.
|
|
*/
|
|
Q_PROPERTY(QQmlListProperty<QObject> actions READ actionsProperty NOTIFY actionsChanged FINAL)
|
|
/**
|
|
* A list of actions that do not fit in the current view and are thus hidden.
|
|
*/
|
|
Q_PROPERTY(QList<QObject *> hiddenActions READ hiddenActions NOTIFY hiddenActionsChanged FINAL)
|
|
/**
|
|
* A component that is used to create full-size delegates from.
|
|
*
|
|
* Each delegate has three states, it can be full-size, icon-only or hidden.
|
|
* By default, the full-size delegate is used. When the action has the
|
|
* DisplayHint::IconOnly hint set, it will always use the iconDelegate. When
|
|
* it has the DisplayHint::KeepVisible hint set, it will use the full-size
|
|
* delegate when it fits. If not, it will use the iconDelegate, unless even
|
|
* that does not fit, in which case it will still be hidden.
|
|
*/
|
|
Q_PROPERTY(QQmlComponent *fullDelegate READ fullDelegate WRITE setFullDelegate NOTIFY fullDelegateChanged FINAL)
|
|
/**
|
|
* A component that is used to create icon-only delegates from.
|
|
*
|
|
* \sa fullDelegate
|
|
*/
|
|
Q_PROPERTY(QQmlComponent *iconDelegate READ iconDelegate WRITE setIconDelegate NOTIFY iconDelegateChanged FINAL)
|
|
/**
|
|
* A component that is used to create separator delegates from.
|
|
*
|
|
* \since 6.7
|
|
*
|
|
* \sa fullDelegate
|
|
*/
|
|
Q_PROPERTY(QQmlComponent *separatorDelegate READ separatorDelegate WRITE setSeparatorDelegate NOTIFY separatorDelegateChanged FINAL)
|
|
/**
|
|
* A component that is used to create the "more button" item from.
|
|
*
|
|
* The more button is shown when there are actions that do not fit the
|
|
* current view. It is intended to have functionality to show these hidden
|
|
* actions, like popup a menu with them showing.
|
|
*/
|
|
Q_PROPERTY(QQmlComponent *moreButton READ moreButton WRITE setMoreButton NOTIFY moreButtonChanged FINAL)
|
|
/**
|
|
* The amount of spacing between individual delegates.
|
|
*/
|
|
Q_PROPERTY(qreal spacing READ spacing WRITE setSpacing NOTIFY spacingChanged FINAL)
|
|
/**
|
|
* How to align the delegates within this layout.
|
|
*
|
|
* When there is more space available than required by the visible delegates,
|
|
* we need to determine how to place the delegates. This property determines
|
|
* how to do that. Note that the moreButton, if visible, will always be
|
|
* placed at the end of the layout.
|
|
*/
|
|
Q_PROPERTY(Qt::Alignment alignment READ alignment WRITE setAlignment NOTIFY alignmentChanged FINAL)
|
|
/**
|
|
* The combined width of visible delegates in this layout.
|
|
*/
|
|
Q_PROPERTY(qreal visibleWidth READ visibleWidth NOTIFY visibleWidthChanged FINAL)
|
|
/**
|
|
* The minimum width this layout can have.
|
|
*
|
|
* This is equal to the width of the moreButton.
|
|
*/
|
|
Q_PROPERTY(qreal minimumWidth READ minimumWidth NOTIFY minimumWidthChanged FINAL)
|
|
/**
|
|
* Which direction to layout in.
|
|
*
|
|
* This is primarily intended to support right-to-left layouts. When set to
|
|
* LeftToRight, delegates will be layout with the first item on the left and
|
|
* following items to the right of that. The more button will be placed at
|
|
* the rightmost position. Alignment flags work normally.
|
|
*
|
|
* When set to RightToLeft, delegates will be layout with the first item on
|
|
* the right and following items to the left of that. The more button will
|
|
* be placed at the leftmost position. Alignment flags are inverted, so
|
|
* AlignLeft will align items to the right, and vice-versa.
|
|
*/
|
|
Q_PROPERTY(Qt::LayoutDirection layoutDirection READ layoutDirection WRITE setLayoutDirection NOTIFY layoutDirectionChanged FINAL)
|
|
/**
|
|
* How to handle items that do not match the toolbar's height.
|
|
*
|
|
* When toolbar items do not match the height of the toolbar, there are
|
|
* several ways we can deal with this. This property sets the preferred way.
|
|
*
|
|
* The default is HeightMode::ConstrainIfLarger .
|
|
*
|
|
* \sa HeightMode
|
|
*/
|
|
Q_PROPERTY(HeightMode heightMode READ heightMode WRITE setHeightMode NOTIFY heightModeChanged FINAL)
|
|
|
|
public:
|
|
using ActionsProperty = QQmlListProperty<QObject>;
|
|
|
|
/**
|
|
* An enum describing several modes that can be used to deal with items with
|
|
* a height that does not match the toolbar's height.
|
|
*/
|
|
enum HeightMode {
|
|
AlwaysCenter, ///< Always center items, allowing them to go outside the bounds of the layout if they are larger.
|
|
AlwaysFill, ///< Always match the height of the layout. Larger items will be reduced in height, smaller items will be increased.
|
|
ConstrainIfLarger, ///< If the item is larger than the toolbar, reduce its height. Otherwise center it in the toolbar.
|
|
};
|
|
Q_ENUM(HeightMode)
|
|
|
|
ToolBarLayout(QQuickItem *parent = nullptr);
|
|
~ToolBarLayout() override;
|
|
|
|
ActionsProperty actionsProperty() const;
|
|
/**
|
|
* Add an action to the list of actions.
|
|
*
|
|
* \param action The action to add.
|
|
*/
|
|
void addAction(QObject *action);
|
|
/**
|
|
* Remove an action from the list of actions.
|
|
*
|
|
* \param action The action to remove.
|
|
*/
|
|
void removeAction(QObject *action);
|
|
/**
|
|
* Clear the list of actions.
|
|
*/
|
|
void clearActions();
|
|
Q_SIGNAL void actionsChanged();
|
|
|
|
QList<QObject *> hiddenActions() const;
|
|
Q_SIGNAL void hiddenActionsChanged();
|
|
|
|
QQmlComponent *fullDelegate() const;
|
|
void setFullDelegate(QQmlComponent *newFullDelegate);
|
|
Q_SIGNAL void fullDelegateChanged();
|
|
|
|
QQmlComponent *iconDelegate() const;
|
|
void setIconDelegate(QQmlComponent *newIconDelegate);
|
|
Q_SIGNAL void iconDelegateChanged();
|
|
|
|
QQmlComponent *separatorDelegate() const;
|
|
void setSeparatorDelegate(QQmlComponent *newSeparatorDelegate);
|
|
Q_SIGNAL void separatorDelegateChanged();
|
|
|
|
QQmlComponent *moreButton() const;
|
|
void setMoreButton(QQmlComponent *newMoreButton);
|
|
Q_SIGNAL void moreButtonChanged();
|
|
|
|
qreal spacing() const;
|
|
void setSpacing(qreal newSpacing);
|
|
Q_SIGNAL void spacingChanged();
|
|
|
|
Qt::Alignment alignment() const;
|
|
void setAlignment(Qt::Alignment newAlignment);
|
|
Q_SIGNAL void alignmentChanged();
|
|
|
|
qreal visibleWidth() const;
|
|
Q_SIGNAL void visibleWidthChanged();
|
|
|
|
qreal minimumWidth() const;
|
|
Q_SIGNAL void minimumWidthChanged();
|
|
|
|
Qt::LayoutDirection layoutDirection() const;
|
|
void setLayoutDirection(Qt::LayoutDirection &newLayoutDirection);
|
|
Q_SIGNAL void layoutDirectionChanged();
|
|
|
|
HeightMode heightMode() const;
|
|
void setHeightMode(HeightMode newHeightMode);
|
|
Q_SIGNAL void heightModeChanged();
|
|
|
|
/**
|
|
* Queue a relayout of this layout.
|
|
*
|
|
* \note The layouting happens during the next scene graph polishing phase.
|
|
*/
|
|
Q_SLOT void relayout();
|
|
|
|
static ToolBarLayoutAttached *qmlAttachedProperties(QObject *object)
|
|
{
|
|
return new ToolBarLayoutAttached(object);
|
|
}
|
|
|
|
protected:
|
|
void componentComplete() override;
|
|
void geometryChange(const QRectF &newGeometry, const QRectF &oldGeometry) override;
|
|
void itemChange(QQuickItem::ItemChange change, const QQuickItem::ItemChangeData &data) override;
|
|
void updatePolish() override;
|
|
|
|
private:
|
|
friend class ToolBarLayoutPrivate;
|
|
const std::unique_ptr<ToolBarLayoutPrivate> d;
|
|
};
|
|
|
|
QML_DECLARE_TYPEINFO(ToolBarLayout, QML_HAS_ATTACHED_PROPERTIES)
|
|
|
|
#endif // TOOLBARLAYOUT_H
|