diff -r 2e2dc3d30ca8 -r 341166945d65 homescreenapp/examples/localisedhellowidgetplugin/src/localisedhellowidgettplugin.cpp --- a/homescreenapp/examples/localisedhellowidgetplugin/src/localisedhellowidgettplugin.cpp Thu Jun 24 13:11:40 2010 +0100 +++ b/homescreenapp/examples/localisedhellowidgetplugin/src/localisedhellowidgettplugin.cpp Fri Jun 25 19:19:22 2010 +0300 @@ -22,106 +22,10 @@ #include "localisedhellowidgetplugin.h" #include "localisedhellowidget.h" -/** - @page page_creating_widget_plugin Creating Home Screen Widget Plugin - - Widgets are exposed to the home screen through QT Service Framework. - Widget plugins are implemented according to - Qt service framework plugin model. - - See @ref page_nativewidgetmodel for the instructions how to create widget for the home screen. - - The steps to create a widget plugin are: -
    -
  1. Declare a plugin class that inherits from QObject and from the \c QServicePluginInterface interface. - -
  2. Use the Q_INTERFACES() macro to tell Qt's meta-object system about the \c QServicePluginInterface interface. - -
  3. Export the plugin using the Q_EXPORT_PLUGIN2() macro. - -
  4. Build the plugin using an suitable .pro file. See @ref page_deploying_widget_plugin -
- - An example (full example source code can be found from section @ref page_nativewidgetmodel): - - Each widget plugin has a XML file that allows searching widgets through QT service framework without first loading it. - The XML file contains information on widgets inside the plugin: - - \li \c name The name of the plugin binary. - \li \c filepath The absolute path and name of plugin without suffix - \li \c interface name Uniquely identifies the widget. - \li \c title Widget's human-readable name. - \li \c iconuri URI of the widget's icon image file. - - Example: XML for a widget plugin. - - @code - - - helloworldwidgetplugin - helloworldwidgetplugin - Example widget - - com.nokia.symbian.IHomeScreenWidget - 1.0 - Example of home screen widget - - helloworldwidgetplugin.png - HelloWorld - - - @endcode -*/ - -/** - @page page_deploying_widget_plugin Deploying Home Screen Widget Plugin - - Widget's binaries and xml file(s) must be deployed to correct folders on emulator and in target. - Below are the needed .pro file for the \c helloworldwidgetplugin. - - For example: - - @code - # helloworldwidgetplugin.pro - - TEMPLATE = lib - CONFIG += plugin mobility hb - MOBILITY = serviceframework - - HEADERS += ./inc/ .h - SOURCES += ./src/ .cpp - - DESTDIR = $${EPOCROOT}epoc32/data/c/private/20022F35/import/widgetregistry/20022F7E - - INCLUDEPATH += ./inc - - symbian: { - INCLUDEPATH += $$APP_LAYER_SYSTEMINCLUDE - - TARGET.UID3 = 0x20022F7E - TARGET.EPOCALLOWDLLDATA=1 - TARGET.CAPABILITY = ALL -TCB - - plugins.path = $${DESTDIR} - plugins.sources = $${TARGET}.dll - - widgetResources.path = $${DESTDIR} - widgetResources.sources += resource/$${TARGET}.xml - widgetResources.sources += resource/$${TARGET}.manifest - widgetResources.sources += resource/$${TARGET}.png - - DEPLOYMENT += plugins \ - widgetResources - } - - @endcode - - For detailed information on DEPLOYMENT macro, see here. -*/ /*! - \ingroup group_helloworld_widget - \class HelloWorldWidgetPlugin + \ingroup group_localised_helloworld_widget + \class LocalisedHelloWidgetPlugin \brief Example implementation for home screen widget plugin. */