[kdbusaddons] src: KDBusService: document how to raise the active window, in Activate()

[David Faure]

Git commit d9a6ce124ee6ece84e6af4c741f2ad0ed2599928 by David Faure.
Committed on 03/08/2015 at 23:23.
Pushed by dfaure into branch 'master'.

KDBusService: document how to raise the active window, in Activate()

CCMAIL: kde-core-devel at kde.org

M  +3    -0    src/kdbusservice.h

http://commits.kde.org/kdbusaddons/d9a6ce124ee6ece84e6af4c741f2ad0ed2599928

diff --git a/src/kdbusservice.h b/src/kdbusservice.h
index add327e..fedcf11 100644
--- a/src/kdbusservice.h
+++ b/src/kdbusservice.h
@@ -203,6 +203,9 @@ Q_SIGNALS:
      * @code
      *    commandLineParser->parse(arguments); // same QCommandLineParser instance as the one used in main()
      *    handleCmdLine(workingDirectory); // shared method with main(), which uses commandLineParser to handle options and positional arguments
+     *    // and for GUI applications, also terminate startup notification and activate the mainwindow:
+     *    KStartupInfo::setNewStartupId(mainWindow, KStartupInfo::startupId());
+     *    KWindowSystem::forceActiveWindow(mainWindow->winId());
      * @endcode
      *
      * @see setExitValue()