Member Function Documentation

KFileItemActions::KFileItemActions(QObject *parent = nullptr)

Creates a KFileItemActions instance. Note that this instance must stay alive for at least as long as the popupmenu; it has the slots for the actions created by addOpenWithActionsTo/addServiceActionsTo.

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

Destructor

void KFileItemActions::addActionsTo(QMenu *menu, KFileItemActions::MenuActionSources sources = MenuActionSource::All, const QList<QAction *> &additionalActions = {}, const QStringList &excludeList = {})

This methods adds additional actions to the menu. @param menu Menu to which the actions/submenus will be added. @param sources sources from which the actions should be fetched. By default all sources are used. @param additionalActions additional actions that should be added to the "Actions" submenu or top level menu if there are less than three entries in total. @param excludeList list of action names or plugin ids that should be excluded @since 5.77

[static] KService::List KFileItemActions::associatedApplications(const QStringList &mimeTypeList)

Returns the applications associated with all the given MIME types.

This is basically a KApplicationTrader::query, but it supports multiple MIME types, and also cleans up "apparent" duplicates, such as different versions of the same application installed in parallel.

The list is sorted according to the user preferences for the given MIME type(s). In case multiple MIME types appear in the URL list, the logic is: applications that on average appear earlier on the associated applications list for the given MIME types also appear earlier on the final applications list.

Note that for a single MIME type there is no need to use this, you should use KApplicationTrader instead, e.g. query() or preferredService().

This will return an empty list if the "openwith" Kiosk action is not authorized (see @c KAuthorized::authorize()).

@param mimeTypeList the MIME types @return the sorted list of services. @since 5.83

[signal] void KFileItemActions::error(const QString &errorMessage)

Forwards the errors from the KAbstractFileItemActionPlugin instances @since 5.82

void KFileItemActions::insertOpenWithActionsTo(QAction *before, QMenu *topMenu, const QStringList &excludedDesktopEntryNames)

Generates the "Open With <Application>" actions, and inserts them in @p menu, before action @p before. If @p before is nullptr or doesn't exist in the menu the actions will be appended to the menu.

All actions are created as children of the menu.

No actions will be added if the "openwith" Kiosk action is not authorized (see KAuthorized::authorize()).

@param before the "open with" actions will be inserted before this action; if this action is nullptr or isn't available in @p topMenu, the "open with" actions will be appended @param menu the QMenu where the actions will be added @param excludedDesktopEntryNames list of desktop entry names that will not be shown

@since 5.82

[signal] void KFileItemActions::openWithDialogAboutToBeShown()

Emitted before the "Open With" dialog is shown This is used e.g in folderview to close the folder peek popups on invoking the "Open With" menu action @since 4.8.2

[slot] void KFileItemActions::runPreferredApplications(const KFileItemList &fileOpenList)

Slot used to execute a list of files in their respective preferred application. @param fileOpenList the list of KFileItems to open. @since 5.83

void KFileItemActions::setItemListProperties(const KFileItemListProperties &itemList)

Sets all the data for the next instance of the popupmenu. @see KFileItemListProperties

void KFileItemActions::setParentWidget(QWidget *widget)

Set the parent widget for any dialogs being shown.

This should normally be your mainwindow, not a popup menu, so that it still exists even after the popup is closed (e.g. error message from KRun) and so that QAction::setStatusTip can find a statusbar, too.