Qtopia Home - Classes - Annotated - Functions - Qt Embedded

smsrequest.h

This is the verbatim text of the smsrequest.h include file. It is provided only for illustration; the copyright remains with Trolltech.

/**********************************************************************
** Copyright (C) 2000-2003 Trolltech AS.  All rights reserved.
**
** This file is part of the Qtopia Environment.
**
** This file may be distributed and/or modified under the terms of the
** GNU General Public License version 2 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file.
**
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
**
** See http://www.trolltech.com/gpl/ for GPL licensing information.
**
** Contact info@trolltech.com if any conditions of this licensing are
** not clear to you.
**
**********************************************************************/

#ifndef SMS_REQUEST_H
#define SMS_REQUEST_H

#include <qobject.h>
#include <qvaluelist.h>

#include <qtopia/quuid.h>

class SMSMessage;
class SMSDatagram;
class CBSMessage;
class PhoneLine;
class SMSRequestPrivate;


class SMSRequest : public QObject
{
    friend class PhoneLine;
    Q_OBJECT
private:
    SMSRequest( SMSRequestPrivate *, QObject *parent = 0 );

public:
    ~SMSRequest();

    enum Disposition
    {
	Send,
	SendAndStore,
	Store
    };

    QString send( const SMSMessage& m, Disposition disposition = Send, QString id = QString::null );

    void check();

    void firstMessage();
    void nextMessage();

    void deleteMessage( const QString& id );

    void sendDatagram( const SMSDatagram& dgram );

signals:
    // Signal that is emitted when a message has finished being sent.
    void finished( const PhoneLine& line, const QString& id, bool success );

    // Signal that is emitted when either a new message arrives,
    // the total count is explicitly fetched using "check()",
    // or a message is deleted using "deleteMessage".
    void messageCount( const PhoneLine& line, int total );

    // Signal that is emitted when a message in the incoming SMS buffer
    // is fetched.  "id" will be zero-length if there are no remaining
    // messages in the buffer to be fetched.
    void fetched( const PhoneLine& line, const QString& id, const SMSMessage& m );

    // Signal that is emitted when a cell broadcast message is received.
    void cellBroadcast( const PhoneLine& line, const CBSMessage& m );

private:
    // disable copy constructor and operator=
    SMSRequest& operator=(const SMSRequest &);
    SMSRequest(const SMSRequest &);

private:
    SMSRequestPrivate *d;
};

#endif