Standards, Environments and Macros

ИМЯ

icewm-winoptions - конфигурационный файл параметров окон IceWM

СИНОПСИС

$ICEWM_PRIVCFG/winoptions
$XDG_CONFIG_HOME/icewm/winoptions
$HOME/.icewm/winoptions
/etc/icewm/winoptions
/usr/share/icewm/winoptions

ОПИСАНИЕ

Файл IceWM winoptions содержит настройки управления внешним видом и поведением окон конкретных приложений. Например, они управляют границей окна, расположением и размером, уровнем слоя окна, рабочим местом, видимостью на панели задач и поведением фокуса.

Параметры окон устанавливаются при старте icewm(1). Однако, они могут быть впоследствии перекрыты использованием icesh(1) или icewmhint(1). Команда icesh winoptions даёт инструкцию icewm перечитать файл winoptions, в то время, как icewmhint точнее настраивает поведение при запуске конкретных приложений.

ФОРМАТ

Каждая строка в файле должна быть в одном из следующих форматов:

Здесь NAME и CLASS являются частями свойства WM_CLASS окна. Они могут быть найдены в выводе icesh -a getClass.

В то же время ROLE относится к свойству WM_WINDOW_ROLE окна, которое, это экземпляр приложения с определённым именем. Только малая часть окон имеет его. См. вывод icesh -a list prop WM_WINDOW_ROLE.

В редких случаях, NAME, CLASS или ROLE могут содержать период (.). Если это произошло, период должен быть экранирован одиночным символом обратного слэша (\).

Наконец, пара OPTION: VALUE относится к параметрам и значениям, описанным ниже. Строка с просто точкой, за которой следует пара параметр/значение, применяется ко всем окнам.

ПАРАМЕТРЫ

Среди них четыре категории: общие, функциональности, оформления и особые.

ОБЩИЕ ПАРАМЕТРЫ

Эти параметры управляют общими характеристиками окон:

icon: NAME (по умолчанию: отсутствует)

Определяет имя значка для окна. NAME это имя значка, как utilities-terminal. Это также может быть файл, как xterm.png, полный путь, или путь без размеров или суффикса.

workspace: WORKSPACE (по умолчанию: текущее)

Определяет рабочее место по умолчанию для окна. WORKSPACE это номер рабочего места считая от нуля (0).

layer: {LAYER|NUMBER} (по умолчанию: Normal)

Определяет слой по умолчанию для окна. Layer может быть значением одной из следующих имён или числом от нуля до пятнадцати:

Desktop     (0)  Окно рабочего стола.
Below       (2)  Ниже слоя по умолчанию.
Normal      (4)  Слой по умолчанию для окон.
OnTop       (6)  Выше слоя по умолчанию.
Dock        (8)  Окна, пристыкованные к краю экрана.
AboveDock  (10)  Окна выше Дока.
Menu       (12)  Слой для меню.
Fullscreen (14)  Когда полный экран и получен фокус.
AboveAll   (15)  Всегда выше всех.
geometry geometry (по умолчанию: свойство WM_SIZE_HINTS)

Геометрия по умолчанию для окон. Эта геометрия должна быть определена в том формате, который разбирает XParseGeometry(3):

[=][<width>{xX}<height>][{+-}<xoffset>{+-}<yoffset>]

Геометрия по умолчанию берётся из свойства WM_SIZE_HINTS окна или, иначе, из начальной геометрии окна. Этот параметр перекрывает умолчание.

tray: {Ignore|Minimized|Exclusive|NUMBER} (по умолчанию: 0)

Параметр по умолчанию системного лотка. Он влияет и на системный лоток, и на панель задач. Tray может быть значением одной из трёх следующих строк или числом от нуля (0) до двух (2):

  Ignore     (0)  Не добавлять значок в системный лоток.
  Minimized  (1)  Добавить в системный лоток, нет кнопки задачи, когда окно
