|
Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions | |
The QDSAction class provides an interface for requesting Qt Extended Data Sharing (QDS) services. More...
#include <QDSAction>
Inherits QObject.
The QDSAction class provides an interface for requesting Qt Extended Data Sharing (QDS) services.
Applications can use the QDSAction class to make a request for a QDS service. The request can be made either synchronously (using QDSAction::exec()) or asynchronously (using QDSAction::invoke()).
See also QDSServiceInfo and Qt Extended Data Sharing (QDS).
This enum describes response codes for synchronous requests.
| Constant | Value | Description |
|---|---|---|
| QDSAction::Invalid | 0 | Response code has not been set. |
| QDSAction::Complete | 1 | The request was processed correctly. |
| QDSAction::CompleteData | 2 | The request was processed correctly, and response data was received. |
| QDSAction::Error | 3 | An error occured, use QDSAction::errorMessage() to view the error message. |
Constructs an empty QDSAction object and attaches it to parent.
Constructs a deep copy of other.
Constructs a QDSAction object for the QDS service name and the Qt Extended service service. The action is attached to parent.
Constructs a QDSAction object for the service described in serviceInfo and attaches to parent.
Destroys the action.
This signal is emitted when an error message message is received for the action identified by actionId.
Returns any error message generated during the request. Errors are reported from either QDSAction or the provider application, and are reported through QDSData::error() or the return value of QDSData::exec(). If no error has been reported a null string will be returned.
Synchronously performs the QDS service request. The return value provides the result of the request, see QDSAction::ResponseCode.
This method should only be used for QDS services which don't have request data, as discussed in QDSServiceInfo, otherwise an error will be generated.
Warning: This call will block until a response has been received from the QDS service or the request times out.
This is an overloaded member function, provided for convenience.
Synchronously performs the QDS service request with requestData. The return value provides the result of the request, see QDSAction::ResponseCode.
The request may also contain auxiliary data for supplementary information which may be required for the request but does not conceptually belong to requestData.
This method should only be used for QDS services which have request data, as discussed in QDSServiceInfo, otherwise an error will be generated.
Warning: This call will block until the response has been received from the QDS service or the request times out.
Returns the unique identifier for the QDSAction
Asynchronously initiates the QDS service request. Depending on the outcome of the request, the response from the QDS service provider is given by one of QDSData::response() or QDSData::error() signals.
This method should only be used for QDS services which don't have request data, as discussed in QDSServiceInfo, otherwise an error will be generated.
Returns true on successful completion of the request; otherwise returns false.
This is an overloaded member function, provided for convenience.
Asynchronously initiates the QDS service request with requestData. Depending on the outcome of the request, the response from the QDS service provider is given by one of QDSData::response() or QDSData::error() signals.
The request may also contain auxiliary data for supplementary information, which may be required for the request but does not conceptually belong to requestData.
This method should only be used for QDS services which have request data, as discussed in QDSServiceInfo, otherwise an error will be generated.
Returns true on successful completion of the request; otherwise returns false.
Returns true if the request is still being processed by the QDS service provider; otherwise returns false.
Returns true if the QDSAction object represents an available QDS service; otherwise returns false. The requirements of an available QDS service are discussed in QDSServiceInfo.
Returns true if the QDSAction object represents a valid QDS service; otherwise returns false. The requirements of a valid QDS service are discussed in QDSServiceInfo.
This signal is emitted when a response is received from the service provider for the action identified by actionId.
This is an overloaded member function, provided for convenience.
This signal is emitted when a response is received from the service provider which contains the response data responseData for the action identified by actionId.
Returns the QDSData generated by the request.
Returns the QDSServiceInfo object which describes the QDS service being utilised.
Makes a deep copy of other and assigns it to this QDSAction object. Returns a reference to this QDSAction object.
| Copyright © 2009 Trolltech | Trademarks | Qt Extended 4.4.3 |