d3v1l/matrixion
1
0
Fork 0
mirror of https://github.com/Nheko-Reborn/nheko.git synced 2024-11-25 12:38:48 +03:00
Code Issues Projects Releases Packages Wiki Activity Actions
matrixion/third_party/SingleApplication-3.0.19/Windows.md
Nicolas Werner e96241265e Use third_party singleapplication helper 
This may still not raise the application correctly on some WMs, because
they don't allow disturbing the user with windows popping up. I don't
think we want to work around that.

fixes #84
fixes #113
2020-02-23 13:44:05 +01:00

1.4 KiB
Raw Blame History

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() 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:

if( app.isSecondary() ) {
    // This API requires LIBS += User32.lib to be added to the project
    AllowSetForegroundWindow( DWORD( app.primaryPid() ) );
}

if( app.isPrimary() ) {
    QObject::connect(
        &app,
        &SingleApplication::instanceStarted,
        this,
        &App::instanceStarted
    );
}

void App::instanceStarted() {
    QApplication::setActiveWindow( [window/widget to set to the foreground] );
}