in0k-bringToSecondPlane

Units for use in Lazarus LCL.

Target

Single function bringToSecond: move window (tForm) to the SECOND position in the Z-Order list of application windows.

   Z-Index

  T0P   Wnd00              +-> Wnd_A                        Wnd_A
   1    Wnd01              |   Wnd00                  +---> Wnd_B
   2     ...               |   Wnd01                  |     Wnd00
   3     ...               |    ...                   |     Wnd01
  ...    ...               |    ...                   |
   N    Wnd_A.bringToFront-^    ...                   |
   M     ...                   bringToSecond(Wnd_B)---^
  ...    ...                    ...
  ...............................................................
  DeskTop DeskTop DeskTop DeskTop DeskTop DeskTop DeskTop DeskTop

Structure

• in0k_bringToSecondPlane.pas generalized version. If possible, use a native implementation for the target platform. If there is no implementation, it is a cross-platform version.
• in0k_bringToSecondPlane_LazLCL.pas cross-platform version
  • the functionality of the bringToSecond procedure is achieved by two consecutive calls to the standard tForm.bringToFront
  • 💩 periodically noticeable characteristic flickering of the interface. 👍 should work on ALL platforms
• bringToSecond_WIN.pas use functions WinAPI
• bringToSecond_X11.pas use functions xlib
• bringToSecond_GtkX.pas use functions Gtk
• bringToSecond_QtX.pas use functions Qt

Compatibility

	win32/64	x11/xlib	GTK2	GTK3	Qt4	Qt5
.._LCL.pas	[::]	[::]	[::]	[::]	[::]	[::]
.._WIN.pas	[+]		[+]		[#]	[+]
.._X11.pas			[+]		[+]	[+]
.._GtkX.pas	[~1]		[+]	[+]
.._QtX.pas	[~2]				[~3]	[~3]

• [::] - should work EVERYWHERE, where there is Lazarus
• [+] - implemented, tested
• [#] - implemented, NOT tested
• [~1] - used gdk_window_restack INCORRECT works under WINDOWS, the implementation is similar to LCL but with GTK methods ( [+] GTK2; [#] GTK3 ).
• [~2] - the necessary methods do not EXIST, the implementation is similar to LCL but with Qt methods ( [#] Qt4; [+] Qt5 ).
• [~3] - the necessary methods do not EXIST, the implementation is similar to LCL but with Qt methods ( [+] Qt4; [+] Qt5 ).

Usage

1. Place the source code of the library into the folder %SomeDIR% (clone the repository or download the latest version).

2. In the project settings, specify the folder %SomeDIR% in other unit files.

3. Using in code:

      uses ...
           uBringToSecond,
           ...;
      
      ..
      bringToSecond(myForm);
      ..

DEMO

For a ready-to-study example, see in repository of demo project.