hs.window

Длительность анимации по умолчанию в секундах. Начальное значение 0,2; установите в 0, чтобы отключить анимации.

Использование hs.window:setFrame() в некоторых случаях не работает как ожидается: а именно, нижний (или Dock) край и края между экранами могут

Возвращает все окна

• Нет

• Список объектов hs.window, представляющих все открытые окна

• visibleWindows(), orderedWindows(), get(), find(), и несколько других функций и методов в этом и других модулях используют эту функцию, поэтому важно понять ее ограничения
• Эта функция запрашивает все приложения для получения их окон каждый раз при вызове; если вам нужно вызывать ее много раз и производительность не приемлема, рассмотрите использование модуля hs.window.filter
• Эта функция может возвращать только окна в текущем пространстве Mission Control; если вам нужно обращаться к окнам в разных пространствах, вы можете использовать модуль hs.window.filter.
  • если Displays have separate Spaces включено (в Системные настройки>Управление окнами), текущее пространство определяется как объединение всех в настоящее время видимых пространств
  • минимизированные окна и скрытые окна (т.е. принадлежащие скрытым приложениям, например, с помощью cmd-h) всегда считаются находящимися в текущем пространстве
• Эта функция отфильтровывает "окно" рабочего стола; используйте hs.window.desktop() для обращения к нему. (Заметьте, однако, что hs.application.get'Finder':allWindows() будет включать рабочий стол в возвращаемый список)
• Помимо вышеупомянутых ограничений, эта функция вернёт все окна, как сообщает OSX, включая некоторые "окна", которых вы бы не ожидали: например, каждое окно Google Chrome (фактическое) имеет сопутствующее окно для своей строчки состояния; поэтому вы можете получить неожиданные результаты - в примере Chrome, вызов hs.window.focusWindowSouth() из окна Chrome приведет к "фокусировке" его строчки состояния, а следовательно, и к фактическому окну, что, по-видимому, приведет к ничтожному результату. Чтобы избежать таких сюрпризов, вы можете использовать модуль hs.window.filter, а более конкретно, стандартный модуль фильтрации окон (hs.window.filter.default), который отфильтровывает известные случаи не являющихся окнами
• Некоторые окна не будут сообщаться OSX - например, элементы на разных пространствах или элементы, которые находятся в полноэкранном режиме

Возвращает "окно" рабочего стола

• Нет

• Объект hs.window, представляющий рабочий стол, или nil, если Finder не запущен

• Рабочий стол принадлежит Finder.app: когда Finder является активным приложением, вы можете сфокусироваться на рабочем столе, переключаясь между окнами с помощью cmd-`
• Окно рабочего стола не имеет идентификатора, имеет роль AXScrollArea и не имеет подроли
• Рабочий стол отфильтровывается из hs.window.allWindows() (и последующих использования)

Получение всех невидимых окон

• Нет

• Список, содержащий объекты hs.window, представляющие все окна, которые не видны в соответствии с hs.window:isVisible().

Возвращает все видимые окна, от переднего к заднему

• Нет

• Список hs.window объектов, представляющих все видимые окна, упорядоченные от переднего к заднему

Включает/Отключает тени окон

• shadows - Булево значение, true для отображения теней окон, false для их скрытия

• Нет

• Эта функция использует закрытый, не документированный API вызов OS X, поэтому её работоспособность не гарантируется в будущих версиях OS X

Возвращает снимок окна, указанного по ID, как hs.image объект

• ID - Идентификатор окна, для которого необходимо сделать снимок.
• keepTransparency - необязательное булево значение, указывающее, нужно ли сохранить значение альфа-канала (прозрачность) окна в результирующем изображении, или оно должно быть полностью непрозрачным (по умолчанию).

• hs.image объект снимка окна или nil, если снимок создать не удалось

• См. также метод hs.window:snapshot()
• Поскольку идентификатор окна не всегда может быть определён динамически, эта функция позволит вам предоставить ID окна, который был кэширован ранее.

Устанавливает значение таймаута, используемое в API доступности.

• value - Число секунд для нового значения таймаута.

• true если операция выполнена успешно, иначе false если произошла ошибка.

Получает все видимые окна

• Нет

• Список hs.window объектов, представляющих все видимые окна в соответствии с hs.window:isVisible()

Ищет окна

• hint - критерий поиска желаемого окна(ок); может быть: - числовой идентификатор в соответствии с hs.window:id() - строковый шаблон, который соответствует (через string.find) заголовку окна в соответствии с hs.window:title() (для удобства сопоставление выполняется для строчных строк)

• одно или несколько объектов hs.window, соответствующих предоставленному критерию поиска, или nil если не найдено

• для удобства вы можете вызвать это как hs.window(hint)
• см. также hs.window.get
• для более сложных случаев использования и/или для лучшей производительности, если вы часто вызываете это, рассмотрите использование hs.window.filter

Использование:

-- by id
hs.window(8812):title() --> Hammerspoon Console
-- by title
hs.window'bash':application():name() --> Terminal

Возвращает окно, имеющее фокус клавиатуры/мыши

• Нет

• Объект hs.window, представляющий текущее окно с фокусом

Возвращает окно с фокусом или, если ни одно окно не имеет фокуса, возвращает самое переднее

• Нет

• Объект hs.window, представляющий самое переднее окно, или nil если нет видимых окон

Получает конкретное окно

• hint - критерий поиска желаемого окна; может быть: - числовой идентификатор в соответствии с hs.window:id() - строка с названием окна в соответствии с hs.window:title()

• первый объект hs.window, соответствующий предоставленному критерию поиска, или nil если не найдено

• см. также hs.window.find и hs.application:getWindow()

Получает hs.application объект, к которому принадлежит окно

• Нет

• Объект hs.application, представляющий приложение, которому принадлежит окно, или nil, если произошла ошибка

Делает окно основным окном своего приложения

• Нет

• Объект hs.window

• Преобразование окна в основное не переключает фокус на приложение. См. hs.window.focus()

Центрирует окно на экране

• screen - (необязательно) Объект hs.screen или аргумент для hs.screen.find; если nil, использовать экран, на котором расположено окно
• ensureInScreenBounds - (необязательно) если true, использовать setFrameInScreenBounds() для обеспечения того, чтобы результирующая рамка окна полностью находилась внутри экрана
• duration - (необязательно) Количество секунд для анимации перехода. По умолчанию используется значение hs.window.animationDuration

• Объект hs.window

Закрывает окно

• Нет

• True, если операция выполнена успешно, false - в противном случае

Фокусирует окно

• Нет

• Объект hs.window

Фокусирует вкладку в группе вкладок окна по индексу или последнюю вкладку, если индекс вне границ.

• index - Число, индекс вкладки для фокусировки (с 1)

• true, если вкладка была успешно активирована, или false, если возникла проблема

• Этот метод работает с группами вкладок документа и некоторыми вкладками приложений, такими как Chrome и Safari.

Фокусирует ближайшее возможное окно к востоку (то есть справа).

• candidateWindows - (необязательно) список кандидатов среди окон; если nil, то все видимые окна к востоку являются кандидатами.
• frontmost - (необязательно) логическое значение; если true, то фокусирует ближайшее окно, которое не перекрывается другим окном.
• strict - (необязательно) логическое значение; если true, то рассматриваются только окна под углом между 45° и -45° по оси на восток.

• true если окно было найдено и фокусировано, false в противном случае; nil если поиск не смог пройти

• Если вы не передаёте candidateWindows, Hammerspoon будет каждый раз запрашивать список всех видимых окон, это может быть медленным и некоторые нежелательные «окна» могут быть включены (см. примечания к hs.window.allWindows()); рассмотрите использование эквивалентных методов в hs.window.filter вместо этого.

Фокусирует ближайшее возможное окно к северу (то есть вверх).

• candidateWindows - (необязательно) список кандидатов среди окон; если nil, то все видимые окна к востоку являются кандидатами.
• frontmost - (необязательно) логическое значение; если true, то фокусирует ближайшее окно, которое не перекрывается другим окном.
• strict - (необязательно) логическое значение; если true, то рассматриваются только окна под углом между 45° и -45° по оси на восток.

• true если окно было найдено и фокусировано, false в противном случае; nil если поиск не смог пройти

• Если вы не передаёте candidateWindows, Hammerspoon будет каждый раз запрашивать список всех видимых окон, это может быть медленным и некоторые нежелательные «окна» могут быть включены (см. примечания к hs.window.allWindows()); рассмотрите использование эквивалентных методов в hs.window.filter вместо этого.

Фокусирует ближайшее возможное окно к югу (то есть вниз).

• candidateWindows - (необязательно) список кандидатов среди окон; если nil, то все видимые окна к востоку являются кандидатами.
• frontmost - (необязательно) логическое значение; если true, то фокусирует ближайшее окно, которое не перекрывается другим окном.
• strict - (необязательно) логическое значение; если true, то рассматриваются только окна под углом между 45° и -45° по оси на восток.

• true если окно было найдено и фокусировано, false в противном случае; nil если поиск не смог пройти

• Если вы не передаёте candidateWindows, Hammerspoon будет каждый раз запрашивать список всех видимых окон, это может быть медленным и некоторые нежелательные «окна» могут быть включены (см. примечания к hs.window.allWindows()); рассмотрите использование эквивалентных методов в hs.window.filter вместо этого.

Фокусирует ближайшее возможное окно к западу (то есть слева).

• candidateWindows - (необязательно) список кандидатов среди окон; если nil, то все видимые окна к востоку являются кандидатами.
• frontmost - (необязательно) логическое значение; если true, то фокусирует ближайшее окно, которое не перекрывается другим окном.
• strict - (необязательно) логическое значение; если true, то рассматриваются только окна под углом между 45° и -45° по оси на восток.

• true если окно было найдено и фокусировано, false в противном случае; nil если поиск не смог пройти

• Если вы не передаёте candidateWindows, Hammerspoon будет каждый раз запрашивать список всех видимых окон, это может быть медленным и некоторые нежелательные «окна» могут быть включены (см. примечания к hs.window.allWindows()); рассмотрите использование эквивалентных методов в hs.window.filter вместо этого.

Получает рамку окна в абсолютных координатах.

• None

• Прямоугольник hs.geometry, содержащий координаты верхнего левого угла окна и его ширину и высоту.

Получает уникальный идентификатор окна.

• None

• Число, содержащее уникальный идентификатор окна, или nil, если произошла ошибка.

Получает состояние окна в полноэкранном режиме.

• None

• True, если окно в полноэкранном режиме, false - если нет. Nil, если произошла ошибка.

Определяет, можно ли увеличить окно.

• None

• True, если окно можно увеличить, False - если нельзя, или nil, если произошла ошибка.

Получает состояние минимизированности окна.

• None

• True, если окно минимизировано, иначе false.

Определяет, является ли окно стандартным окном.

• None

• True, если окно стандартное, иначе false.

• «Стандартное окно» означает, что это не необычное всплывающее окно, модальное диалоговое окно, плавающее окно и т. д.

Определяет, является ли окно видимым (то есть не скрыто и не минимизировано).

• None

• true если окно видимое, иначе false

• Это не означает, что пользователь может увидеть окно — оно может быть скрыто другими окнами или находиться за пределами экрана.

Максимизирует окно

• duration - (необязательно) Количество секунд для анимации перехода. По умолчанию используется значение hs.window.animationDuration

• Объект hs.window

• Окно будет увеличено до максимального размера, не скрывая док-панель/меню

Минимизирует окно

• Нет

• Объект hs.window

• Этот метод всегда выполняется с анимацией в соответствии с настройками вашей системы и не зависит от hs.window.animationDuration

Перемещает окно

• rect - Может быть: - точкой hs.geometry, или аргументом для её создания; перемещает экран на это смещение, сохраняя его размер постоянным; screen игнорируется - прямоугольником hs.geometry, или аргументом для его создания; устанавливает рамку окна на этот прямоугольник в абсолютных координатах; screen игнорируется - прямоугольником hs.geometry единиц, или аргументом для его создания; устанавливает рамку окна на этот прямоугольник относительно желаемого экрана; если screen имеет значение nil, используется экран, на котором находится окно в настоящее время
• screen - (необязательно) Объект hs.screen или аргумент для hs.screen.find; допустимо только если rect является прямоугольником единиц
• ensureInScreenBounds - (необязательно) если true, используйте setFrameInScreenBounds() для обеспечения того, чтобы полученная рамка окна полностью находилась внутри экрана окна
• duration - (необязательно) Количество секунд для анимации перехода. По умолчанию используется значение hs.window.animationDuration

• Объект hs.window

Получает роль окна

• Нет

• Строка, содержащая роль окна

Получает экран, на котором находится окно

• Нет

• Объект hs.screen , представляющий экран, содержащий окно.

• Хотя окна можно перетащить для отображения на нескольких экранах, часть окна исчезнет при отпускании мыши. Экран, возвращаемый этим методом, будет соответствовать части окна, которая останется видимой.

Отправляет окно назад

• Нет

• Объект hs.window

• Из-за способа работы этого метода и ограничений OSX, вызов этого метода при большом количестве случайным образом перекрывающих (в отличие от аккуратно разложенных) окон может быть визуально резким и потребовать значительного времени для завершения. Поэтому, если вы не используете упорядоченные макеты или у вас много окон в целом, вам, вероятно, лучше использовать hs.application:hide() (или просто cmd-h)
• Этот метод работает путем фокусировки всех перекрывающих окон позади данного окна, спереди назад. Если этот метод вызван для фокусированного окна, фокус переключится на верхнее окно под этим; в противном случае текущее фокусированное окно получит фокус после того, как данное окно будет отправлено назад.

Устанавливает кадр окна в абсолютных координатах

• rect - прямоугольник hs.geometry или аргумент конструктора, описывающий кадр, который должен быть применен к окну
• duration - (необязательно) Количество секунд для анимации перехода. По умолчанию используется значение hs.window.animationDuration

• Объект hs.window

Устанавливает кадр окна в абсолютных координатах, возможно, скорректированный для обеспечения его полного расположения внутри экрана

• rect - прямоугольник hs.geometry или аргумент конструктора, описывающий кадр, который должен быть применён к окну; если опущен, будет использован текущий кадр окна
• duration - (необязательно) Количество секунд для анимации перехода. По умолчанию используется значение hs.window.animationDuration

• Объект hs.window

Устанавливает кадр окна в абсолютных координатах, используя дополнительные обходные пути, описанные в hs.window.setFrameCorrectness

• rect - прямоугольник hs.geometry или аргумент конструктора, описывающий кадр, который должен быть применен к окну
• duration - (необязательно) Количество секунд для анимации перехода. По умолчанию используется значение hs.window.animationDuration

• Объект hs.window

Устанавливает полноэкранный режим окна

• fullscreen - логическое значение, true, если окно должно быть полноэкранным, false — если нет

• Объект hs.window

Изменяет размер окна

• size - таблица размеров, содержащая ширину и высоту, до которых должно быть изменено окно

• Объект hs.window

Перемещает окно в заданную точку

• point - таблица координат, содержащая абсолютные координаты, в которые должно быть перемещено окно

• Объект hs.window

Получает размер окна

• Нет

• Таблица размеров, содержащая ширину и высоту окна

Возвращает снимок окна как объект hs.image

• keepTransparency - необязательное булево значение, указывающее, следует ли сохранять значение альфа-канала окна (прозрачность) на полученном изображении или если оно должно быть полностью непрозрачным (по умолчанию).

• Объект hs.image снимка окна или nil, если создание снимка невозможно

• См. также функцию hs.window.snapshotForID()

Получает подроль окна

• Нет

• Строка, содержащая подроль окна

• Это обычно помогает определить, является ли окно особым типом окна, например, модальным окном или плавающим окном

Получает количество вкладок в окне

• Нет

• Число, содержащее количество вкладок, или nil, если произошла ошибка

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

Получает заголовок окна

• Нет

• Строка, содержащая заголовок окна

Переключает полноэкранный режим окна

• Нет

• Объект hs.window

• Не все окна поддерживают полноэкранный режим

Переключает режим масштабирования окна (это эквивалентно нажатию на зеленую кнопку максимизации/полноэкранного режима в левом верхнем углу окна)

• Нет

• Объект hs.window

Получает абсолютные координаты левого верхнего угла окна

• Нет

• Таблица точек, содержащая абсолютные координаты левого верхнего угла окна

Выводит окно из минимизированного состояния

• Нет

• Объект hs.window

Получает все окна, расположенные к востоку от текущего окна

• candidateWindows - (необязательно) список кандидатов среди окон; если nil, кандидатами будут все видимые окна к востоку.
• frontmost - (необязательно) булево значение, если true, неокклюдированные окна будут размещены перед окклюдированными в списке результатов.
• strict - (необязательно) булево значение, если true, будут учитываться только окна под углом между 45° и -45° по оси на восток

• Список объектов hs.window, представляющих все окна, расположенные к востоку (справа) от текущего окна, в порядке возрастания расстояния

• Если вы не передаете candidateWindows, Hammerspoon будет запрашивать список всех видимых окон каждый раз при вызове этого метода; это может быть медленным, и могут быть включены некоторые нежелательные "окна" (см. примечания к hs.window.allWindows()); рассмотрите возможность использования эквивалентных методов в hs.window.filter вместо этого

Получает все окна, расположенные к северу от текущего окна

• candidateWindows - (необязательно) список кандидатов среди окон; если nil, кандидатами будут все видимые окна к северу.
• frontmost - (необязательно) булево значение, если true, неокклюдированные окна будут размещены перед окклюдированными в списке результатов.
• strict - (необязательно) булево значение, если true, будут учитываться только окна под углом между 45° и -45° по оси на север

• Список объектов hs.window, представляющих все окна, расположенные к северу (вверх) от текущего окна, в порядке возрастания расстояния

• Если вы не передаете candidateWindows, Hammerspoon будет запрашивать список всех видимых окон каждый раз при вызове этого метода; это может быть медленным, и могут быть включены некоторые нежелательные "окна" (см. примечания к hs.window.allWindows()); рассмотрите возможность использования эквивалентных методов в hs.window.filter вместо этого

Получает все окна, расположенные к югу от текущего окна

• candidateWindows - (необязательно) список кандидатов среди окон; если nil, кандидатами будут все видимые окна к югу.
• frontmost - (необязательно) булево значение, если true, неокклюдированные окна будут размещены перед окклюдированными в списке результатов.
• strict - (необязательно) булево значение, если true, будут учитываться только окна под углом между 45° и -45° по оси на юг

• Список объектов hs.window, представляющих все окна, расположенные к югу (вниз) от текущего окна, в порядке возрастания расстояния

• Если вы не передаете candidateWindows, Hammerspoon будет запрашивать список всех видимых окон каждый раз при вызове этого метода; это может быть медленным, и могут быть включены некоторые нежелательные "окна" (см. примечания к hs.window.allWindows()); рассмотрите возможность использования эквивалентных методов в hs.window.filter вместо этого

Получает все окна, расположенные к западу от текущего окна

• candidateWindows - (необязательно) список кандидатов среди окон; если nil, кандидатами будут все видимые окна к западу.
• frontmost - (необязательно) булево значение, если true, неокклюдированные окна будут размещены перед окклюдированными в списке результатов.
• strict - (необязательно) булево значение, если true, будут учитываться только окна под углом между 45° и -45° по оси на запад

• Список объектов hs.window, представляющих все окна, расположенные к западу (слева) от текущего окна, в порядке возрастания расстояния

• Если вы не передаете candidateWindows, Hammerspoon будет запрашивать список всех видимых окон каждый раз при вызове этого метода; это может быть медленным, и могут быть включены некоторые нежелательные "окна" (см. примечания к hs.window.allWindows()); рассмотрите возможность использования эквивалентных методов в hs.window.filter вместо этого

Получает прямоугольник-таблицу для расположения кнопки масштабирования (зеленая кнопка, обычно в левом верхнем углу окна)

• Нет

• Прямоугольник-таблица, содержащая рамку области кнопки масштабирования, или nil в случае ошибки

• Координаты в таблице прямоугольника (т.е. значения x и y) указаны в абсолютных координатах, а не относительно окна, к которому принадлежит кнопка, или экрана, на котором расположено окно
• Хотя не идеально, этот метод может предоставить полезный способ найти область titlebar, подходящую для имитации событий щелчка мыши, с помощью hs.eventtap