Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

QtopiaSendVia Class Reference
[QtBaseModule]

The QtopiaSendVia class provides an easy way of sending files via communications services. More...

    #include <QtopiaSendVia>

• List of all members, including inherited members

Static Public Members

• bool isDataSupported ( const QString & mimetype )
• bool isFileSupported ()
• bool sendData ( QWidget * parent, const QByteArray & data, const QString & mimetype )
• bool sendFile ( QWidget * parent, const QString & filename, const QString & mimetype, const QString & description = QString(), bool autodelete = false )
• bool sendFile ( QWidget * parent, const QContent & content, bool autodelete = false )

Detailed Description

The QtopiaSendVia class provides an easy way of sending files via communications services.

QtopiaSendVia makes it easy to send files, business cards, tasks and calendar items to other devices via supported communications protocols, e.g. Bluetooth, Infrared, SMS, Email, etc.

Member Function Documentation

bool QtopiaSendVia::isDataSupported ( const QString & mimetype )   [static]

Returns true if there is a handler in the system that can handle sending the mimetype.

See also isFileSupported().

bool QtopiaSendVia::isFileSupported ()   [static]

Returns true if there is a handler in the system that can handle sending files. Not all services can send files, but some, like Bluetooth and Infrared can.

See also isDataSupported().

bool QtopiaSendVia::sendData ( QWidget * parent, const QByteArray & data, const QString & mimetype )   [static]

Send data with mimetype via a communications link. The user will first be asked what communications medium to use via a standard dialog. Once the user has made their choice, the appropriate handler will be invoked and the data will be sent. The parent specifies the parent widget for the dialog. If the parent is NULL, then the choice dialog is constructed as a top level dialog.

The user should use isDataSupported() to check that the data can be sent.

Returns true if the request could be started, and false otherwise.

See also sendFile(), isDataSupported(), and QDialog.

bool QtopiaSendVia::sendFile ( QWidget * parent, const QString & filename, const QString & mimetype, const QString & description = QString(), bool autodelete = false )   [static]

Send filename with mimetype via a communications link. The user will first be asked what communications medium to use via a standard dialog. Once the user has made their choice, the appropriate handler will be invoked and the data will be sent.

The description will be used as a user-friendly description of the file where necessary in the user interface.

The parent specifies the parent widget for the dialog. If the parent is NULL, then the choice dialog is constructed as a top level dialog.

Set autodelete to true if the file is a temporary file. The invoked handler will take care of deleting the file once it has been sent. If you do not wish the file to be deleted, set autodelete to false.

The user should use isFileSupported() first to find out whether file sending is supported.

Returns true if the request could be started, and false otherwise.

See also isFileSupported(), sendData(), and QDialog.

bool QtopiaSendVia::sendFile ( QWidget * parent, const QContent & content, bool autodelete = false )   [static]

This is an overloaded member function, provided for convenience.

This is an overloaded member function, provided for convenience.

This version works on QContent objects.

The file to send is given by content. Set autodelete to true if the file should be deleted once the request is processed. The parent holds the parent widget for the dialog that will be shown to the user.

The QContent::name() of content will be used as a user-friendly description of the object to be sent.