Keyboard Maestro Wiki

User Tools

Site Tools

Trace:
token:WindowName

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
token:WindowName [2016/11/22 20:43]
JMichaelTX ADD: Details about coordinates, screenshots, icon, sections 		token:WindowName [2019/07/05 03:45] (current)
peternlewis
Line 1: Line 1:
-{{:​action:​window-icon.png?​nolink|}} +~~REDIRECT>​token:Window_Tokens~~
-====== Windows Related Tokens ====== +
- +
-This Wiki page receives the redirect for a number or windows related tokens: +
- +
-  * [[token:WindowFrame|%WindowFrame%]] +
-  * [[token:​WindowPosition|%WindowPosition%]] +
-  * [[token:​WindowSize|%WindowSize%]] +
-  * [[token:​WindowName|%WindowName%]]  +
- +
- +
-Each of these text tokens return information about the specified window. ​  +
- +
- +
-==== Token Parameters ==== +
- +
- +
-Each one takes a parameter indicating which window to use.  The parameter is the value _after_ the percent sign of the main token.\\ +
-For example:​\\ +
-`%TokenName%TokenParameter%`\\ +
-`%WindowFrame%1%` +
- +
-The parameter may be: +
- +
-* Front or 0: the focused/​main window. Usually the same as index 1. +
-* Positive Number: the indexed window from front to back. +
-* Negative Number: the indexed window from back to front. +
- +
-So for example, //​%WindowName%1%//​ gives the name of the front window. +
- +
-Like all coordinates in Keyboard Maestro, the WindowPosition and WindowFrame are from the top left corner of the main screen (the defined one with the menu bar on it, although this is less apparent now that the menu bar is on all monitors). +
- +
-==== WindowFrame (FrontWindowFrame) ==== +
- +
- +
-The `%WindowFrame%` and //​%FrontWindowFrame%//​ tokens returns the location of the window in pixels of left, top, width, and height of the front window in a comma-delimited numerical string. +
- +
-%WindowFrame%1% is synonymous and may be used interchangeably. +
- +
-Example Return of these tokens: +
- +
-``` +
-228,​23,​1314,​1173 +
- +
-left,​top,​width,​height +
-``` +
- +
---- +
- +
-==== Accessing Window and Screen Coordinates ==== +
- +
-When a Window or screen token returns a set of 4 comma-delimited values as one result into a Keyboard Maestro Variable (which is always text), you can access the individual values, and calculate other values, by using certain key words appended to the Variable name in a [[token:​Calculate|Calculate Token]], such as the following:​ +
- +
-{{:​token:​km-7.3-window-coordinates.png?​nolink|}} +
- +
-This produces the following results, in the Display Action: +
- +
-``` +
-Window Frame: ​ 2810,​66,​1281,​1049 +
- +
-Left:​ 2810 +
-Top: 66 +
-Width:​ 1281 +
-Height:​ 1049 +
- +
-Right:​ 4091 +
-Bottom:​ 1115 +
-MidX:​ 3450.5 +
-MidY:​ 590.5 +
-``` +
- +
-=== Screen/​Window Keyword "​coordinates"​ === +
- +
- +
-* Left +
-* Right +
-* Top +
-* Bottom +
-* Width +
-* Height +
-* MidX +
-* MidY +
- +
---- +
- +
-===== See Also ===== +
- +
----- +
- +
-=== Functions === +
- +
-* [[function:​SCREEN|SCREEN()]] +
-* [[function:​SCREENVISIBLE|SCREENVISIBLE()]] +
-* [[function:​WINDOW|WINDOW()]] +
-* [[function:​WINDOWCOUNT|WINDOWCOUNT()]] +
-* [[:​Functions|See all Functions]] +
- +
-=== Tokens === +
- +
-* [[token:​FrontWindowFrame|%FrontWindowFrame%]] +
-* [[token:​FrontWindowName|%FrontWindowName%]] +
-* [[token:​FrontWindowPosition|%FrontWindowPosition%]] +
-* [[token:​FrontWindowSize|%FrontWindowSize%]] +
-* [[token:​WindowFrame|%WindowFrame%]] +
-* [[token:​WindowPosition|%WindowPosition%]] +
-* [[token:​WindowSize|%WindowSize%]] +
-* [[:​Tokens|See all Tokens]] +
- +
-=== Triggers === +
- +
-* [[trigger:​Focused Window|Focused Window trigger]] +
-* [[:​Triggers|See all Triggers]] +
- +
----- +
- +
-==== Forum ==== +
- +
-- [[https://​forum.keyboardmaestro.com/​t/​trapping-dialogs-in-pause-condition/​3046/​4|Trapping dialogs in Pause condition]] +
- +
-- [[https://​www.google.fr/​search?​q=site:​forum.keyboardmaestro.com+WindowName|Keyboard Maestro Forum topics about WindowName]]+
token/WindowName.1479865423.txt.gz · Last modified: 2016/11/22 20:43 by JMichaelTX

Page Tools

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki