User Commands

ИМЯ

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 для показа прав на копирование.

 User Commands