ListItemTemplate

Properties | |
alias | content |
int | fillMode |
int | headerSizeHint |
bool | highlighted |
bool | hovered |
Component | iconComponent |
alias | iconContainer |
alias | iconItem |
int | iconSizeHint |
string | iconSource |
alias | iconVisible |
int | imageSizeHint |
string | imageSource |
bool | isCurrentItem |
bool | isMask |
alias | label1 |
alias | label2 |
alias | label3 |
alias | label4 |
bool | labelsVisible |
alias | layout |
alias | leftLabels |
int | maskRadius |
alias | rightLabels |
alias | spacing |
alias | text1 |
alias | text2 |
alias | text3 |
alias | text4 |
Additional Inherited Members | |
![]() | |
childAt (real x, real y) | |
bool | contains (point point) |
dumpItemTree () | |
forceActiveFocus () | |
forceActiveFocus (Qt::FocusReason reason) | |
bool | grabToImage (callback, targetSize) |
point | mapFromGlobal (real x, real y) |
point | mapFromItem (Item item, point p) |
point | mapFromItem (Item item, real x, real y) |
rect | mapFromItem (Item item, real x, real y, real width, real height) |
rect | mapFromItem (Item item, rect r) |
point | mapToGlobal (real x, real y) |
point | mapToItem (Item item, point p) |
point | mapToItem (Item item, real x, real y) |
rect | mapToItem (Item item, real x, real y, real width, real height) |
rect | mapToItem (Item item, rect r) |
nextItemInFocusChain (bool forward) | |
Detailed Description
A template for an horizontal layout of information.
This controls inherits from QQC2 Item, to checkout its inherited properties refer to the Qt Docs.
The structure of this control is divided into a left side header for the image/icon and a four [4] labels for the title, message at the right side of the header, and at the far right side another two labels for complementary information.
The icon header section can be modified and assigned to any custom control.
- See also
- iconComponent
For extra information checkout the ListBrowserDelegate documentation, since this template element is used as its base.
Definition at line 36 of file ListItemTemplate.qml.
Property Documentation
◆ content
|
read |
By default all children will be positioned at the right end of the row.
- Remarks
- This is the default property
The positioning of the elements is handled by a RowLayout, so use the attached properties.
Definition at line 46 of file ListItemTemplate.qml.
◆ fillMode
|
read |
- See also
- IconItem::fillMode By default this is set to
Image.PreserveAspectFit
.
- Note
- For more options and information review the QQC2 Image documentation.
Definition at line 183 of file ListItemTemplate.qml.
◆ headerSizeHint
|
read |
The size of the header section.
This is the size the header container will take. By default this is set to -1
which means that the size of the header will be determined by the child implicit height and width.
Definition at line 159 of file ListItemTemplate.qml.
◆ highlighted
|
read |
Whether the control should be styled as being highlighted by some external event.
By default this is set to false
.
Definition at line 207 of file ListItemTemplate.qml.
◆ hovered
|
read |
Whether the control should be styled as being hovered by a cursor.
By default his is set to false
.
Definition at line 202 of file ListItemTemplate.qml.
◆ iconComponent
|
read |
The header section can be modified by changing its component to a custom one.
By default the component used for the iconComponent
is a MauiKit IconItem element.
- Note
- When using a custom component for the header section, pay attention that it has an
implicitHeight
andimplicitWidth
set.
Definition at line 192 of file ListItemTemplate.qml.
◆ iconContainer
|
read |
The container for the icon header section.
- Remarks
- This property is read-only
This is handled by a QQC2 Loader. By default the source component will be loaded asynchronous.
Definition at line 106 of file ListItemTemplate.qml.
◆ iconItem
|
read |
The Item loaded as the icon header section.
- Remarks
- This property is read-only
The component used as the icon header is loaded with a QQC2 Loader - this property exposes that element that was loaded. By default the loaded item will be a MauiKit IconItem, but if another component is used for iconComponent
, that will be the resulting Item.
- See also
- structure
Definition at line 115 of file ListItemTemplate.qml.
◆ iconSizeHint
|
read |
A size hint for the icon to be used in the header.
The final size will depend on the available space.
Definition at line 149 of file ListItemTemplate.qml.
◆ iconSource
|
read |
- See also
- IconItem::iconSource
Definition at line 167 of file ListItemTemplate.qml.
◆ iconVisible
|
read |
Whether the icon/image header section should be visible.
Definition at line 120 of file ListItemTemplate.qml.
◆ imageSizeHint
|
read |
A size hint for the image to be used in the header.
The final size will depend on the available space. By default this is set to -1
which means that image will fill the available space.
Definition at line 154 of file ListItemTemplate.qml.
◆ imageSource
|
read |
- See also
- IconItem::imageSource
Definition at line 163 of file ListItemTemplate.qml.
◆ isCurrentItem
|
read |
Whether this element is currently on a selected or checked state.
This is used to highlight the component accordingly. By default this is set to false
.
Definition at line 172 of file ListItemTemplate.qml.
◆ isMask
|
read |
- See also
- IconItem::isMask By default this is set to evaluate
true
for icons equal or smaller in size then 16 pixels.
Definition at line 197 of file ListItemTemplate.qml.
◆ label1
|
read |
An alias for the QQC2 Label handling the title text.
- Remarks
- This property is read-only
Exposed for fine tuning the label font properties.
- Note
- See the QQC2 Label documentation for more information.
Definition at line 78 of file ListItemTemplate.qml.
◆ label2
|
read |
An alias for the QQC2 Label handling the subtitle text.
- Remarks
- This property is read-only
Exposed for fine tuning the label font properties.
- Note
- See the QQC2 Label documentation for more information.
Definition at line 85 of file ListItemTemplate.qml.
◆ label3
|
read |
An alias for the QQC2 Label handling the extra information text.
- Remarks
- This property is read-only
Exposed for fine tuning the label font properties.
- Note
- See the QQC2 Label documentation for more information.
Definition at line 92 of file ListItemTemplate.qml.
◆ label4
|
read |
An alias for the QQC2 Label handling the extra information text.
- Remarks
- This property is read-only
Exposed for fine tuning the label font properties.
- Note
- See the QQC2 Label documentation for more information.
Definition at line 99 of file ListItemTemplate.qml.
◆ labelsVisible
|
read |
Whether the two bottom labels, for title and message, should be displayed.
By default this is set to true
.
Definition at line 177 of file ListItemTemplate.qml.
◆ layout
|
read |
An alias to the container layout for this control.
- Remarks
- This property is read-only
This is handled by a RowLayout.
Definition at line 145 of file ListItemTemplate.qml.
◆ leftLabels
|
read |
An alias to the column element hosting the title and message labels.
- Remarks
- This property is read-only
Definition at line 129 of file ListItemTemplate.qml.
◆ maskRadius
|
read |
- See also
- IconItem::maskRadius
Definition at line 187 of file ListItemTemplate.qml.
◆ rightLabels
|
read |
An alias to the column element hosting the far-right extra labels.
- Remarks
- This property is read-only
Definition at line 138 of file ListItemTemplate.qml.
◆ spacing
|
read |
The spacing size between the image/icon header and the labels columns.
Definition at line 51 of file ListItemTemplate.qml.
◆ text1
|
read |
The text use for the main title text.
Definition at line 56 of file ListItemTemplate.qml.
◆ text2
|
read |
The text use for the subtitle text.
Definition at line 61 of file ListItemTemplate.qml.
◆ text3
|
read |
The text use for the left-top far side text.
Definition at line 66 of file ListItemTemplate.qml.
◆ text4
|
read |
The text use for the left-bottom far side text.
Definition at line 71 of file ListItemTemplate.qml.
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.