User Tools
token:WindowName
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision | Next revision Both sides next revision | ||
|
token:WindowName [2016/06/29 15:07] alain |
token:WindowName [2016/11/22 20:43] JMichaelTX ADD: Details about coordinates, screenshots, icon, sections |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | The [[token:WindowFrame|%WindowFrame%]], [[token:WindowPosition|%WindowPosition%]], [[token:WindowSize|%WindowSize%]], and [[token:WindowName|%WindowName%]] text tokens return information about the specified window. Each one takes a parameter indicating which window to use. | + | {{:action:window-icon.png?nolink|}} |
| + | ====== 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: | The parameter may be: | ||
| Line 10: | Line 30: | ||
| 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). | 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 ===== | ===== See Also ===== | ||
token/WindowName.txt · Last modified: 2019/07/05 03:45 by peternlewis
Page Tools
