QListView *listview = new QListView(this);
KFileItemDelegate *delegate = new KFileItemDelegate(this);
listview->setItemDelegate(delegate);

Member Function Documentation

[explicit] KFileItemDelegate::KFileItemDelegate(QObject *parent = nullptr)

Constructs a new KFileItemDelegate.

parent The parent object for the delegate.

[override virtual noexcept] KFileItemDelegate::~KFileItemDelegate()

Destroys the item delegate.

QRect KFileItemDelegate::iconRect(const QStyleOptionViewItem &option, const QModelIndex &index) const

Returns the rectangle of the icon that is aligned inside the decoration rectangle.

bool KFileItemDelegate::jobTransfersVisible() const

Returns whether or not the displaying of job transfers is enabled.

See also setJobTransfersVisible().

QSize KFileItemDelegate::maximumSize() const

Returns the maximum size for KFileItemDelegate::sizeHint().

See also setMaximumSize().

[override virtual] void KFileItemDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const

Reimplements: QAbstractItemDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const.

Paints the item indicated by index, using painter.

The item will be drawn in the rectangle specified by option.rect. The correct size for that rectangle can be obtained by calling sizeHint().

This function will use the following data values if the model provides them for the item, in place of the values in option:

• Qt::FontRole The font that should be used for the display role.
• Qt::TextAlignmentRole The alignment of the display role.
• Qt::ForegroundRole The text color for the display role.
• Qt::BackgroundRole The background color for the item.

This function is reimplemented from QAbstractItemDelegate.

painter The painter with which to draw the item.

option The style options that should be used when painting the item.

index The index to the item that should be painted.

void KFileItemDelegate::setJobTransfersVisible(bool jobTransfersVisible)

Enable/Disable the displaying of an animated overlay that is shown for any destination urls (in the view). When enabled, the animations (if any) will be drawn automatically.

Only the files/folders that are visible and have jobs associated with them will display the animation. You would likely not want this enabled if you perform some kind of custom painting that takes up a whole item, and will just make this(and what you paint) look funky.

Default is disabled.

Note: The model (KDirModel) needs to have it's method called with the same value, when you make the call to this method.

See also jobTransfersVisible().

void KFileItemDelegate::setMaximumSize(const QSize &size)

Sets the maximum size for KFileItemDelegate::sizeHint().

See also maximumSize().

void KFileItemDelegate::setShadowBlur(qreal radius)

Sets the blur radius for the text shadow.

See also shadowBlur().

void KFileItemDelegate::setShadowColor(const QColor &color)

Sets the color used for drawing the text shadow.

To enable text shadows, set the shadow color to a non-transparent color. To disable text shadows, set the color to Qt::transparent.

See also shadowColor().

void KFileItemDelegate::setShadowOffset(const QPointF &offset)

Sets the horizontal and vertical offset for the text shadow.

See also shadowOffset().

void KFileItemDelegate::setShowInformation(KFileItemDelegate::Information information)

Sets a single information line that is shown below the icon label in list views.

This is a convenience function for when you only want to show a single line of information.

information The information that should be shown

See also showInformation().

void KFileItemDelegate::setShowInformation(const KFileItemDelegate::InformationList &list)

Sets the list of information lines that are shown below the icon label in list views.

You will typically construct the list like this:

KFileItemDelegate::InformationList list;
list << KFileItemDelegate::FriendlyMimeType << KFileItemDelegate::Size;
delegate->setShowInformation(list);

The information lines will be displayed in the list order. The delegate will first draw the item label, and then as many information lines as will fit in the available space.

list A list of information items that should be shown

void KFileItemDelegate::setShowToolTipWhenElided(bool showToolTip)

Sets whether a tooltip should be shown if the display role is elided containing the full display role information.

See also showToolTipWhenElided().

void KFileItemDelegate::setWrapMode(QTextOption::WrapMode wrapMode)

When the contents text needs to be wrapped, wrapMode strategy will be followed.

See also wrapMode().

qreal KFileItemDelegate::shadowBlur() const

Returns the blur radius for the text shadow.

See also setShadowBlur().

QColor KFileItemDelegate::shadowColor() const

Returns the color used for the text shadow.

See also setShadowColor().

QPointF KFileItemDelegate::shadowOffset() const

Returns the offset used for the text shadow.

See also setShadowOffset().

[slot] QRegion KFileItemDelegate::shape(const QStyleOptionViewItem &option, const QModelIndex &index)

Returns the shape of the item as a region.

The returned region can be used for precise hit testing of the item.

KFileItemDelegate::InformationList KFileItemDelegate::showInformation() const

Returns the file item information that should be shown below item labels in list views.

See also setShowInformation().

bool KFileItemDelegate::showToolTipWhenElided() const

Returns whether a tooltip should be shown if the display role is elided containing the full display role information.

See also setShowToolTipWhenElided().

[override virtual] QSize KFileItemDelegate::sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const

Reimplements: QAbstractItemDelegate::sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const.

Returns the nominal size for the item referred to by index, given the provided options.

If the model provides a valid Qt::FontRole and/or Qt::TextAlignmentRole for the item, those will be used instead of the ones specified in the style options.

This function is reimplemented from QAbstractItemDelegate.

option The style options that should be used when painting the item.

index The index to the item for which to return the size hint.

QTextOption::WrapMode KFileItemDelegate::wrapMode() const

Returns the wrapping strategy followed to show text when it needs wrapping.

See also setWrapMode().