ICEWMHINT(1) User Commands ICEWMHINT(1)

icewmhint - ارسال نشانه‌ها و ویژگی‌های پنجره به مدیر پنجره IceWM

icewmhint CLASS.INSTANCE OPTION VALUE ...

icewmhint ابزاری برای ارسال نشانه‌ها و ویژگی‌های پنجره (hints) در IceWM به icewm(1) است. icewm از این نشانه‌ها برای نخستین کلاینت X11 که متعاقباً اجرا می‌شود استفاده می‌کند. این تنظیمات بر نشانه‌های موجود در پرونده icewm-winoptions(1) اولویت دارند.

هر نشانه یک سه‌تایی متشکل از class.instance، یک IceWM winoption و مقدار آن است. در هر بار اجرای icewmhint می‌توان چندین نشانه را مشخص کرد.

نشانه‌ها از طریق ویژگی "_ICEWM_WINOPTHINT" روی پنجره ریشه (root window) منتقل می‌شوند. icewmhint نشانه‌ها را به این ویژگی اضافه می‌کند، در حالی که icewm پس از خواندن ویژگی، آن را حذف می‌کند.

icewmhint گزینه‌های زیر را می‌شناسد:

در هر بار اجرا فقط می‌توان یک گزینه دستوری را مشخص کرد. اگر هیچ گزینه دستوری مشخص نشود، تجزیه و پردازش آرگومان‌ها انجام می‌شود.

نمایش خلاصه راهنمای استفاده در خروجی استاندارد (stdout) و خروج.
نمایش نسخه برنامه در خروجی استاندارد (stdout) و خروج.
نمایش مجوزهای رونوشت‌برداری و حق نشر برنامه در خروجی استاندارد (stdout) و خروج.

مشخص کردن DISPLAY در X11. در صورت عدم تعیین، مقدار پیش‌فرض $DISPLAY خواهد بود.

سه آرگومان زیر برای هر نشانه الزامی هستند.

ویژگی WM_CLASS در استاندارد ICCCM 2.0 را بر حسب کلاس منبع و نام منبع که با نقطه (".") جدا شده‌اند مشخص می‌کند. به عنوان مثال: "XTerm.xterm". فقط کلاس منبع یا نام منبع بدون نقطه نیز قابل قبول است، مانند "XTerm" یا "xterm".
گزینه (OPTION) مورد نظر برای اعمال تغییر را مشخص می‌کند.
مقدار (VALUE) را برای گزینه تعیین می‌کند.

می‌توان چندین نشانه را مشخص کرد.

نام آیکون پنجره‌های مربوط به CLASS.INSTANCE را مشخص می‌کند. NAME باید نام آیکون باشد. icewm(1) از روش معمول خود برای یافتن آیکون استفاده خواهد کرد. مقدار پیش‌فرض، نام ارائه‌شده توسط نشانه‌های مدیر پنجره است.
فضای کاری که پنجره CLASS.INSTANCE در ابتدا در آن قرار می‌گیرد را مشخص می‌کند. پیش‌فرض، فضای کاری جاری است. WORKSPACE باید شماره فضای کاری با شروع از 0 باشد.
ابعاد و موقعیت هندسی اولیه را برای پنجره‌های CLASS.INSTANCE داده‌شده مشخص می‌کند. GEOMETRY باید مقداری قابل تجزیه توسط XParseGeometry(3) باشد. پیش‌فرض، ابعاد و موقعیت ارائه‌شده توسط نشانه‌های مدیر پنجره است.
ترتیب مرتب‌سازی دکمه‌های نوار وظیفه و آیکون‌های سینی سیستم. مقدار پیش‌فرض صفر است. مقادیر مثبت بزرگ‌تر موقعیت را به سمت راست‌تر و مقادیر منفی کوچک‌تر موقعیت را به سمت چپ‌تر می‌برند. گزینه order بر پانل وظایف، پانل سینی و سینی سیستم اعمال می‌شود.
اگر NUMBER مقداری بین 1 و 100 باشد، ویژگی _NET_WM_WINDOW_OPACITY را تنظیم می‌کند. NUMBER به عنوان درصد حداکثر مات بودن تفسیر می‌شود.
این گزینه لایه مرتبط با CLASS.INSTANCE را مشخص می‌کند. مقدار پیش‌فرض لایه "Normal" است. VALUE می‌تواند شماره لایه یا نام نمادین آن باشد. نام‌های نمادین لایه‌ها عبارتند از:
Desktop     (0)  Desktop window.
Below       (2)  Below the default layer.
Normal      (4)  Default layer for windows.
OnTop       (6)  Above the default layer.
Dock        (8)  Docked windows at edge of screen.
AboveDock  (10)  Windows above the dock.
Menu       (12)  The layer for menu's.
Fullscreen (14)  When fullscreen and focused.
AboveAll   (15)  Always above anything.
رفتار سینی سیستم را برای پنجره‌های با CLASS.INSTANCE مشخص می‌کند. این گزینه مختص icewm(1) بوده و ویژگی "_ICEWM_TRAY" مرتبط با پنجره را تنظیم می‌کند. پیش‌فرض "Ignore" است. VALUE می‌تواند شماره گزینه یا یک نام نمادین به صورت زیر باشد:
Ignore     (0)  only in task list.
Minimized  (1)  icon in tray, task list unminimized.
Exclusive  (2)  only in tray, not in task list.
تمام پنجره‌های دارای برچسب فریم یکسان، به صورت زبانه‌ها در یک فریم واحد قرار می‌گیرند.

