icewmhint(1)
| ICEWMHINT(1) | User Commands | ICEWMHINT(1) |
ИМЯ
icewmhint - устанавливает рекомендации (hints) IceWM через класс и экземпляр окна
СИНОПСИС
icewmhint CLASS.INSTANCE OPTION VALUE ...
ОПИСАНИЕ
icewmhint это утилита для передачи рекомендаций IceWM к icewm(1). icewm использует эти рекомендации для первого же впоследствии запущенного клиента X11. Они имеют приоритет над рекомендациями из файла icewm-winoptions(1).
Рекомендация это триплет, состоящий из class.instance, параметра окна IceWM и его значения. Посредством вызова icewmhint может быть дано несколько рекомендаций.
Рекомендации передаются через свойство "_ICEWM_WINOPTHINT" на корневом окне. icewmhint добавляет рекомендации к этому свойству, причём icewm удаляет свойство после его прочтения.
ПАРАМЕТРЫ
icewmhint распознаёт следующие параметры:
ПАРАМЕТРЫ КОМАНДЫ
Только один параметр команды может быть определён при вызове. Если параметр команды не задан, выполняется разбор и обработка аргумента.
- -h, --help
- Напечатать краткую справку по использованию на stdout и выйти.
- -V, --version
- Напечатать версию программы на stdout и выйти.
- -C, --copying
- Напечатать права на копирование для программы на stdout и выйти.
ОБЩИЕ ПАРАМЕТРЫ
- -d, --display=DISPLAY
- Определяет X11 DISPLAY. Если не определено, по умолчанию $DISPLAY.
АРГУМЕНТЫ
Следующие три аргумента требуются для каждой рекомендации.
- CLASS.INSTANCE
- Определяет свойство ICCCM 2.0 WM_CLASS в терминах класс ресурса и имя ресурса, разделёнными периодом ("."). Например: "XTerm.xterm". Просто класс ресурса или имя ресурса без точки, как "XTerm" or "xterm", также допустимы.
- OPTION
- Определяет параметр OPTION для воздействия.
- VALUE
- Задаёт значение VALUE для OPTION.
Может быть дано несколько рекомендаций.
АРГУМЕНТЫ ОБЩИХ ПАРАМЕТРОВ
- icon NAME
- Определяет имя значка для окон CLASS.INSTANCE. NAME должно быть именем значка. icewm(1) будет использовать свой обычный метод поиска значка. По умолчанию это имя, предоставляемое рекомендациями диспетчера окон.
- workspace WORKSPACE
- Определяет рабочее место, на котором окно с CLASS.INSTANCE будет изначально размещено. По умолчанию это текущее рабочее место. WORKSPACE должно быть номером рабочего места, считая от 0.
- geometry GEOMETRY
- Определяет начальную геометрию для окон данного CLASS.INSTANCE. GEOMETRY должна быть геметрией, которая может быть разобрана XParseGeometry(3). По умолчанию это геометрия, предоставляемая рекомендациями диспетчера окон.
- order NUMBER
- Порядок сортировки кнопок задач и значков лотка. Значение по умолчанию это ноль. Увеличение положительных значений сдвигает вправо, а уменьшение отрицательных значений сдвигает влево. Параметр order применяется к панели задач, панели лотка и системному лотку.
- opacity NUMBER
- Устанавливает свойство _NET_WM_WINDOW_OPACITY, если NUMBER это значение между 0 и 100. NUMBER интерпретируется как процентное отношение к максимальной непрозрачности.
- layer {LAYER|NUMBER}
- Этот
параметр
команды
определяет
слой,
который
будет
связан с
CLASS.INSTANCE. По
умолчанию
это слой
"Normal". VALUE
это либо
номер слоя,
либо
символьное
имя слоя.
Символьными
именами
слоёв
являются:
Desktop (0) Окно рабочего стола. Below (2) Ниже обычных окон. Normal (4) Слой по умолчанию для окон. OnTop (6) Выше обычных окон. Dock (8) Окна, пристыкованные к краю экрана. AboveDock (10) Окна выше доков. Menu (12) Слой для меню. Fullscreen (14) Когда полный экран и выдан фокус. AboveAll (15) Всегда выше всех. - tray {Ignore|Minimized|Exclusive|NUMBER}
- Определяет
поддержку
лотка в
применении
к окнам с
CLASS.INSTANCE. Этот
параметр
специфичен
для icewm(1) и
устанавливает
свойство
"_ICEWM_TRAY",
связанное
с окном. По
умолчанию
это "Ignore".
VALUE может
быть номер
параметра
или
символьное
имя из
следующих:
Ignore (0) только в списке задач. Minimized (1) значок в лотке, в списке задач находится, когда не свёрнуто. Exclusive (2) только в лотке, нет в списке задач. - frame label (по умолчанию: отсутствует)
- Все окна с той же самой меткой рамки станут вкладками единственной рамки.
АРГУМЕНТЫ ПАРАМЕТРОВ ФУНКЦИОНАЛЬНОСТИ
Определяют, какая функциональность выключена или включена (0/1) для окон с CLASS.INSTANCE. Все функции имеют значение по умолчанию "включено" (1), если не будет перекрыто приложением. Похожими на Motif функциями окна являются следующие:
fClose может быть закрыто: (по умолчанию: 1).
fHide может быть скрыто: (по умолчанию: 1).
fMaximize может быть развёрнуто: (по умолчанию: 1).
fMinimize может быть свёрнуто: (по умолчанию: 1).
fMove может быть перемещено: (по умолчанию: 1).
fResize может быть изменён размер: (по умолчанию: 1).
fRollup может быть скручено: (по умолчанию: 1).
АРГУМЕНТЫ ПАРАМЕТРОВ ОФОРМЛЕНИЯ
Определяют, какое оформление выключено или включено (0/1) для окон с CLASS.INSTANCE. Все параметры оформления имеют значение по умолчанию "включено" (1), если не будет перекрыто приложением. Похожее на Motif оформление окна следующее:
dBorder имеет рамку: (по умолчанию: 1).
dClose имеет кнопку закрытия: (по умолчанию: 1).
dDepth имеет кнопку глубины: (по умолчанию: 1).
dHide имеет кнопку скрытия: (по умолчанию: 1).
dMaximize имеет кнопку развёртывания: (по умолчанию: 1).
dMinimize имеет кнопку свёртывания: (по умолчанию: 1).
dResize имеет ручки изменения размера: (по умолчанию: 1).
dRollup имеет кнопку скручивания: (по умолчанию: 1).
dSysMenu имеет меню окна: (по умолчанию: 1).
dTitleBar имеет панель заголовка: (по умолчанию: 1).
АРГУМЕНТЫ ОСОБЫХ ПАРАМЕТРОВ
Определяют, какая дополнительная функциональность будет включена/выключена (1/0) для окон с CLASS.INSTANCE. Вся дополнительная функциональность имеет значение по умолчанию "выключено" (0), если не будет перекрыто приложением. Дполнительной функциональностью окна является следующая:
allWorkspaces видно на всех рабочих местах.
appTakesFocus позволить приложению забрать фокус.
doNotCover ограничить рабочее пространство, если прилеплено.
doNotFocus не давать фокус.
doNotManage не управлять.
forcedClose не подтверждать закрытие.
fullKeys предоставить больше клавиш.
ignoreNoFocusHint дать фокус, даже если не поддерживает ввод.
ignorePagerPreview не показывать миниатюру на пейджере.
ignorePositionHint располагать автоматически.
ignoreQuickSwitch не показывать в быстром переключении.
ignoreTaskBar не показывать на панели задач.
ignoreUrgentHint игнорировать свойство срочности.
ignoreWinList не показывать в списке окон.
ignoreActivationMessages только пользователь может дать фокус окну.
ignoreOverrideRediect игнорировать флаг перекратия перенаправления.
noFocusOnAppRaise не давать фокус при поднятии.
noFocusOnMap не давать фокус при создании.
noIgnoreTaskBar показать на панели задач.
startClose закрыть окно немедленно.
startFullscreen запустить на весь экран.
startMaximized запустить развёрнутым.
startMaximizedHorz запустить развёрнутым горизонтально.
startMaximizedVert запустить развёрнутым вертикально.
startMinimized запустить свёрнутым.
ПРИМЕР
# Вот как предварительно загрузить невидимый фоновый процесс chromium
# на четвёртом рабочем месте, который виден только в Списке Окон.
icewmhint Chromium-browser startMinimized 1 \
Chromium-browser workspace 3 \
Chromium-browser ignorePagerPreview 1 \
Chromium-browser ignorePositionHint 1 \
Chromium-browser ignoreTaskBar 1 \
Chromium-browser ignoreQuickSwitch 1 \
Chromium-browser ignoreUrgentHint 1 \
Chromium-browser noFocusOnAppRaise 1
chromium
ОШИБКИ
Пожалуйста, сообщайте об ошибках на <https://github.com/bbidulock/icewm/issues>.
АВТОР
Brian Bidulock <bidulock@openss7.org>.
См. --copying для получения полной информации об авторских правах и правах на копирование.
ПЕРЕВОД
Перевод данного текста на русский язык, а также поддержка пакета программного обеспечения icewm в ALTLinux Dmitriy Khanzhin <jinn@altlinux.org>.
ЛИЦЕНЗИЯ
IceWM лицензирован под GNU Library General Public License. См. файл COPYING в комплекте поставки или используйте флаг --copying для показа прав на копирование.
| 2025-04-26 | icewm 3.7.4 |