org::kde::kirigami::ActionToolBar

Properties | |
alias | actions |
alias | alignment |
int | display |
bool | flat |
alias | heightMode |
list< QtObject > | hiddenActions |
alias | maximumContentWidth |
string | overflowIconName |
int | position |
alias | visibleWidth |
Detailed Description
A toolbar built out of a list of actions.
The default representation for visible actions is a QtQuick.Controls.ToolButton, but it can be changed by setting Action::displayComponent to a different component.
The ActionToolBar component will try to display as many action delegates as possible but it will place those that do not fit into an overflow menu.
How actions are displayed can be changed by setting the displayHint
in an action. For example, when setting it to DisplayHint.KeepVisible
, it will try to keep that action in view as long as possible, using an icon-only button if the full-sized delegate does not fit.
- Since
- org.kde.kirigami 2.5
Definition at line 32 of file ActionToolBar.qml.
Property Documentation
◆ actions
|
read |
This property holds a list of visible actions.
The ActionToolBar will try to display as many actions as possible. Those that do not fit go into a overflow menu.
Definition at line 43 of file ActionToolBar.qml.
◆ alignment
|
read |
This property holds the alignment of the buttons.
When there is more space available than required by the visible delegates, we need to determine how to place the delegates.
When there is more space available than required by the visible action delegates, we need to determine where to position them.
default: Qt.AlignRight
- See also
- Qt::Alignment
Definition at line 91 of file ActionToolBar.qml.
◆ display
|
read |
This property determines how the icon and text are displayed within the button.
The following values are allowed:
Button.IconOnly
Button.TextOnly
Button.TextBesideIcon
Button.TextUnderIcon
default: Controls.Button.TextBesideIcon
- See also
- AbstractButton.display
Definition at line 76 of file ActionToolBar.qml.
◆ flat
|
read |
This property holds whether the buttons will have a flat appearance.
default: true
Definition at line 62 of file ActionToolBar.qml.
◆ heightMode
|
read |
This property sets the handling method for 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 following values are allowed:
HeightMode.AlwaysCenter
HeightMode.AlwaysFill
HeightMode.ConstrainIfLarger
default: HeightMode::ConstrainIfLarger
Definition at line 147 of file ActionToolBar.qml.
◆ hiddenActions
|
read |
This property holds a list of hidden actions.
These actions will always be displayed in the overflow menu, even if there is enough space.
- Deprecated:
- Since 2.14, set
displayHint
toDisplayHint.AlwaysHide
in actions instead.
- Since
- org.kde.kirigami 2.6
Definition at line 53 of file ActionToolBar.qml.
◆ maximumContentWidth
|
read |
This property holds the maximum width of the content of this ToolBar.
- Remarks
- This property is read-only
If the toolbar's width is larger than this value, empty space will be added on the sides, according to the Alignment property.
The value of this property is derived from the ToolBar's actions and their properties.
Definition at line 115 of file ActionToolBar.qml.
◆ overflowIconName
|
read |
This property holds the Freedesktop standard icon name to use for the overflow menu button.
default: "overflow-menu"
- Since
- KDE Frameworks 5.65
- org.kde.kirigami 2.12
Definition at line 124 of file ActionToolBar.qml.
◆ position
|
read |
This property holds the position of the toolbar.
If this ActionToolBar is the contentItem of a QQC2 Toolbar, the position is bound to the ToolBar's position
The following values are allowed:
Controls.ToolBar.Header
: The toolbar is at the top, as a window or page header.Controls.ToolBar.Footer
: The toolbar is at the bottom, as a window or page footer.
Definition at line 103 of file ActionToolBar.qml.
◆ visibleWidth
|
read |
This property holds the combined width of all visible delegates.
Definition at line 129 of file ActionToolBar.qml.
The documentation for this class was generated from the following file:
Documentation copyright © 1996-2023 The KDE developers.
Generated on Sun Oct 1 2023 03:58:23 by doxygen 1.8.17 written by Dimitri van Heesch, © 1997-2006
KDE's Doxygen guidelines are available online.