Differences

This shows you the differences between two versions of the page.

--- action:Manipulate_a_Window [2016/05/04 12:15] – cosmetic changes alain
+++ action:Manipulate_a_Window [2021/10/12 05:10] (current) – [See Also] peternlewis
@@ Line 1: / Line 1: @@
-{{:action:window-icon.png?nolink |}}
 ====== Manipulate a Window Action ======
-The //**Manipulate a Window**// [[:Actions|Action]] allows you to operation on a window, in a specified application, with a wide variety of actions like scale, move, resize, bring to front, etc. (see complete list below).
+The //**Manipulate a Window**// action allows you to operate on a window, in a specified application, with a wide variety of actions like scale, move, resize, bring to front, etc. (see complete list below).
-This action is in the //Interface Control// Action Category, and the default configuration is set for the **//Scale size by//** Operation:
+:!:  **Note:  All units are in //nominal resolution pixels// (sometimes called points), not //raw pixels//**.  So a typical retina screen will have half as many nominal resolution pixels as raw pixels.  See the [[function:SCREEN|SCREEN function]] for more info.
-**Default Action Configuration:**\\
+This action is in the //Interface Control// Action Category, and the default configuration is set for the **//Resize Front Window//** Operation:
-{{:action:km-manipulate-window-action.png?nolink|}}
+{{:action:km-manipulate-window-action-no-points.png?nolink|}}
-----
 ===== Configuration Options =====
@@ Line 19: / Line 16: @@
   - **Application** that contains the Window
+==== 1. Action Choices ====
-----
+All units (except percent) are in //nominal resolution pixels//.
-==== 1. Operation Choices ====
   *Scale size by.
@@ Line 42: / Line 38: @@
 ==== 2. Window Choices ====
-  *the front window.
+  * the front window.
-  *the window with title.
+  * the window with title.
-  *windows with title containing.
+  * windows with title containing.
-  *the window with window index.
+  * windows with title matching regular expression.
+  * the window with window index (Z-order, negative windows order from the back (eg -1 is last window)).
+  * the engine window with specified id.
+  * the last engine window.
+You can get the window id from AppleScript, or using the [[token:LastWindowID|%LastWindowID%]] token.
 ==== 3. Application Choices ====
@@ Line 51: / Line 53: @@
   *Select from list of running, recent, or available applications
   *Front Application
-----
 ===== See Also =====
-----
-==== Window Related Topics ====
 === Actions ===
-  *[[action:Login_Window]]
+* [[action:Bring Application Windows to Front]]
-  *[[action:Bring_Application_Windows_to_Front]]
+* [[action:Login Window|Login Window]]
-  *[[action:New_Google_Chrome_Window|]]
+* [[action:Move or Click Mouse|Move or Click Mouse]]
-  *[[action:New_Safari_Window]]
+* [[action:New_Google_Chrome_Window|]]
-  *[[action:Move or Click Mouse|]]
+* [[action:New_Safari_Window]]
-  *[[:Actions|See all Actions]]
+* [[:Actions|See all Actions]]
 ===  Conditions ===
-  *[[condition:Any_Window|]]
+* [[condition:Any Window|]]
-  *[[condition:Front_Window|]]
+* [[condition:Front Window|]]
-  *[[:Conditions|See all Conditions]]
+* [[:Conditions|See all Conditions]]
 === Functions ===
-  * [[function:SCREEN|SCREEN()]]
+* [[function:MENUBARHEIGHT|MENUBARHEIGHT()]]
-  * [[function:SCREENCOUNT|SCREENCOUNT()]]
+* [[function:MOUSEBUTTON|MOUSEBUTTON()]]
-  * [[function:WINDOW|WINDOW()]]
+* [[function:MOUSEX|MOUSEX()]]
-  * [[function:WINDOWCOUNT|WINDOWCOUNT()]]
+* [[function:MOUSEY|MOUSEY()]]
-  * [[function:MENUBARHEIGHT|MENUBARHEIGHT()]]
+* [[function:SCREEN|SCREEN()]]
-  * [[function:MOUSEBUTTON|MOUSEBUTTON()]]
+* [[function:SCREENCOUNT|SCREENCOUNT()]]
-  * [[function:MOUSEX|MOUSEX()]], [[function:MOUSEY|MOUSEY()]]
+* [[function:SCREENVISIBLE|SCREENVISIBLE()]]
-  * [[:Functions|See all Functions]]
+* [[function:WINDOW|WINDOW()]]
+* [[function:WINDOWCOUNT|WINDOWCOUNT()]]
+* [[:Functions|See all Functions]]
 === Tokens ===
-  * [[token:FrontWindowFrame|%FrontWindowFrame%]], [[token:WindowFrame|%WindowFrame%]]
+* [[token:FrontWindowFrame|%FrontWindowFrame%]]
-  * [[token:FrontWindowName|%FrontWindowName%]], [[token:WindowName|%WindowName%]]
+* [[token:FrontWindowName|%FrontWindowName%]]
-  * [[token:FrontWindowPosition|%FrontWindowPosition%]], [[token:WindowPosition|%WindowPosition%]]
+* [[token:FrontWindowPosition|%FrontWindowPosition%]]
-  * [[token:FrontWindowSize|%FrontWindowSize%]], [[token:WindowSize|%WindowSize%]]
+* [[token:FrontWindowSize|%FrontWindowSize%]]
-  * [[:Tokens|See all Tokens]]
+* [[token:LastWindowID|%LastWindowID%]]
+* [[token:WindowFrame|%WindowFrame%]]
+* [[token:WindowName|%WindowName%]]
+* [[token:WindowPosition|%WindowPosition%]]
+* [[token:WindowSize|%WindowSize%]]
+* [[:Tokens|See all Tokens]]
-----
 ==== Forum ====
+- [[https://forum.keyboardmaestro.com/t/how-do-i-resize-a-window-on-my-external-monitor-screen/6952/15?u=jmichaeltx | Tips by @PeterNLewis]]
 - [[https://forum.keyboardmaestro.com/t/if-you-display-a-clipboard-how-do-you-explicitly-close-it-or-is-there-a-time-out-function/1279/3|If you display a clipboard, how do you explicitly close it or is there a time out function?]]
 - [[https://forum.keyboardmaestro.com/t/two-step-split-window-macro/2626|Two Step Split Window Macro]]
 - [[https://forum.keyboardmaestro.com/t/move-window-to-top-right/2935/2|Move window to top right]]
 - [[https://forum.keyboardmaestro.com/t/close-window-missing-quickeys-user-wants-to-know/3278/2|Close Window missing? Quickeys user wants to know!]]
-- [[https://www.google.fr/search?q=site:forum.keyboardmaestro.com+Close+Window|Keyboard Maestro Forum topics about Close Window]]
-- [[https://www.google.fr/search?q=site:forum.keyboardmaestro.com+Move+Window|Keyboard Maestro Forum topics about Move Window]]
+- [[https://forum.keyboardmaestro.com/search?q=%22Close%20Window%22|Keyboard Maestro Forum topics about Close Window]]
+- [[https://forum.keyboardmaestro.com/search?q=%22Move%20Window%22|Keyboard Maestro Forum topics about Move Window]]