System.GetMousePosition

table System.GetMousePosition (

boolean ClientCoordinates = true,
number WndHandle = nil )

Описание

Возвращает таблицу, содержащую текущую позицию курсора мышки, либо относительно всего экрана (экранные координаты - screen coordinates), либо относительно окна приложения (клиентские координаты - client coordinates), или относительно некоторого другого клиентского окна.

Примечание: Экранные координаты это координаты относительно верхнего левого угла экрана. Клиентские координаты это координаты относительно верхнего левого угла клиентской области приложения (страницы) и если указан параметр WndHandle (дескриптор окна), то это будет относительно верхнего левого угла этого окна.

Параметры

ClientCoordinates

(логический) Получать ли позицию курсора мышки относительно окна приложения или относительно другого окна:

ЗНАЧЕНИЕ VALUE	ОПИСАНИЕ DESCRIPTION
true	Возвращать текущую позицию курсора мышки относительно приложения (клиентские координаты - client coordinates) или какого другого окна. (По умолчанию)
false	Возвращать текущую позицию курсора мышки относительно экрана (экранные координаты - screen coordinates).

WndHandle

(число) Дополнительный числовой дескриптор окна для получения позиции курсора мышки относительно этого окна. Это значение будет использоваться только если параметр ClientCoordinates установлен как true и передан верный дескриптор окна. Если это значение (параметр WndHandle) равно nil, будет использоваться клиентская область приложения.

Возврат

ResultVariable

(таблица) Таблица, содержащая текущую позицию курсора мышки, или относительно всего экрана (экранные координаты - screen coordinates), либо относительно окна приложения (клиентские координаты - client coordinates), либо к указанному окну, индексированная следующими ключами:

КЛЮЧ KEY	ТИП TYPE	ОПИСАНИЕ DESCRIPTION
X	число	Горизонтальная позиция курсора мышки.
Y	число	Вертикальная позиция курсора мышки.

Если информацию нельзя определить или происходит ошибка, возвращается значение nil. Можно использовать действие Application.GetLastError для определения случился ли отказ в работе этого действия и почему.

При добавлении действия из редактора скрипта, можно использовать это поле для определения переменной, которая возвращает значение, сохраняющееся в ней.

Смотрите также: Связанные действия

Примеры

Пример 1

tMousePos = System.GetMousePosition(true);
tPageSize = {W = 640, H = 480};

if tMousePos.X < 0 or tMousePos.X > tPageSize.W then
   -- Mouse is outside the left or right side of the page
   -- Курсор мышки вышел за левую или правую стороны страницы
end

if tMousePos.Y < 0 or tMousePos.Y > tPageSize.H then
   -- Mouse is outside the top or bottom side of the page
   -- Курсор мышки вышел за верхнюю или нижнюю стороны страницы
end

Определяем, выходит ли курсор мышки за границы страницы.

Пример 2

tMousePos = System.GetMousePosition(true, DialogEx.GetWndHandle());
Label.SetText("Label1", tMousePos.X .. " , " .. tMousePos.Y);

Обновляем на диалоговом окне объект надпись (label) с текущими координатами положения курсора мышки.

Смотрите также: Связанные действия