свёрнуто.
  Exclusive  (2)  Добавить в системный лоток, нет кнопки задачи.
order: NUMBER (по умолчанию: 0)

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

opacity: NUMBER (по умолчанию: 0)

Устанавливает свойство _NET_WM_WINDOW_OPACITY, если NUMBER это значение между 1 и 100. NUMBER интерпретируется как процентное отношение к максимальной прозрачности.

keyboard: layout (по умолчанию: отсутствует)

Определяет раскладку клавиатуры, используемую для этого окна. layout является именем раскладки клавиатуры. Это может быть разделённый пробелами список аргументов программы setxkbmap. Пожалуйста, заметьте, что setxkbmap должна быть установлена, чтобы это работало. Также определите раскладку клавиатуры по умолчанию в prefernces.

frame: label (по умолчанию: отсутствует)

Все окна с той же самой меткой рамки станут вкладками в одной рамке.

ПАРАМЕТРЫ ФУНКЦИОНАЛЬНОСТИ

Параметры функциональности включают/выключают (1/0) способность совершать действия над окнами. Нормальное умолчание для всех параметов это включено (1), если не будет перекрыто приложением. Определены следующие параметры:

fClose:    {0|1}  может быть закрыто.            (по умолчанию: 1)
fHide:     {0|1}  может быть скрыто.             (по умолчанию: 1)
fMaximize: {0|1}  может быть развёрнуто.         (по умолчанию: 1)
fMinimize: {0|1}  может быть свёрнуто.           (по умолчанию: 1)
fMove:     {0|1}  может быть перемещено.         (по умолчанию: 1)
fResize:   {0|1}  может быть изменён размер.     (по умолчанию: 1)
fRollup:   {0|1}  может быть скручено.           (по умолчанию: 1)

ПАРАМЕТРЫ ОФОРМЛЕНИЯ

Параметры оформления включают/выключают (1/0) оформление окон. Нормальное умолчание для всех параметров это включено (1), если не будет перекрыто приложением или темой:

dBorder:   {0|1}  имеет рамку.                   (по умолчанию: 1)
dClose:    {0|1}  имеет кнопку закрытия.         (по умолчанию: 1)
dDepth:    {0|1}  имеет кнопку глубины.          (по умолчанию: 1)
dHide:     {0|1}  имеет кнопку скрытия.          (по умолчанию: 1)
dMaximize: {0|1}  имеет кнопку развёртывания.    (по умолчанию: 1)
dMinimize: {0|1}  имеет кнопку свёртывания.      (по умолчанию: 1)
dResize:   {0|1}  имеет ручку изменения размера. (по умолчанию: 1)
dRollup:   {0|1}  имеет кнопку скручивания.      (по умолчанию: 1)
dSysMenu:  {0|1}  имеет меню окна.               (по умолчанию: 1)
dTitleBar: {0|1}  имеет панель заголовка.        (по умолчанию: 1)

ОСОБЫЕ ПАРАМЕТРЫ

Особые параметры включают/выключают (1/0) дополнительные особенности окон. Нормальное умолчание для всех параметров это выключено (0), если не будет перекрыто приложением:

