hs.grid

Двумерный массив (таблица таблиц строк), содержащий подсказки для клавиатуры (согласно hs.keycodes.map) для использования в интерактивном интерфейсе изменения размера.

• hs.inspect(hs.grid.HINTS) из консоли покажет вам, как построена таблица
• hs.grid.show() При отображении интерактивной сетки, если размеры сетки (hs.grid.setGrid()) больше размеров HINTS, Hammerspoon объединяет несколько ячеек таким образом, чтобы размеры интерактивной сетки не превышали размеры HINTS. Это делается для того, чтобы предотвратить исчерпание подсказок для ячеек интерактивной сетки. Интерактивная сетка в итоге имеет ячейки с различной высотой и шириной. Фактическая сетка не затрагивается. Если вы используете API-методы, такие как hs.grid.pushWindowDown(), у вас не возникнет этой проблемы. Если у вас есть сетка с большими размерами и вам нужна интерактивная сетка, точно моделирующая базовую сетку, установите переменную HINTS в таблицу с теми же размерами, что и ваша сетка. Ниже приведён пример сетки с 16 столбцами

hs.grid.setGrid('16x4')
hs.grid.HINTS={
    {'f1', 'f2' , 'f3' , 'f4' , 'f5', 'f6', 'f7', 'f8', 'f9', 'f10', 'f11', 'f12', 'f13', 'f14', 'f15', 'f16'},
    {'1' , 'f11', 'f15', 'f19', 'f3', '=' , ']' , '2' , '3' , '4'  , '5'  , '6'  , '7'  , '8'  , '9'  , '0'  },
    {'Q' , 'f12', 'f16', 'f20', 'f4', '-' , '[' , 'W' , 'E' , 'R'  , 'T'  , 'Y'  , 'U'  , 'I'  , 'O'  , 'P'  },
    {'A' , 'f13', 'f17', 'f1' , 'f5', 'f7', '\\', 'S' , 'D' , 'F'  , 'G'  , 'H'  , 'J'  , 'K'  , 'L'  , ','  },
    {'X' , 'f14', 'f18', 'f2' , 'f6', 'f8', ';' , '/' , '.' , 'Z'  , 'X'  , 'C'  , 'V'  , 'B'  , 'N'  , 'M'  }
}

Позволяет настроить пользовательский интерфейс модальной сетки для изменения размера.

Вызывает указанную пользователем функцию для изменения ячейки окна.

• fn - функция, принимающая в качестве единственного аргумента объект ячейки. Функция должна изменить его по мере необходимости и не возвращать ничего
• window - объект hs.window для обработки; если опущено, будет использовано активное или переднее окно

• модуль hs.grid для цепочки методов

Получает ячейку, описывающую окно.

• объект hs.window для получения ячейки

• объект ячейки (т.е. прямоугольник hs.geometry), или nil, если произошла ошибка

Получает прямоугольник hs.geometry для ячейки на определённом экране.

• cell - объект ячейки, т.е. прямоугольник hs.geometry или аргумент для его построения
• screen - объект hs.screen или аргумент для hs.screen.find(), где расположена ячейка

• прямоугольник hs.geometry для ячейки на определённом экране или nil, если экран не найден

Получает заданный размер сетки для заданного экрана или разрешения экрана.

• screen - объект hs.screen или допустимый аргумент для hs.screen.find(), указывающий на экран, сетку которого нужно получить; если опущено или nil, получает стандартную сетку, которая используется, когда для какого-либо экрана/разрешения не найдена конкретная сетка

• объект размера hs.geometry, указывающий на количество столбцов и строк в сетке

• если сетка не была задана для указанного экрана или геометрии, будет возвращена стандартная сетка

Использование: local mygrid = hs.grid.getGrid('1920x1080') -- получает заданную сетку для всех экранов с разрешением 1920x1080 local defgrid=hs.grid.getGrid() defgrid.w=defgrid.w+2 -- увеличивает количество столбцов в стандартной сетке на 2

Получает заданную рамку сетки для заданного экрана или разрешения экрана.

• screen - объект hs.screen или допустимый аргумент для hs.screen.find(), указывающий на экран, рамку сетки которого нужно получить

• объект прямоугольника hs.geometry , указывающий на рамку, используемую сеткой для данного экрана; если никакая пользовательская рамка не была задана с помощью hs.grid.setGrid(), возвращает рамку экрана

Скрывает сетку, если она видна, и выходит из модального режима изменения размера.

• None

• None

• Вызовите эту функцию, если вам нужно убедиться, что модальное окно закрыто без ожидания нажатия пользователем esc.
• Если при вызове модального интерфейса был предоставлен обратный вызов выхода, вызов .hide() вызовет его

Перемещает и изменяет размер окна, чтобы заполнить всю сетку.

• window - объект hs.window для обработки; если опущено, будет использовано активное или переднее окно

• модуль hs.grid для цепочки методов

Перемещает окно на одну ячейку вниз по экрану или на сетку соседнего экрана при необходимости

