CoordMode

Sets coordinate mode for various built-in functions to be relative to either the active window or the screen.

CoordMode "ToolTip|Pixel|Mouse|Caret|Menu" , "Screen|Window|Client"

Parameters

Param1

ToolTip: Affects ToolTip.

Pixel: Affects PixelGetColor, PixelSearch, and ImageSearch.

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

Caret: Affects CaretGetPos.

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

Param2

If Param2 is omitted, it defaults to Screen.

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

Relative: Coordinates are relative to the active window.

Window: Synonymous with Relative and recommended for clarity.

Client: 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 function is not used, all built-in functions 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 function. That default may be changed by using this function 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.Show

Example

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