| ICEWMHINT(1) | User Commands | ICEWMHINT(1) |
نام (NAME)
icewmhint - ارسال نشانهها و ویژگیهای پنجره به مدیر پنجره IceWM
خلاصه دستور (SYNOPSIS)
icewmhint CLASS.INSTANCE OPTION VALUE ...
توضیحات (DESCRIPTION)
icewmhint ابزاری برای ارسال نشانهها و ویژگیهای پنجره (hints) در IceWM به icewm(1) است. icewm از این نشانهها برای نخستین کلاینت X11 که متعاقباً اجرا میشود استفاده میکند. این تنظیمات بر نشانههای موجود در پرونده icewm-winoptions(1) اولویت دارند.
هر نشانه یک سهتایی متشکل از class.instance، یک IceWM winoption و مقدار آن است. در هر بار اجرای icewmhint میتوان چندین نشانه را مشخص کرد.
نشانهها از طریق ویژگی "_ICEWM_WINOPTHINT" روی پنجره ریشه (root window) منتقل میشوند. icewmhint نشانهها را به این ویژگی اضافه میکند، در حالی که icewm پس از خواندن ویژگی، آن را حذف میکند.
گزینهها (OPTIONS)
icewmhint گزینههای زیر را میشناسد:
گزینههای دستوری (COMMAND OPTIONS)
در هر بار اجرا فقط میتوان یک گزینه دستوری را مشخص کرد. اگر هیچ گزینه دستوری مشخص نشود، تجزیه و پردازش آرگومانها انجام میشود.
- -h, --help
- نمایش خلاصه راهنمای استفاده در خروجی استاندارد (stdout) و خروج.
- -V, --version
- نمایش نسخه برنامه در خروجی استاندارد (stdout) و خروج.
- -C, --copying
- نمایش مجوزهای رونوشتبرداری و حق نشر برنامه در خروجی استاندارد (stdout) و خروج.
گزینههای عمومی (GENERAL OPTIONS)
- -d, --display=DISPLAY
- مشخص کردن DISPLAY در X11. در صورت عدم تعیین، مقدار پیشفرض $DISPLAY خواهد بود.
آرگومانها (ARGUMENTS)
سه آرگومان زیر برای هر نشانه الزامی هستند.
- CLASS.INSTANCE
- ویژگی WM_CLASS در استاندارد ICCCM 2.0 را بر حسب کلاس منبع و نام منبع که با نقطه (".") جدا شدهاند مشخص میکند. به عنوان مثال: "XTerm.xterm". فقط کلاس منبع یا نام منبع بدون نقطه نیز قابل قبول است، مانند "XTerm" یا "xterm".
- OPTION
- گزینه (OPTION) مورد نظر برای اعمال تغییر را مشخص میکند.
- VALUE
- مقدار (VALUE) را برای گزینه تعیین میکند.
میتوان چندین نشانه را مشخص کرد.
آرگومانهای گزینههای عمومی (GENERAL OPTION ARGUMENTS)
- 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
- اگر NUMBER مقداری بین 1 و 100 باشد، ویژگی _NET_WM_WINDOW_OPACITY را تنظیم میکند. NUMBER به عنوان درصد حداکثر مات بودن تفسیر میشود.
- layer {LAYER|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.
- tray {Ignore|Minimized|Exclusive|NUMBER}
- رفتار سینی
سیستم را
برای
پنجرههای
با 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.
- frame label (default: none)
- تمام پنجرههای دارای برچسب فریم یکسان، به صورت زبانهها در یک فریم واحد قرار میگیرند.
آرگومانهای گزینههای عملکرد (FUNCTION OPTION ARGUMENTS)
مشخص میکند کدام عملکردها برای پنجرههای با 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).
آرگومانهای گزینههای تزئینات (DECOR OPTION ARGUMENTS)
مشخص میکند کدام تزئینات ظاهری برای پنجرههای با 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).
آرگومانهای گزینههای قابلیتها (FEATURE OPTION ARGUMENTS)
مشخص میکند کدام قابلیتهای پیشرفته برای پنجرههای با 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.
مثالها (EXAMPLES)
# بارگذاری اولیه یک پردازش نامرئی پسزمینه از 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
اشکالات (BUGS)
لطفاً باگها را در https://github.com/ice-wm/icewm/issues گزارش دهید.
نویسنده (AUTHOR)
Brian Bidulock <mailto:bidulock@openss7.org>.
برای آگاهی از اعلامیه کامل حق نشر و مجوزهای رونوشتبرداری، گزینه --copying را ببینید.
مجوز (LICENSE)
IceWM تحت مجوز GNU Library General Public License منتشر شده است. پرونده COPYING موجود در توزیع یا گزینه --copying را برای نمایش مجوزها ببینید.
| 2026-08-06 | icewm 4.1.0 |