version 0.0.41: New typed version. Improved Window class to accept Window object or window id (int/str), added acceptInput(), added getTopWindowAt(), fixed and improved sendBehind() on Ubuntu 22.04+ and Mint/Cinnamon, improved watchdog, fixed Mint/Cinnamon sendBehind() method, added macOS AppScript alwaysOnTop() and alwaysOnBottom() methods

Author: Kalmat

CHANGES.txt

@@ -1,3 +1,4 @@
+0.0.41, 2022/12/09 -- Fixed requirements.txt with typing_extensions dependency
 0.0.40, 2022/12/07 -- New typed version. Improved Window class to accept Window object or window id (int/str), added acceptInput(), added getTopWindowAt(), fixed and improved sendBehind() on Ubuntu 22.04+ and Mint/Cinnamon,
 0.0.39, 2022/06/07 -- Improved watchdog, fixed Mint/Cinnamon sendBehind() method, added macOS AppScript alwaysOnTop() and alwaysOnBottom() methods
 0.0.38, 2022/05/29 -- Fixed pynput version typo in setup.py requirements

README.md

@@ -22,7 +22,7 @@ My most sincere thanks and acknowledgement to [Avasam](https://github.com/Avasam
 
 ## Window Features <a name="window-features"></a>
 
-You need a Window object to manipulate/control windows on screen. It's possible to get a Window object by using any of the general methods (e.g. getActiveWidow() or getWindowsWithTitle()). You can also use windows id, as returned by PyQt's self.winId() or tkinter's root.frame(), which is very handy to get the Window object for your own application.
+You need a Window object to manipulate/control the target window on screen. It's possible to get a Window object by using any of the general methods (e.g. getActiveWidow() or getWindowsWithTitle()). You can also use windows id, as returned by PyQt's self.winId() or tkinter's root.frame(), which is very handy to get the Window object for your own application.
 
 These functions are available at the moment, in all three platforms (Windows, Linux and macOS):
 

dist/PyWinCtl-0.0.40-py3-none-any.whl dist/PyWinCtl-0.0.41-py3-none-any.whldist/PyWinCtl-0.0.40-py3-none-any.whl renamed to dist/PyWinCtl-0.0.41-py3-none-any.whl

@@ -2,9 +2,10 @@
 # Run: `pip install -r docs/requirements.txt`
 # Production requirements are found in ../setup.py
 
-PyRect>=0.1
+PyRect>=0.2
 types-setuptools>=65.5
-mypy >= 0.990
+mypy>=0.990
+typing_extensions>=4.4.0
 
 # Windows
 pywin32>=302; sys_platform == 'win32'

docs/requirements.txt

@@ -25,7 +25,7 @@
 if sys.platform == "darwin":
     __all__ += ["NSWindow"]
 
-__version__ = "0.0.40"
+__version__ = "0.0.41"
 
 class Box(NamedTuple):
     left: int

src/pywinctl/__init__.py

@@ -595,11 +595,18 @@ def alwaysOnTop(self, aot: bool = True):
         :param aot: set to ''False'' to deactivate always-on-top behavior
         :return: Always returns ''True''
         """
+        # TODO: investigate how to place on top of DirectDraw exclusive mode windows (hook DirectDraw APIs)
+        # https://stackoverflow.com/questions/7009080/detecting-full-screen-mode-in-windows
+        # https://stackoverflow.com/questions/7928308/displaying-another-application-on-top-of-a-directdraw-full-screen-application
+        # https://www.codeproject.com/articles/730/apihijack-a-library-for-easy-dll-function-hooking?fid=1267&df=90&mpp=25&sort=Position&view=Normal&spc=Relaxed&select=116946&fr=73&prof=True
+        # https://guidedhacking.com/threads/d3d9-hooking.8481/
+        # https://stackoverflow.com/questions/25601362/transparent-window-on-top-of-immersive-full-screen-mode
         if self._t and self._t.is_alive():
             self._t.kill()
         # https://stackoverflow.com/questions/17131857/python-windows-keep-program-on-top-of-another-full-screen-application
         zorder = win32con.HWND_TOPMOST if aot else win32con.HWND_NOTOPMOST
-        win32gui.SetWindowPos(self._hWnd, zorder, 0, 0, 0, 0, win32con.SWP_NOMOVE | win32con.SWP_NOSIZE)
+        win32gui.SetWindowPos(self._hWnd, zorder, 0, 0, 0, 0, win32con.SWP_NOMOVE | win32con.SWP_NOSIZE |
+                                                              win32con.SWP_NOACTIVATE)
         return True
 
     def alwaysOnBottom(self, aob: bool = True) -> bool:
@@ -647,7 +654,7 @@ def raiseWindow(self):
         :return: Always returns ''True''
         """
         win32gui.SetWindowPos(self._hWnd, win32con.HWND_TOP, 0, 0, 0, 0,
-                                       win32con.SWP_NOSIZE | win32con.SWP_NOMOVE | win32con.SWP_NOACTIVATE)
+                                       win32con.SWP_NOSIZE | win32con.SWP_NOMOVE)
         return True
 
     def sendBehind(self, sb: bool = True) -> bool: