Using QTM's D-Bus interface

Submitted by Matthew Smith on Sat, 2008-05-17 18:58
::

D-Bus is a system for facilitating communication between programs, and is used by the Unix desktops GNOME and KDE 4. This information is not useful to users of QTM; it is intended for developers who want their programs to communicate with QTM. Particular targets are developers of web browsers and RSS feed readers.

To see the D-Bus specification, including its data types, click here.

QTM's service and interface names are both uk.co.blogistan.catkin, the same as for QTM preferences purposes.

QTM exports three properties:

  • organizationName - The "organisation" behind QTM
  • organizationDomain - catkin.blogistan.co.uk
  • applicationVersion - Returns the current version of QTM

The following methods are also available:

  • getQuickpostTemplateTitles - Returns a string array containing a list of the titles of the available templates, formatted n.[title], where n is the number of the template
  • getQuickpostTemplates - Returns a string array containing a list of the available templates, with titles, formatted n.[title].[template_content] - newlines and closing square brackets are escaped as \n and \] respectively.
  • newDocumentWithTitleAndText - takes two arguments, both strings, title and text, representing the title and content of the entry respectively.
  • quickpost - takes two arguments, both strings; url contains the web location and content contains the material to be fed to quickpost. A template will be applied if the 'url' argument contains a user-defined associated host string.
  • newDocument - opens a blank new document
  • open - opens a saved entry from the filesystem. Takes one argument, 'path', containing the full path of the file to be opened.