Porting to Qtopia 4

Qtopia 4 Headers

Qtopia 4 has both classic (2.2-style) and Qt-style headers. The classic headers are provided to ease porting but you should consider switching to Qt-style headers to avoid dependency problems and because they will eventually be removed.

There are 2 ways to include Qt-style headers. You can use the class name (for public classes in public headers) or the header file name.

    #include <QAppointment>
    #include <qappointment.h>
    #include <private/vobject_p.h>

Note that the classic versions of these headers are.

    #include <qtopia/pim/qappointment.h>
    #include <qtopia/pim/private/vobject_p.h>

In cases where a header with the same name exists in 2 libraries you may need to prefix the library name.

    #include <qtopiapim/QAppointment>
    #include <qtopiapim/qappointment.h>
    #include <qtopiapim/private/vobject_p.h>

However, this should be avoided where possible because it can lead to dependency problems. If you include <QAppointment> but you have not declared your dependency on libqtopiapim (depends(libraries/qtopiapim)) you will get a compile error that will clearly identify the header <QAppointment> is unavailable. If you include <qtopiapim/QAppointment> you will get a linker or runtime error that may not indicate the problem in a clear way.

       myproc.setInputChannel( QProcess::StandardOutput );
       QTextStream procstream( myproc );
       procStream >> theResults;  // get into a string
       myproc.setInputChannel( QProcess::StandardError );
       procStream >> someError;

        QMenu* menu = new QMenu;
        menu->setCheckable( TRUE );
        QActionGroup *grp = new QActionGroup;
        for (int i = 0; i <= myLastItem; ++i )
        {
            items[i] = new QAction( QString( "option %1" ).arg( i ), grp );
            items[i]->setCheckable( TRUE );
        }
        items[myDefault]->setChecked( TRUE );
        menu->addActions( grp->actions() );

    a_settings = new QAction( tr("Settings..."),
                              theicon,
                              QString::null, 0, this, 0 );
    connect( a_settings, SIGNAL( activated() ),
             this, SLOT( doSettings() ) );
    a_settings->addTo( menu );

    a_settings = new QAction( theicon,
                              tr("Settings..."), this );
    connect( a_settings, SIGNAL( triggered() ),
             this, SLOT( doSettings() ) );
    menu->addAction( a_settings );

        img = img.smoothScale( 5, 5 );

        img.scale( 5, 5, Qt::KeepAspectRatio, Qt::SmoothTransformation );

    QRect r = style().pushButtonContentsRect( this );
    int sx, sy;
    style().getButtonShift(sx, sy);
    int dx = style().menuButtonIndicatorWidth( height() );
    style().drawArrow( p, DownArrow, FALSE, x+w-dx, y+2, dx-4, h-4,
             colorGroup(), isEnabled() );

    QStyleOptionButton sob;
    sob.init( this );  // copies this->rect() and this->state, this's StyleFlags
    QRect r = style()->subRect( QStyle::SR_PushButtonContents, &sob );
    int sx = style()->pixelMetric( QStyle::PM_ButtonShiftHorizontal, &sob );
    int sy = style()->pixelMetric( QStyle::PM_ButtonShiftVertical, &sob );
    int dx = style()->pixelMetric( QStyle::PM_MenuButtonIndicator, &sob );
    QStyleOptionButton arrowStyle = sob;
    arrowStyle.rect.setLeft( sob.rect.right() - h) );  // a small square at RHS
    style()->drawPrimitive( QStyle::PE_IndicatorArrowDown, &arrowStyle, p );

    #include <qplugin.h>
    #include <qfactoryinterface.h>
    #include <qobject.h>

    struct QMyPluginFactoryInterface : public QFactoryInterface
    {
        // pure virtual functions
    };

    Q_DECLARE_INTERFACE(QMyPluginFactoryInterface, "http://trolltech.com/Qtopia/QMyPluginFactoryInterface")

    class QMyPluginPlugin : public QObject, public QMyPluginFactoryInterface
    {
        Q_OBJECT
        Q_INTERFACES(QMyPluginFactoryInterface:QFactoryInterface)
    public:
        QMyPluginPlugin(QObject *parent=0);
        ~QMyPluginPlugin();

        virtual QStringList keys() const = 0;
        // pure virtual functions
    };

        QScrollArea *sa = new QScrollArea(...);
        sa->setFocusPolicy(Qt::NoFocus);
        QWidget *view = new QWidget;
        sa->setWidget(view);
        sa->setWidgetResizable(true);
        // add children to view.

    Grabs the physical keyboard keys, e.g. the application's launching
    keys. Instead of launching applications when these keys are pressed
    the signals emitted are sent to this application instead. Some games
    programs take over the launch keys in this way to make interaction
    easier.

    Under Qtopia Phone Edition this function does nothing. It is not
    possible to grab the keyboard under Qtopia Phone Edition.