TagsDialog

Search for usage in LXR

TagsDialog Class Reference

Inherits org::mauikit::controls::PopupPage, and org::mauikit::controls::PopupPage.

Properties

alias composerList
 
alias listView
 
alias taglist
 

Signals

void tagsReady (var tags)
 

Detailed Description

A popup dialog for selecting between all the available tags to associate to a given set of file URLs.

This popup page also allows to create new tags, edit existing ones and removing.

To associate the set of file URLs, use the exposed property composerList.urls, which is an alias to TagsList::urls.

See also
composerList
TagsList::urls The composerList property exposes most of the available properties for tweaking the behaviour, and also contains the methods to perform any modifications to the tags.
Example using the TagsDialog control
Maui.Page
{
Maui.Controls.showCSD: true
anchors.fill: parent
title: "Add tags to a file"
FB.FileBrowser
{
id: _fileBrowser
anchors.fill: parent
currentPath: StandardPaths.writableLocation(StandardPaths.DownloadLocation)
settings.viewType: FB.FMList.LIST_VIEW
onItemClicked: (index) =>
{
_tagsDialog.composerList.urls = [_fileBrowser.currentFMModel.get(index).url]
_tagsDialog.open()
}
}
FB.TagsDialog
{
id: _tagsDialog
composerList.strict: false //Show all the associated tags to the file
onTagsReady: (tags) => console.log(tags)
}
}
alias composerList
An alias to the TagsList controller and model.

Definition at line 49 of file TagsDialog.qml.

Property Documentation

◆ composerList

TagsList TagsDialog::composerList
read

An alias to the TagsList controller and model.

Remarks
This property is read-only

This property is exposed to set the file URLs to which perform any new assignment or removal of tags. Refer to its documentation for more details on the available actions.

Definition at line 71 of file TagsDialog.qml.

◆ listView

MauiKit::ListBrowser TagsDialog::listView
read

An alias to the Mauikit ListBrowser element listing the tag elements.

Remarks
This property is read-only

Definition at line 63 of file TagsDialog.qml.

◆ taglist

alias TagsDialog::taglist
read
Remarks
This property is read-only

Definition at line 57 of file TagsDialog.qml.

Member Function Documentation

◆ tagsReady

void TagsDialog::tagsReady ( var tags)
signal

Emitted once the assignment of the new set of tags has been done.

This can include removal or additions. This won't actually write any changes to the file URLs, to write the changes refer to the composerList.updateToUrls function.

See also
TagsList::updateToUrls
Parameters
tagsthe list of the new tag names associated to the file URLs

The documentation for this class was generated from the following file:
This file is part of the KDE documentation.
Documentation copyright © 1996-2024 The KDE developers.
Generated on Fri May 17 2024 11:51:27 by doxygen 1.10.0 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.