From c409efea81d6cdf5fd0e36671455267a0049df13 Mon Sep 17 00:00:00 2001 From: Aqua-sama Date: Tue, 2 Oct 2018 14:12:01 +0200 Subject: Add SingleApplication as a git submodule --- 3rd-party/SingleApplication/Windows.md | 46 ---------------------------------- 1 file changed, 46 deletions(-) delete mode 100644 3rd-party/SingleApplication/Windows.md (limited to '3rd-party/SingleApplication/Windows.md') diff --git a/3rd-party/SingleApplication/Windows.md b/3rd-party/SingleApplication/Windows.md deleted file mode 100644 index 48b0748..0000000 --- a/3rd-party/SingleApplication/Windows.md +++ /dev/null @@ -1,46 +0,0 @@ -Windows Specific Implementations -================================ - -Setting the foreground window ------------------------------ - -In the `instanceStarted()` example in the `README` we demonstrated how an -application can bring it's primary instance window whenever a second copy -of the application is started. - -On Windows the ability to bring the application windows to the foreground is -restricted, see [`AllowSetForegroundWindow()`][AllowSetForegroundWindow] for more -details. - -The background process (the primary instance) can bring its windows to the -foreground if it is allowed by the current foreground process (the secondary -instance). To bypass this `SingleApplication` must be initialized with the -`allowSecondary` parameter set to `true` and the `options` parameter must -include `Mode::SecondaryNotification`, See `SingleApplication::Mode` for more -details. - -Here is an example: - -```cpp -if( app.isSecondary() ) { - // This API requires LIBS += User32.lib to be added to the project - AllowSetForegroundWindow( DWORD( app.getPrimaryPid() ) ); -} - -if( app.isPrimary() ) { - QObject::connect( - &app, - &SingleApplication::instanceStarted, - this, - &App::instanceStarted - ); -} -``` - -```cpp -void App::instanceStarted() { - QApplication::setActiveWindow( [window/widget to set to the foreground] ); -} -``` - -[AllowSetForegroundWindow]: https://msdn.microsoft.com/en-us/library/windows/desktop/ms632668.aspx -- cgit v1.2.1