Projects/Plasma/DBusInterface

From KDE TechBase

D-Bus interface planning

Preamble

ivan: Please don't edit this document until this notice is removed

Summary

This document serves for planning and revising the future plasma-desktop D-Bus interface.

Namespace

The namespace to be used is org.kde.plasma-desktop with the path ???

Interface

  • Global functions (Corona)
    • int numScreens()
    • ImmutabilityType immutability()
    • void setImmutability(IT value)
    • signal: immutabilityChanged(IT value)
    • void requestConfigSync()
  • Activity functions
    • QStringList activities()
      returns a list of activity IDs
    • QMap < QString, QVariant > activityInfo(QString id)
      returns additional info about an activity - name, type, ...
    • QString currentActivity()
      returns the ID of the current activity (in case of multi-monitor setups, returns the activity for the monitor that has the mouse cursor???)
    • QStringList currentActivities()
      returns the list of open activities (in case of non-multi-monitor setups, returns just one item)
    • void setCurrentActivity(QString id)
      switches to the specified activity
    • QString newActivity(QString name = "", QString type = "")
      creates a new activity with the specified name and type, and returns the ID. If an argument is empty, the default values are used
    • void deleteActivity(QString id)
      removes the specified activity
    • QMap < QString, QVariant > wallpaper()
      returns the info about the active wallpaper plugin - name and serialized data
  • Containment functions
    • QStringList containments()
      returns a list of unique containment IDs.
    • QString containmentForScreen(int screen, int desktop = -1)
      returns the containment for the psecified screen
    • QMap < QString, QVariant > containmentInfo(QString id)
      returns a map containing containment type, position...
    • QString addContainment(QString type, QVariantList args)
      creates a containment with the specified type (panel, ...) and returns its ID
    • void deleteContainment(QString id)
      deletes the specified containment
  • Applet functions
    • QStringList applets()
      returns a list of unique applet IDs.
    • QStringList appletsForContainment(QString containmentID)
      returns a list of applet IDs that belong to the specified containment
    • QStringList appletsForType(QString type)
      returns a list of applets of the specified type
    • QMap <...> appletInfo(QString id)
      returns additional info about the specified applet
  • Other functions