allWorkspaces:            {1|0}  видно на всех рабочих местах.
appTakesFocus:            {1|0}  позволить приложению забрать фокус.
doNotCover:               {1|0}  ограничить рабочее пространство, если прилеплено.
doNotFocus:               {1|0}  не давать фокус.
doNotManage:              {1|0}  не управлять.
forcedClose:              {1|0}  не подтверждать закрытие.
fullKeys:                 {1|0}  не устанавливать привязки клавиш icewm.
ignoreNoFocusHint:        {1|0}  дать фокус, даже если не поддерживает ввод.
ignorePagerPreview:       {1|0}  не показывать миниатюру на пейджере.
ignorePositionHint:       {1|0}  разрешить icewm располагать окно самостоятельно.
ignoreQuickSwitch:        {1|0}  не показывать в быстром переключении.
ignoreTaskBar:            {1|0}  не показывать на панели задач.
ignoreUrgentHint:         {1|0}  игнорировать свойство срочности.
ignoreWinList:            {1|0}  не показывать в списке окон.
ignoreActivationMessages: {1|0}  только пользователь может дать фокус окну.
ignoreOverrideRedirect:   {1|0}  игнорировать флаг перекрытия редиректа.
noFocusOnAppRaise:        {1|0}  не давать автоматически фокус при поднятии.
noFocusOnMap:             {1|0}  не давать фокус при создании.
noIgnoreTaskBar:          {1|0}  всегда показывать на панели задач.
startClose:               {1|0}  закрыть окно немедленно.
startFullscreen:          {1|0}  запустить на весь экран.
startMaximized:           {1|0}  запустить развёрнутым.
startMaximizedHorz:       {1|0}  запустить развёрнутым горизонтально.
startMaximizedVert:       {1|0}  запустить развёрнутым вертикально.
startMinimized:           {1|0}  запустить свёрнутым.

ПРИМЕРЫ

Этот пример использует значение pop-up свойства WM_WINDOW_ROLE для запрещения фокуса ввода всплывающих окон Chrome и запроса на немедленное закрытие их.

google-chrome.pop-up.doNotFocus: 1
google-chrome.pop-up.forcedClose: 1
google-chrome.pop-up.ignorePagerPreview: 1
google-chrome.pop-up.ignoreUrgentHint: 1
google-chrome.pop-up.layer: Below
google-chrome.pop-up.noFocusOnAppRaise: 1
google-chrome.pop-up.noFocusOnMap: 1
google-chrome.pop-up.startClose: 1
google-chrome.pop-up.startMinimized: 1

IceWM поместит докаппы в контейнер автоматически, но для тех, которые не следуют протоколу, это также может быть эмулировано. Эмулированный докапп должен появиться на всех рабочих местах, не имеют оформления, и всегда будет виден в фиксированном положении.

wmtime.wmtime.allWorkspaces: 1
wmtime.wmtime.ignoreTaskBar: 1
wmtime.wmtime.ignoreQuickSwitch: 1
wmtime.wmtime.ignoreWinList: 1
wmtime.wmtime.layer: Below
wmtime.wmtime.dTitleBar: 0
wmtime.wmtime.dBorder: 1
wmtime.wmtime.geometry: 64x64-74-100

Далее показано, как сформировать отображение приложения, предназначенного только для вывода, без панели заголовка и с минимальной функциональностью.

xeyes.tray: Exclusive
xeyes.ignoreWinList: 0
xeyes.ignoreTaskBar: 1
xeyes.allWorkspaces: 1
xeyes.dTitleBar: 0
xeyes.dBorder: 0
xeyes.dSysMenu: 0
xeyes.dResize: 0
xeyes.dClose: 0
xeyes.dMinimize: 0
xeyes.dMaximize: 0

ФАЙЛЫ

Местоположения для файла winoptions могут быть следующими:

$ICEWM_PRIVCFG/winoptions
$XDG_CONFIG_HOME/icewm/winoptions
$HOME/.icewm/winoptions
/etc/icewm/winoptions
/usr/share/icewm/winoptions

Местоположения просматриваются в указанном порядке; первый найденный файл прочитывается и остальные игнорируются.

СМ. ТАКЖЕ

icewm(1), icesh(1), icewmhint(1), setxkbmap(1), XParseGeometry(3).

АВТОР

Brian Bidulock <bidulock@openss7.org>.

ПЕРЕВОД

Перевод данного текста на русский язык, а также поддержка пакета программного обеспечения icewm в ALTLinux Dmitriy Khanzhin <jinn@altlinux.org>.

ЛИЦЕНЗИЯ

IceWM лицензирован под GNU Library General Public License. См. файл COPYING в комплекте поставки.

 Standards, Environments and Macros