CoordMode()

Auto Hotkey

CoordMode

Sets coordinate mode for various commands to be relative to either the active window or the screen.

CoordMode Command , Mode
Command  Example: CoordMode "ToolTip", "Screen"
Function Example: CoordMode("ToolTip","Screen")

Parameters

Param1

ToolTip: Affects ToolTip.

Pixel: Affects PixelGetColor, PixelSearch, and ImageSearch.

Mouse: Affects MouseGetPos, Click, and MouseMove/Click/Drag.

Caret: Affects the built-in variables A_CaretX and A_CaretY.

Menu: Affects the Menu Show command when coordinates are specified for it.

Param2

If Param2 is omitted, it defaults to Screen.

Screen or 2: Coordinates are relative to the desktop (entire screen).

Window or Relative or 1: Coordinates are relative to the active window.

Client or 0: Coordinates are relative to the active window's client area, which excludes the window's title bar, menu (if it has a standard one) and borders. Client coordinates are less dependent on OS version and theme.

Remarks

If this command is not used, all commands except those documented otherwise (e.g. WinMove and InputBox) use coordinates that are relative to the active window's client area.

Every newly launched thread (such as a hotkey, custom menu item, or timed subroutine) starts off fresh with the default setting for this command. That default may be changed by using this command in the auto-execute section (top part of the script).

The built-in A_CoordMode variables contain the current settings.

Related

Click, MouseMove, MouseClick, MouseClickDrag, MouseGetPos, PixelGetColor, PixelSearch, ToolTip, Menu

Example

CoordMode, ToolTip, Screen  ; Place ToolTips at absolute screen coordinates:
CoordMode, ToolTip  ; Same effect as the above because "screen" is the default.