Qt API | Qtopia API

Qtopia Documentation

ExportInterface Class Reference

The ExportInterface class provides a data export interface for Qtopia. More...

#include <interfaces/importexport.h>

List of all member functions.

Public Members

• virtual bool exportData ( CenterInterface * center, const QValueList<MergeML::Record> & data, const QString & dataSet ) = 0
• virtual QString externalApplicationName () const = 0
• virtual QString palmtopApplicationName () const = 0
• virtual QStringList dataSets () const = 0
• virtual SettingsWidget * exportSettings ( QWidget * parent ) = 0

Detailed Description

When Qtopia Desktop starts up it automatically scans for plugins and registers any plugins that support the ExportInterface. Qtopia Desktop is able to export data from the Qtopia device in the formats supported by the ExportInterfaces it finds.

Writing an input interface plugin is achieved by subclassing this base class, reimplementing the pure virtual functions exportData(), externalApplicationName(), palmtopApplicationName(), dataSets() and exportSettings() and exporting the class with the Q_EXPORT_PLUGIN macro. See the Plugins documentation for details.

See also Qtopia Desktop Classes.

Member Function Documentation

QStringList ExportInterface::dataSets () const [pure virtual]

Returns a list of the data formats that this export interface can handle.

Qtopia Desktop can export data in the "addressbook", "datebook", "todolist" and "categories" formats.

bool ExportInterface::exportData ( CenterInterface * center, const QValueList<MergeML::Record> & data, const QString & dataSet ) [pure virtual]

This function is called by Qtopia Desktop when the user requests the export of Qtopia data. It is passed an interface to Qtopia Desktop, center. The name of the export format is passed in dataSet, and the data to be exported is passed in the data value list. The function should export the data in the dataSet format.

Returns TRUE if the data is successfully exported; otherwise returns FALSE.

SettingsWidget * ExportInterface::exportSettings ( QWidget * parent ) [pure virtual]

Returns a widget that the user can use to set any options that can affect the export process. The returned widget will appear in the import/export tab of the Qtopia Desktop settings dialog, which is also its parent widget.

May return 0 if there are no user-settable options.

QString ExportInterface::externalApplicationName () const [pure virtual]

Returns the name of the application that imports data in the exported format. This is usually the name of the external application that exports data in the format this ExportInterface writes. The name may be displayed to the user.

QString ExportInterface::palmtopApplicationName () const [pure virtual]

Returns the name of the Qtopia application that the data should be exported from.

This file is part of the Qtopia , copyright © 1995-2002 Trolltech, all rights reserved.