مشخص می‌کند کدام عملکردها برای پنجره‌های با CLASS.INSTANCE غیرفعال یا فعال (0/1) هستند. تمام عملکردها به صورت پیش‌فرض فعال (1) هستند مگر اینکه توسط برنامه لغو شوند. عملکردهای شبیه به Motif به شرح زیر هستند:

fClose     can be closed:        (default: 1).
fHide      can be hidden:        (default: 1).
fMaximize  can be maximized:     (default: 1).
fMinimize  can be minimized:     (default: 1).
fMove      can be moved:         (default: 1).
fResize    can be resized:       (default: 1).
fRollup    can be shaded:        (default: 1).

مشخص می‌کند کدام تزئینات ظاهری برای پنجره‌های با CLASS.INSTANCE غیرفعال یا فعال (0/1) هستند. تمام گزینه‌های تزئینات دارای مقدار پیش‌فرض فعال (1) هستند مگر اینکه توسط برنامه لغو شوند. تزئینات شبیه به Motif به شرح زیر هستند:

dBorder    has border:           (default: 1).
dClose     has close button:     (default: 1).
dDepth     has depth button:     (default: 1).
dHide      has hide button:      (default: 1).
dMaximize  has maximize button:  (default: 1).
dMinimize  has minimize button:  (default: 1).
dResize    has resize grips:     (default: 1).
dRollup    has shade button:     (default: 1).
dSysMenu   has window menu:      (default: 1).
dTitleBar  has title bar:        (default: 1).

مشخص می‌کند کدام قابلیت‌های پیشرفته برای پنجره‌های با CLASS.INSTANCE فعال/غیرفعال (1/0) شوند. تمام قابلیت‌های پیشرفته دارای مقدار پیش‌فرض غیرفعال (0) هستند مگر اینکه توسط برنامه لغو شوند. قابلیت‌های پیشرفته عبارتند از:

allWorkspaces             on all workspaces.
appTakesFocus             let application take focus.
doNotCover                limits workspace if sticky.
doNotFocus                do not focus.
doNotManage               do not manage.
forcedClose               no close dialog.
fullKeys                  provided more keys.
ignoreNoFocusHint         focus even no-input.
ignorePagerPreview        do not show in pager preview.
ignorePositionHint        place automatically.
ignoreQuickSwitch         not on quick switch.
ignoreTaskBar             not on task bar.
ignoreUrgentHint          ignore urgent hints.
ignoreWinList             not on window list.
ignoreActivationMessages  only user can focus window.
ignoreOverrideRedirect    ignore the override redirect flag.
ignoreUserTime:           ignore wm_user_time and startup_id.
noFocusOnAppRaise         no focus on raise.
noFocusOnMap              do not focus when mapped.
noIgnoreTaskBar           on task bar.
startClose                close the window immediately.
startFullscreen           start full screen.
startMaximized            start maximized.
startMaximizedHorz        start maximized horizontal.
startMaximizedVert        start maximized vertical.
startMinimized            start minimized.

# بارگذاری اولیه یک پردازش نامرئی پس‌زمینه از 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/ice-wm/icewm/issues گزارش دهید.

Brian Bidulock <mailto:bidulock@openss7.org>.

برای آگاهی از اعلامیه کامل حق نشر و مجوزهای رونوشت‌برداری، گزینه --copying را ببینید.

IceWM تحت مجوز GNU Library General Public License منتشر شده است. پرونده COPYING موجود در توزیع یا گزینه --copying را برای نمایش مجوزها ببینید.

2026-08-06 icewm 4.1.0