User Tools

Site Tools


token:Window_Tokens

Window Related Tokens

This Wiki page receives the redirect for a number or windows related tokens:

Each of these text tokens return information about the specified window.

Token Parameters

The non-Front variants take a parameter indicating the window. The parameter is the value after the percent sign of the main token. For example: %TokenName%TokenParameter% or %WindowFrame%1%.

The parameter may be:

Parameter Meaning
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.
All All of the windows, one per line, from front to back.

So for example, %WindowFrame%1% gives the frame of the front window (the same as %FrontWindowFrame%).

The Front variants are older versions that are equivalent to using Front as the parameter.

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).

WindowName (FrontWindowName)

The %WindowName% tokens returns the window title of the specified window.

%FrontWindowName% is a synonym for %WindowName%Front% and may be used interchangeably.

WindowFrame (FrontWindowFrame)

The %WindowFrame% tokens returns the location of the window in pixels of left, top, width, and height of the window in a comma-delimited numerical string.

%FrontWindowFrame% is a synonym for %WindowFrame%Front% and may be used interchangeably.

Example Return of these tokens:

228,23,1314,1173

left,top,width,height

WindowPosition (FrontWindowPosition)

The %WindowPosition% tokens returns the location of the window in pixels of left and top of the window in a comma-delimited numerical string.

%FrontWindowPosition% is a synonym for %WindowPosition%Front% and may be used interchangeably.

Example Return of these tokens:

228,23

left,top

WindowSize (FrontWindowSize)

The %WindowSize% tokens returns the size of the window in pixels of width and height of the window in a comma-delimited numerical string.

%FrontWindowSize% is a synonym for %WindowSize%Front% and may be used interchangeably.

For example, these tokens return values for:
width,height:

1314,1173

Accessing Window, Screen, & Image Coordinates

When a Window, screen token or a FoundImage 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 coordinate names appended to the Variable name in a Calculate Token, such as the following:

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

For WindowPosition, you can use Left and Top, and for WindowSize you can use Width and Height.

Screen/Window/Image Coordinate Names

  • Left
  • Right
  • Top
  • Bottom
  • Width
  • Height
  • MidX
  • MidY

See Also

Functions

Tokens

Triggers

Forum

token/Window_Tokens.txt · Last modified: 2020/08/31 20:03 by JMichaelTX