ListBrowserDelegate
Properties | |
| bool | autoExclusive |
| bool | checkable |
| bool | checked |
| alias | containsDrag |
| alias | content |
| alias | dropArea |
| alias | iconItem |
| alias | iconSizeHint |
| alias | iconSource |
| alias | iconVisible |
| alias | imageSource |
| alias | label1 |
| alias | label2 |
| alias | label3 |
| alias | label4 |
| alias | layout |
| alias | leftLabels |
| alias | maskRadius |
| alias | rightLabels |
| alias | showLabel |
| alias | template |
Signals | |
| void | contentDropped (var drop) |
| void | contentEntered (var drag) |
| void | toggled (bool state) |
Detailed Description
A MauiKit ItemDelegate with an informational row layout.
This controls inherits from MauiKit ItemDelegate, to checkout its inherited properties refer to docs.
- Note
- An example of ListBrowserDelegate in the Index -f ile manager - application.
Structure
The ListBrowserDelegate layouts its information horizontally. It's composed of two main sections: the far left icon header, and the text labels at the right side - there are four [4] possible labels. Those sections are all handled by a MauiKit ListItemTemplate control, which is exposed by the alias property template.
- See also
- ListItemTemplate
- template
The far left icon section is handled by default by a MauiKit IconItem, which can have an image or icon. Those can be set via the imageSource or the iconSource properties.
- See also
- IconItem
The said icon header can also be replaced by any other component using the template.iconComponent property.
Notes
This control can be checkable, and a CheckBox element will be placed on the left side. It also supports features from the Button type, such as the autoExclusive, checked properties and the press events.
By inheritance this component can be dragable.
- Note
- This control is usually used as the delegate component for the ListBrowser or QQC2 ListView.
Drag & Drop
To set up the drag and drop, use the Drag attached properties. The most relevant part for this control is to set the Drag.keys and Drag.mimeData
You can find a more complete example at this link.
Definition at line 74 of file ListBrowserDelegate.qml.
Property Documentation
◆ autoExclusive
|
read |
Whether the control should be auto exclusive, this means that among other related elements - sharing the same parent - only one can be selected/checked at the time.
By default this is set to false.
Definition at line 146 of file ListBrowserDelegate.qml.
◆ checkable
|
read |
Whether the control should become checkable.
If it is checkable a CheckBox element will become visible to allow to toggle between the checked states. By default this is set to false.
Definition at line 141 of file ListBrowserDelegate.qml.
◆ checked
|
read |
Whether the control is checked or not.
By default this is set to false.
Definition at line 136 of file ListBrowserDelegate.qml.
◆ containsDrag
|
read |
Whether this element currently contains any item being dragged on top of it.
- Remarks
- This property is read-only
Definition at line 173 of file ListBrowserDelegate.qml.
◆ content
|
read |
- See also
- ListItemTemplate::content
- Remarks
- This is the default property
Definition at line 87 of file ListBrowserDelegate.qml.
◆ dropArea
|
read |
An alias to expose the DropArea component in charge of the drag&drop events.
- See also
- contentDropped
- Remarks
- This property is read-only
Definition at line 179 of file ListBrowserDelegate.qml.
◆ iconItem
|
read |
- See also
- ListItemTemplate::iconItem
Definition at line 111 of file ListBrowserDelegate.qml.
◆ iconSizeHint
|
read |
- See also
- ListItemTemplate::iconSizeHint
Definition at line 119 of file ListBrowserDelegate.qml.
◆ iconSource
|
read |
- See also
- ListItemTemplate::iconSource
Definition at line 127 of file ListBrowserDelegate.qml.
◆ iconVisible
|
read |
- See also
- ListItemTemplate::iconVisible
Definition at line 115 of file ListBrowserDelegate.qml.
◆ imageSource
|
read |
- See also
- ListItemTemplate::imageSource
Definition at line 123 of file ListBrowserDelegate.qml.
◆ label1
|
read |
- See also
- ListItemTemplate::label1
- Remarks
- This property is read-only
Definition at line 92 of file ListBrowserDelegate.qml.
◆ label2
|
read |
- See also
- ListItemTemplate::label2
- Remarks
- This property is read-only
Definition at line 97 of file ListBrowserDelegate.qml.
◆ label3
|
read |
- See also
- ListItemTemplate::label3
- Remarks
- This property is read-only
Definition at line 102 of file ListBrowserDelegate.qml.
◆ label4
|
read |
- See also
- ListItemTemplate::label4
- Remarks
- This property is read-only
Definition at line 107 of file ListBrowserDelegate.qml.
◆ layout
|
read |
An alias to access the layout fo this control handled by a RowLayout.
- Remarks
- This property is read-only
Definition at line 185 of file ListBrowserDelegate.qml.
◆ leftLabels
|
read |
- See also
- ListItemTemplate::leftLabels
- Remarks
- This property is read-only
Definition at line 151 of file ListBrowserDelegate.qml.
◆ maskRadius
|
read |
- See also
- ListItemTemplate::maskRadius
Definition at line 167 of file ListBrowserDelegate.qml.
◆ rightLabels
|
read |
- See also
- ListItemTemplate::rightLabels
- Remarks
- This property is read-only
Definition at line 156 of file ListBrowserDelegate.qml.
◆ showLabel
|
read |
- See also
- ListItemTemplate::labelsVisible
Definition at line 131 of file ListBrowserDelegate.qml.
◆ template
|
read |
An alias to access the ListItemTemplate control properties.
- Remarks
- This property is read-only
This is the template element that layouts all the information: labels and icon/image.
- See also
- ListItemTemplate
Definition at line 163 of file ListBrowserDelegate.qml.
Member Function Documentation
◆ contentDropped
|
signal |
Emitted when a drop event has been triggered on this control.
- Parameters
-
drop The object with information about the event.
◆ contentEntered
|
signal |
Emitted when a drop event has entered the area of this control.
- Parameters
-
drop The object with information about the event.
◆ toggled
|
signal |
Emitted when the control checked state has been changed.
- Parameters
-
state The checked state value.
The documentation for this class was generated from the following file:
Documentation copyright © 1996-2025 The KDE developers.
Generated on Fri May 2 2025 11:57:11 by doxygen 1.13.2 written by Dimitri van Heesch, © 1997-2006
KDE's Doxygen guidelines are available online.