blob: e56729a6fd7293360e985bcbabb53d9cf759c5b7 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
|
/*
This file is part of the KDE project
SPDX-FileCopyrightText: 2022 Felix Ernst <[email protected]>
SPDX-License-Identifier: LGPL-2.1-only OR LGPL-3.0-only OR LicenseRef-KDE-Accepted-LGPL
*/
#ifndef ACTIONWITHWIDGET_H
#define ACTIONWITHWIDGET_H
#include <QAction>
#include <QPointer>
#include <QWidget>
class QAbstractButton;
namespace SelectionMode
{
/**
* @brief Small wrapper/helper class that contains an action and its widget.
*
* This class takes neither the responsibility for deleting its action() nor its widget().
*
* This class is only used from BottomBarContentsContainer currently.
* @see BottomBarContentsContainer
*/
class ActionWithWidget
{
public:
ActionWithWidget(QAction *action);
/**
* Connect @p action and @p button using copyActionDataToButton() and
* wraps the two together in a ActionWithWidget object.
* ActionWithWidget doesn't take any ownership over the parameters.
*
* @see copyActionDataToButton()
*
* @param button the button to be styled and used to fit the @p action.
*/
ActionWithWidget(QAction *action, QAbstractButton *button);
/** @returns the action of this object. */
inline QAction *action()
{
Q_CHECK_PTR(m_action);
return m_action;
};
/** @returns the widget of this object. */
inline QWidget *widget()
{
return m_widget;
}
/**
* @returns a widget with parent @p parent for the action() of this object.
*
* For most actions some sort of button will be returned. For separators a vertical line will be returned.
* If this ActionWithWidget already has a widget(), this method will crash.
*/
QWidget *newWidget(QWidget *parent);
/** returns true if the widget exists and is visible. false otherwise. */
inline bool isWidgetVisible() const
{
return m_widget && m_widget->isVisible();
};
private:
QPointer<QAction> m_action;
QPointer<QWidget> m_widget;
};
/**
* A small helper method.
* @return a button with the correct styling for the general mode of the BottomBarContentsContainer which can be added to its layout.
*/
QAbstractButton *newButtonForAction(QAction *action, QWidget *parent);
/**
* Normally, if one wants a button that represents a QAction one would use a QToolButton
* and simply call QToolButton::setDefaultAction(action). However if one does this, all
* control over the style, text, etc. of the button is forfeited. One can't for example
* have text on the button then, if the action has a low QAction::priority().
*
* This method styles the @p button based on the @p action without using QToolButton::setDefaultAction().
*
* Another reason why this is necessary is because the actions have application-wide scope while
* these buttons belong to one ViewContainer.
*/
void copyActionDataToButton(QAbstractButton *button, QAction *action);
}
#endif // ACTIONWITHWIDGET_H
|