• window - объект hs.window, над которым нужно произвести действие; если опущен, будет использовано активное или верхнее окно

• модуль hs.grid для цепочки вызовов методов

Перемещает окно на одну ячейку влево по сетке или на сетку соседнего экрана при необходимости

• window - объект hs.window, над которым нужно произвести действие; если опущен, будет использовано активное или верхнее окно

• модуль hs.grid для цепочки вызовов методов

Перемещает окно на одну ячейку вправо, или на сетку соседнего экрана при необходимости

• window - объект hs.window для обработки; если опущен, будет использовано активное или верхнее окно

• модуль hs.grid для цепочки вызовов методов

Перемещает окно на одну ячейку вверх по экрану, или на сетку соседнего экрана при необходимости

• window - объект hs.window для обработки; если опущен, будет использовано активное или верхнее окно

• модуль hs.grid для цепочки вызовов методов

Изменяет размер окна так, чтобы его нижний край сместился на одну ячейку выше

• window - объект hs.window для обработки; если опущен, будет использовано активное или верхнее окно

• модуль hs.grid для цепочки вызовов методов

Изменяет размер окна так, чтобы его нижний край сместился на одну ячейку ниже

• window - объект hs.window для обработки; если опущен, будет использовано активное или верхнее окно

• модуль hs.grid для цепочки вызовов методов

• Если окно достигает нижнего края экрана и его просят сделать выше, его верхний край сместится ещё выше

Уменьшает ширину окна на одну ячейку

• window - объект hs.window для обработки; если опущен, будет использовано активное или верхнее окно

• модуль hs.grid для цепочки вызовов методов

Увеличивает ширину окна на одну ячейку

• window - объект hs.window для обработки; если опущен, будет использовано активное или верхнее окно

• модуль hs.grid для цепочки вызовов методов

• Если окно достигает правого края экрана и его просят сделать шире, его левый край сместится ещё левее

Устанавливает ячейку для окна на определённом экране

• win - объект hs.window представляющий окно для обработки
• cell - объект ячейки, т.е. прямоугольник hs.geometry, или аргумент для его создания, применяемый к окну
• screen - (опционально) объект hs.screen или аргумент для создания hs.screen.find() представляющий экран, на котором следует разместить окно; если опущен, используется текущий экран окна

• модуль hs.grid для цепочки вызовов методов

Устанавливает размер сетки для заданного экрана или разрешения

• grid - размер сетки hs.geometry, или аргумент для его создания, указывающий на количество столбцов и строк в сетке
• screen - объект hs.screen или допустимый аргумент для hs.screen.find(), указывающий на экран(ы), к которому(ым) применяется сетка; если опущен или nil, устанавливает сетку по умолчанию, которая используется, когда для любого данного экрана/разрешения не найдена специфическая сетка
• frame - объект прямоугольника hs.geometry указывающий на рамку, которую будет занимать сетка для данного экрана; если опущен или nil, используется рамка экрана :frame(); используйте этот аргумент, если хотите, например, оставить полосу рабочего стола незакрытой при использовании GeekTool или подобных утилит. Аргумент screen обязательно должен быть не-nil при установке пользовательской рамки сетки.

• модуль hs.grid для цепочки вызовов методов

Устанавливает отступы между окнами

• margins - точка или размер hs.geometry, или аргумент для их создания, указывающий на требуемые отступы между окнами в пунктах экрана

• модуль hs.grid для цепочки вызовов методов

Отображает сетку и запускает модальный интерактивный процесс изменения размера для активного или верхнего окна.

• exitedCallback - (опционально) функция, которая будет вызвана после того, как пользователь закроет модальное окно
• multipleWindows - (опционально) если true, сетка изменения размера не будет автоматически скрываться после выбора желаемых ячеек для активного окна; вместо этого она переключится на следующее окно

• None

• В большинстве случаев эта функция должна вызываться через hs.hotkey.bind с некоторыми сочетаниями клавиш.
• В модальном интерфейсе используйте стрелки для переключения на соседние экраны; пробел для максимизации/восстановления; Esc для выхода без каких-либо последствий
• Нажатие tab или shift-tab в модальном интерфейсе переключится на следующее или предыдущее окно; если multipleWindows false или опущен, первое нажатие просто включит режим работы с несколькими окнами
• Подсказки клавиатуры предполагают раскладку QWERTY; если вы используете другую раскладку, измените hs.grid.HINTS соответственно
• Если размеры сетки превышают 10x10, вам, возможно, придётся изменить hs.grid.HINTS в зависимости от ваших требований. См. примечание в HINTS

Привязывает окно к ближайшим линиям сетки

• win - объект hs.window для привязки

• модуль hs.grid для цепочки методов

Переключает режим сетки и модальности изменения размера — см. hs.grid.show() и hs.grid.hide()

• exitedCallback - (необязательно) функция, которая будет вызвана после того, как пользователь закроет модальное окно
• multipleWindows - (необязательно) если true, сетка изменения размера не будет автоматически скрываться после выбора нужных ячеек для активного окна; вместо этого она переключится на следующее окно

• Ничего