mirrors/PersistentWindows
1
0
Fork 0
mirror of https://github.com/kangyu-california/PersistentWindows.git synced 2025-05-11 04:55:39 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

help.md - grammar, readability, structure of the Dual Position Switching section

Browse source
This commit is contained in:
Alejandro Gomez 2024-02-22 20:06:46 -08:00
parent 9e09911ee1
commit 710077ca3d
1 changed files with 38 additions and 32 deletions
Download patch file Download diff file Expand all files Collapse all files

70
Help.md
View file

@ -6,16 +6,16 @@
| --- | --- |
| -gui=0 | Do not display the PersistentWindows icon on the System Tray. Effectively runs PersistentWindows as a service
| -splash=0 | No splash window at PersistentWindows startup
| -legacy_icon | Switch to original icon (as in 5.49 release)
| -legacy_icon | Switch to the original icon (as of 5.49 release)
| -silent | No splash window, no balloon tip hint, no event logging
| -ignore_process "notepad.exe;foo" | Avoid restoring windows for the processes notepad.exe and foo
| -debug_process "notepad.exe;foo" | Print window positioning event logs for the processes notepad.exe and foo in event viewer
| -debug_process "notepad.exe;foo" | Print the window positioning event logs in Event Viewer for the processes *notepad.exe* and *foo*
| -foreground_background_dual_position=0 | turn off dual position switching
| -prompt_session_restore | Ask the user before restoring the window layout upon resuming the last session. This may help to reduce the total restore time for remote desktop sessions on slow internet connections.
| -prompt_session_restore | Ask the user before restoring the window layout upon resuming the last session. This may help reduce the total restore time for remote desktop sessions on slow internet connections.
| -delay_auto_capture 1.0 | Adjust the lag between window move event and auto-capture to 1.0 second, the default lag is 3~4 seconds.
| *-delay_auto_restore 2.5* | Adjust the lag between monitor on/off event and auto-restore to 2.5 seconds (the default lag is 1 second), in case restore is incomplete or monitor fails to go to sleep due to restore starts too early.
| -redraw_desktop | Redraw the whole desktop after a restore in case some window workarea is not refreshed
| -fix_zorder=1 | Preserve window Z-order for automatic restore. The Z-order of a window indicates the window's position in a stack of overlapping windows.
| *-delay_auto_restore 2.5* | Adjust the lag between monitor on/off event and auto-restore to 2.5 seconds (the default lag is 1 second). This is in case the restore is incomplete or the monitor fails to go to sleep due to the restore starting too early.
| -redraw_desktop | Redraw the whole desktop after a restore, in case some window workarea is not refreshed
| -fix_zorder=1 | Preserve the window Z-order for automatic restores. The Z-order of a window indicates the window's position in a stack of overlapping windows.
| -fix_offscreen_window=0 | Turn off auto correction of off-screen windows
| -fix_unminimized_window=0 | Turn off auto restore of unminimized windows. Use this switch to avoid undesirable window shifting during window activation, which comes with Event id 9999 : "restore minimized window ...." in event viewer.
| ‑auto_restore_missing_windows=1 | When restoring from disk, restore missing windows without prompting the user
@ -32,38 +32,44 @@
| --- | --- |
| Capture snapshot 0 | Double click the PersistentWindows icon
| Restore snapshot 0 | Click the PersistentWindows icon
| Capture snapshot X | Double click the PersistentWindows icon, then immediately press key X (X represents a digit [0-9] or a letter [a-z])
| Capture snapshot X | Double click the PersistentWindows icon, then immediately press key X (X represents a digit [0-9] or a letter [a-z])
| Restore snapshot X | Click the PersistentWindows icon, then immediately press key X
| Undo the last snapshot restore | Alt + click the PersistentWindows icon
| Undo the last snapshot restore | Alt-click the PersistentWindows icon
### Shortcuts for capture/restore windows on disk
* To save a named capture to disk, Ctrl click the "Capture windows to disk" menu option, then enter a name in the pop-up dialog
* To restore the named capture from disk, Ctrl click the "Restore windows from disk" menu option, then enter the name of the previously saved capture in the dialog
* To restore capture from a different display config, Shift click "Restore windows from disk" menu.
* To save a named capture to disk, Ctrl-click the "Capture windows to disk" menu option, then enter a name in the pop-up dialog
* To restore the named capture from disk, Ctrl-click the "Restore windows from disk" menu option, then enter the name of the previously saved capture in the dialog
* To restore capture from a different display config, Shift-click the "Restore windows from disk" menu option.
---
### Shortcuts to manipulate positions of one window
* To activate Dual Position Switching which allows a window to switch between foreground and background mode of different positions and sizes, move or resize the window while pressing Ctrl key.
Once DPS is activated,
* Click the desktop window to bring the foreground window to its previous background position and z-order.
* Shift click the desktop window to bring the foreground window to its *second* last background position. This is useful if the previous background position is mis-captured due to invoking start menu or other popups.
* Ctrl click the desktop window to bring the foreground window to its previous z-order while keeping the current location and size.
* To cancel Dual Position Switching, move or resize the window without pressing Ctrl key.
* To bring a background DPS window to foreground *without* restoring to previous foreground position.
* press any of Ctrl/Shift/Alt key when activating the window.
* To restore a new window to its last closing position
* Ctrl click the PW icon
* To put the foreground window behind all other windows (similar to the Alt+Esc shortcut provided by Windows OS, which however does not work for windows inside a remote desktop window)
* Alt click the desktop window.
* Ctrl Alt click the PW icon if the foreground window is maximized.
* To hide a window to notification area in taskbar
* press Ctrl key when click the minimize button
* To enable/disable auto restore for non-toplevel window (such as a child or dialog window)
* To include a child/dialog window for auto capture/restore, move the window once using mouse
* To exclude a window from auto capture/restore, press Ctrl Shift keys when moving the window
### Shortcuts to manipulate positions of a window
* Dual Position Switching allows a window to switch between foreground and background mode of different positions and sizes
* To activate Dual Position Switching:
* move or resize the window while pressing the Ctrl key.
* Dual Position Switching functionality:
* Click the desktop window to bring the foreground window to its previous background position and Z-order.
* Shift-click the desktop window to bring the foreground window to its *second* last background position. This is useful if the previous background position is mis-captured due to invoking start menu or other popups.
* Ctrl-click the desktop window to bring the foreground window to its previous Z-order while keeping the current location and size.
* To cancel Dual Position Switching:
* move or resize the window without pressing the Ctrl key.
* To bring a background DPS window to foreground *without* restoring to the previous foreground position:
* press any of Ctrl/Shift/Alt key when activating the window
* To restore a new window to its last closing position:
* Ctrl-click the PersistentWindows icon
* To put the foreground window behind all other windows (similar to the Alt+Esc shortcut provided by the Windows OS, which, however, does not work for windows inside a remote desktop window):
* Alt-click the desktop window.
* Ctrl-Alt-click the PersistentWindows icon if the foreground window is maximized.
* To hide a window to the notification area in the taskbar:
* Press the Ctrl key when clicking the minimize button
* To enable/disable auto restore for non-toplevel windows (such as a child or dialog window):
* To include a child/dialog window for auto capture/restore, move the window once using the mouse
* To exclude a window from auto capture/restore, press the Ctrl-Shift keys when moving the window
### Other features
* Replace the default app icon with your customized one
* Rename your .ico (or .png) file as `pwIcon.ico` (or `pwIcon.png`) and copy it to PW program folder or alternatively to `C:/Users/<YOUR_ID>/AppData/Local/PersistentWindows/`.
* To replace the default app icon with your customized one:
* Rename your .ico (or .png) file as `pwIcon.ico` (or `pwIcon.png`) and copy it to the PersistentWindows program folder, or alternatively to `C:/Users/<YOUR_ID>/AppData/Local/PersistentWindows/`.
* Copy another icon file to the same directory and rename it to `pwIconBusy.*`. This icon is displayed when PersistentWindows is busy restoring windows.