# class KDataTool

### abstract

Module | kio
Namespace |
Class | KDataTool
Inherits | QObject

### methods

- KDataTool (parent)

  returns ctor

  Argument | Type | Default
  --- | --- | ---
  parent | QObject | 0

  Constructor The data-tool is only created when a menu-item, that relates to it, is activated.

  parent - the parent of the QObject (or 0 for parent-less KDataTools)

- componentData ( )

  returns KComponentData

  Returns the instance of the part that created this tool. Usually used if the tool wants to read its configuration in the app's config file. Returns the instance of the part that created this tool.

- run (command, data, datatype, mimetype)

  returns bool
  pure virtual

  Argument | Type | Default
  --- | --- | ---
  command | QString |
  data | void |
  datatype | QString |
  mimetype | QString |

  Interface for 'running' this tool. This is the method that the data-tool must implement.

  command - is the command that was selected (see KDataToolInfo.commands())

  data - the data provided by the application, on which to run the tool. The application is responsible for setting that data before running the tool, and for getting it back and updating itself with it, after the tool ran.

  datatype - defines the type of data.

  mimetype - defines the mimetype of the data (for instance datatype may be QString, but the mimetype can be text/plain, text/html etc.) Returns true if successful, false otherwise

- setComponentData (componentData)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  componentData | KComponentData |

  @internal. Do not use under any circumstance (including bad weather).