diff -r 277e3324e775 -r d9e9413f30c9 controlpanel/controlpanel_plat/inc/cplauncherinterface.h --- a/controlpanel/controlpanel_plat/inc/cplauncherinterface.h Wed Aug 18 10:03:24 2010 +0300 +++ b/controlpanel/controlpanel_plat/inc/cplauncherinterface.h Thu Sep 02 20:42:34 2010 +0300 @@ -11,7 +11,7 @@ * * Contributors: * -* Description: +* Description: Interface for controlpanel plugins, with this interface client application can launch a view from outside of controlpanel application. * */ @@ -24,7 +24,49 @@ /*! \class CpLauncherInterface - \brief The class CpLauncherInterface defines an interface for plugins which can be launched a specific view from outside controlpanel application. + \brief The class CpLauncherInterface defines an interface for plugins, if one controlpanel plugin implements + this interface, client application can launch a setting view from outside of controlpanel application by two ways. + + (1) launch setting view in client process, using CpPluginLauncher. + + \code + CpBaseSettingView *settingView = CpPluginLauncher::launchSettingView("cpmyplugin.dll",QVariant()); + \endcode + + (2) launch setting view in embedded mode, using QtHighway client API. + + \code + if (mRequest) { + delete mRequest; + mRequest = 0; + } + + mRequest = mAppMgr.create("com.nokia.symbian.ICpPluginLauncher", "launchSettingView(QString,QVariant)", true); + + if (!mRequest) + { + return; + } + else + { + connect(mRequest, SIGNAL(requestOk(QVariant)), SLOT(handleReturnValue(QVariant))); + connect(mRequest, SIGNAL(requestError(int,QString)), SLOT(handleError(int,QString))); + } + + // Set arguments for request + QList args; + args << QVariant("cpmyplugin.dll"); + args << QVariant(); + mRequest->setArguments(args); + + mRequest->setSynchronous(false); + // Make the request + if (!mRequest->send()) + { + //report error + } + \endcode + */ class QVariant;