نام (NAME)

icesh - کنترل ویژگی‌های پنجره و مدیر پنجره IceWM

خلاصه دستور (SYNOPSIS)

icesh OPTIONS|ACTIONS+

توضیحات (DESCRIPTION)

icesh دو نوع دستور ارائه می‌دهد:

۱. دستورهایی برای تعامل مستقیم با icewm:

این دستورها در بخش «MANAGER ACTIONS» در ادامه فهرست شده‌اند. استفاده از آن‌ها آسان است، زیرا نیازی به انتخاب یک یا چند پنجره ندارند. برای مثال، "icesh restart" مدیر پنجرهٔ icewm را بازراه‌اندازی می‌کند و "icesh clients" برنامه‌هایی را که توسط icewm مدیریت می‌شوند فهرست می‌کند.

۲. دستورهایی که روی انتخابی از پنجره‌ها عمل می‌کنند:

بخش "WINDOW ACTIONS" در ادامه را ببینید. برای مثال، "icesh close" درخواستی برای بستن یک پنجره است، اما کدام پنجره؟ اکنون icesh اشاره‌گر موشواره را به یک نشانه‌گیر بعلاوه (crosshair) تبدیل می‌کند. روی یک پنجره کلیک کنید تا درخواست بستن به آن برنامه ارسال شود.

قدرت icesh در توانایی آن برای انتخاب برنامه‌ریزی‌شدهٔ یک یا چند پنجره و اعمال عملیات روی آن انتخاب نهفته است. این قابلیت می‌تواند در اسکریپت‌ها و در icewm-keys(5) برای تعریف کلیدهای میانبر سفارشی مدیریت پنجره استفاده شود. برای مثال، جهت بستن فوری همهٔ پنجره‌های xterm دستور "icesh -c xterm close"; را اجرا کنید.

دوازده "SELECT OPTIONS" برای انتخاب پنجره‌ها وجود دارد. آن‌ها با یک '-' یا یک '+' شروع می‌شوند. '-' یک انتخاب جدید را آغاز می‌کند، در حالی که '+' پنجره‌های بیشتری را به یک انتخاب موجود می‌افزاید.

این پنجره‌های انتخاب‌شده را می‌توان با "FILTER OPTIONS" کاهش داد. این گزینه‌ها پنجره‌های ناخواسته را از انتخاب فعلی حذف می‌کنند. می‌توان چندین گزینهٔ فیلتر را مشخص کرد. برای مثال، "icesh -c xterm -W this close"; فقط آن xtermهایی را می‌بندد که در فضای کاری فعلی نشان داده شده‌اند. پنجره‌های xterm در دیگر فضاهای کاری با گزینهٔ فیلتر "-W this"; فیلتر و حذف می‌شوند.

هیچ محدودیتی در تعداد دستورها، انتخاب‌ها، فیلترها و کنش‌هایی که می‌توانید به یک فرمان icesh بدهید وجود ندارد. آن‌ها یک‌به‌یک از چپ به راست پردازش و ارزیابی می‌شوند. این ویژگی icesh را به یک زبان برنامه‌نویسی توصیفی کوچک تبدیل می‌کند. به چند مثال در انتهای این سند نگاهی بیندازید..SS "گزینه‌ها (OPTIONS)" icesh گزینه‌های زیر را می‌شناسد:

گزینه‌های انتخاب (SELECT OPTIONS)

گزینه‌های انتخاب، پنجره یا پنجره‌هایی را که عملیات‌های بعدی بر آن‌ها اعمال می‌شوند مشخص می‌کنند. اگر گزینه‌ای ارائه نشود اما عملیاتی به پنجره نیاز داشته باشد، یک نشانگر متقاطع انتخاب (crosshair) برای انتخاب تعاملی پنجرهٔ مورد نظر نمایش داده می‌شود. عملیات‌های مدیر نیازی به گزینه‌های پنجره ندارند.

گزینه‌های زیر یک یا چند پنجرهٔ کلاینت را انتخاب می‌کنند. در صورت نیاز، می‌توان آن‌ها را برای عملیات‌های متوالی تکرار کرد.

-a, -all

تمام پنجره‌های کلاینت مدیر پنجره را انتخاب می‌کند.

-f, -focus, +f, +focus

پنجرهٔ برنامه‌ای را که هم‌اکنون دارای فوکوس است انتخاب می‌کند. گزینهٔ با علامت منفی، انتخاب موجود را با پنجرهٔ فوکوس‌شده جایگزین می‌کند. با علامت مثبت، پنجرهٔ فوکوس‌شده به انتخاب موجود اضافه می‌شود.

+g, +group

انتخاب فعلی را با پنجره‌های کلاینتی که به همان گروه پنجرهٔ برنامه تعلق دارند گسترش می‌دهد.

-r, -root, +r, +root

پنجرهٔ ریشه (root) را انتخاب می‌کند. گزینهٔ با علامت منفی، انتخاب موجود را با پنجرهٔ ریشه جایگزین می‌کند. با علامت مثبت، پنجرهٔ ریشه به انتخاب موجود اضافه می‌شود.

-s, -shown

تمام پنجره‌های کلاینتی را که در فضای‌کاری (workspace) فعلی هستند انتخاب می‌کند.

-t, -top

تمام پنجره‌های سطح‌بالا (toplevel) را بدون قید و شرط از نمایشگر انتخاب می‌کند. این شامل پنجره‌هایی که هرگز نگاشت نشده‌اند و پنجره‌هایی با بیت override redirect تنظیم‌شده برای فرار از مدیریت نیز می‌شود.

-w, -window, +w, +window WINDOW_ID

شناسهٔ پنجره، WINDOW_ID، را که عملیات روی آن اعمال می‌شود مشخص می‌کند. شناسه‌های ویژه عبارتند از root برای پنجرهٔ ریشه و focus برای پنجره‌ای که هم‌اکنون دارای فوکوس است. گزینهٔ با علامت منفی انتخاب موجود را جایگزین می‌کند. با علامت مثبت، پنجره به انتخاب موجود اضافه می‌شود.

-x, -xembed

تمام پنجره‌هایی را که با استفاده از پروتکل XEMBED تعبیه شده‌اند انتخاب می‌کند.

+c, +class CLASS

انتخاب فعلی را با پنجره‌های کلاینتی که ویژگی WM_CLASS آن‌ها برابر با CLASS است گسترش می‌دهد. این نام نمونه و کلاس منبع است. اگر CLASS شامل یک نقطه باشد، فقط پنجره‌هایی با دقیقاً همان ویژگی WM_CLASS مطابقت داده می‌شوند. اگر نقطه‌ای وجود نداشته باشد، پنجره‌های همان کلاس و پنجره‌های همان نمونه انتخاب می‌شوند.

+C, +Class

انتخاب فعلی را با پنجره‌های کلاینتی که دارای ویژگی WM_CLASS مشابه با مجموعه پنجره‌های از پیش انتخاب‌شده هستند، گسترش می‌دهد.

-D, -Dockapps

تمام برنامه‌های Dockapp را که توسط icewm مدیریت می‌شوند انتخاب می‌کند.

+P, +Pid

انتخاب فعلی را با پنجره‌های کلاینتی که شناسهٔ فرایند یکسانی با یکی از پنجره‌های انتخاب‌شده دارند گسترش می‌دهد.

-T

نوار وظیفهٔ (taskbar) برنامهٔ IceWM را انتخاب می‌کند.

-A, -Await

منتظر ظاهر شدن یک یا چند پنجرهٔ کلاینت جدید می‌ماند و آن‌ها را به عنوان انتخاب جدید قرار می‌دهد.

گزینه‌های پالایش (FILTER OPTIONS)

گزینه‌های زیر مجموعه پنجره‌های انتخاب‌شدهٔ فعلی را پالایش می‌کنند. اگر هیچ گزینهٔ انتخاب قبلی ارائه نشده باشد، گزینهٔ -all به‌طور ضمنی برای پالایش تمام پنجره‌های کلاینت در نظر گرفته می‌شود.

-c, -class CLASS

مجموعه پنجره‌ها را بر اساس ویژگی WM_CLASS آن‌ها پالایش می‌کند. این نام نمونه و کلاس منبع است. اگر CLASS شامل نقطه باشد، فقط پنجره‌هایی با دقیقاً همان ویژگی WM_CLASS تطبیق داده می‌شوند. اگر نقطه‌ای نباشد، پنجره‌های همان کلاس و پنجره‌های همان نمونه (یا همان -name) انتخاب می‌شوند.

-l, -last

کلاینت‌ها را پالایش کرده و فقط جدیدترین کلاینت را نگه می‌دارد.

-m, -machine HOST

کلاینت‌ها را بر اساس نام میزبان پالایش می‌کند. کلاینت‌هایی که ویژگی WM_CLIENT_MACHINE آن‌ها برابر با HOST باشد انتخاب می‌شوند.

-n, -name NAME

کلاینت‌ها را بر اساس _NET_WM_NAME یا WM_NAME پالایش می‌کند. NAME با هر بخشی از مقدار ویژگی مطابقت داده می‌شود. برای تطبیق در ابتدای متن از پیشوند "^" استفاده کنید. برای تطبیق در انتهای متن از پسوند "$" استفاده کنید.

-p, -pid PID

کلاینت‌ها را بر اساس شناسهٔ فرایند پالایش می‌کند. کلاینت‌هایی انتخاب می‌شوند که دارای شناسهٔ فرایند PID باشند (در صورتی که libXRes در نسخهٔ 1.2 باشد) یا ویژگی _NET_WM_PID آن‌ها برابر با PID باشد.

-u, -unmapped

کلاینت‌ها را پالایش کرده و مواردی را که در حال حاضر قابل مشاهده نیستند نگه می‌دارد. این‌ها پنجره‌های پنهان، کمینه‌شده، لوله‌شده (rolled-up) یا در فضای‌کاری دیگر هستند.

-v, -viewable

کلاینت‌ها را پالایش کرده و فقط مواردی را که در حال حاضر قابل مشاهده هستند نگه می‌دارد. این کلاینت‌ها روی فضای‌کاری فعلی نگاشت شده‌اند.

-k, -kovered

کلاینت‌ها را پالایش کرده و تنها مواردی را نگه می‌دارد که در حال حاضر قابل مشاهده هستند و حداقل تا حدی توسط یک پنجرهٔ قابل مشاهدهٔ دیگر پوشانده شده‌اند.

-G, -Gravity GRAVITY

کلاینت‌ها را بر اساس فیلد گرانش پنجره (gravity) در ویژگی WM_NORMAL_HINTS پالایش می‌کند. کلاینت‌هایی با گرانش برابر با GRAVITY انتخاب می‌شوند. اگر GRAVITY با علامت تعجب شروع شود، پالایش معکوس می‌گردد.

-L, -Layer LAYER

کلاینت‌ها را بر اساس GNOME window layer پالایش می‌کند که می‌تواند نام لایه یا شمارهٔ لایه باشد. بخش EXPRESSIONS در زیر را ببینید. اگر LAYER با علامت تعجب شروع شود، پالایش معکوس می‌گردد.

-N, -Netstate STATE

کلاینت‌ها را بر اساس EWMH window state پالایش می‌کند. کلاینت‌هایی که حداقل وضعیت پنجرهٔ EWMH آن‌ها STATE باشد انتخاب می‌شوند. این وضعیت به مواردی مانند MINIZED یا MAXIMIZED اشاره دارد. بخش EXPRESSIONS در زیر را ببینید. اگر STATE با علامت تعجب شروع شود، پالایش معکوس می‌گردد. علامت سؤال "?" کلاینت‌هایی با هر بیتی که در STATE تنظیم شده باشد را پالایش می‌کند.

-P, -Property PROP[=value]

کلاینت‌ها را بر اساس ویژگی پالایش می‌کند. کلاینت‌هایی که دارای ویژگی PROP هستند انتخاب می‌شوند. اگر مقدار اختیاری value مشخص شده باشد، تطبیق تنها در صورتی موفقیت‌آمیز است که PROP یک رشته، پنجره، عدد اصلی (cardinal) یا اتوم (atom) با مقداری برابر با value باشد. اگر PROP با علامت تعجب شروع شود، پالایش معکوس می‌گردد.

-R, -Role ROLE

کلاینت‌ها را بر اساس WM_WINDOW_ROLE پالایش می‌کند. کلاینت‌هایی که مقدار ویژگی WM_WINDOW_ROLE آن‌ها برابر با ROLE باشد انتخاب می‌شوند. اگر ROLE با علامت تعجب شروع شود، پالایش معکوس می‌گردد.

-W, -Workspace WORKSPACE

کلاینت‌ها را بر اساس فضای‌کاری پالایش می‌کند. فضای‌کاری WORKSPACE می‌تواند نام یک فضای‌کاری، شمارهٔ فضای‌کاری با شمارش از صفر، واژهٔ "this" برای فضای‌کاری فعلی، یا واژهٔ "All" برای همهٔ فضاهای‌کاری باشد. اگر WORKSPACE با علامت تعجب شروع شود، پالایش معکوس می‌گردد.

-X, -Xinerama MONITOR

کلاینت‌ها را بر اساس نمایشگر RandR/Xinerama محدود می‌کند. فقط روی کلاینت‌هایی عمل می‌کند که روی MONITOR نمایش داده می‌شوند؛ که در آن MONITOR می‌تواند "All" برای همهٔ نمایشگرها، "this" برای نمایشگری که پنجرهٔ فعال روی آن نمایش داده می‌شود، یا یک شمارهٔ نمایشگر با شروع از صفر باشد. خروجی دستورات "randr" یا "xinerama" در زیر را ببینید.

-Z, -Zerminal

فقط پایانه‌ها (terminals) را نگه می‌دارد: کلاینت‌هایی که یک پوسته (shell) را منشعب کرده‌اند..SS "گزینه‌های عمومی (GENERAL OPTIONS)" گزینه‌های زیر برای تمام دستورهای IceWM یکسان هستند.

-d, -display DISPLAY

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

-h, --help

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

-V, --version

نسخهٔ برنامه را در stdout چاپ کرده و خارج می‌شود.

-C, --copying

مجوزهای نسخه‌برداری برنامه را در stdout چاپ کرده و خارج می‌شود.

-q, --quiet

در صورتی که هیچ پنجرهٔ منطبقی پیدا نشود، خطایی صادر نمی‌کند.

اقدامات (ACTIONS)

دستور icesh منتظر یک یا چند آرگومان اقدام است. دو نوع اقدام وجود دارد: اقدامات پنجره و اقدامات مدیر. نوع نخست بر روی پنجره‌های انتخاب‌شده عمل می‌کند؛ نوع دوم مستقیماً با مدیر پنجرهٔ icewm تعامل برقرار می‌کند.

اقدامات پنجره (WINDOW ACTIONS)

اقدامات زیر بر روی پنجره یا پنجره‌های انتخاب‌شده اعمال می‌شوند.

activate

فعال‌سازی پنجره، یا همان تمرکز دادن (focus) روی آن.

close

ارسال درخواست بستن به کلاینتی که پنجره را ایجاد کرده است.

kill

اجبار به بستن و خاتمهٔ فوری کلاینتی که پنجره را ایجاد کرده است.

id

چاپ شناسه پنجره‌ها برای پنجره‌های انتخاب‌شده.

pid

چاپ شناسه فرآیندها برای پنجره‌های انتخاب‌شده.

list

نمایش جزئیات پنجره، از قبیل ابعاد و موقعیت (geometry) و نام‌ها.

lower

فرستادن پنجره به زیر بقیهٔ پنجره‌ها.

raise

آوردن پنجره به روی بقیهٔ پنجره‌ها.

above

قرار دادن پنجره در بالای پنجره‌های دیگر در ترتیب پشته.

below

قرار دادن پنجره در زیر پنجره‌های دیگر در ترتیب پشته.

rollup

جمع کردن پنجرهٔ مشخص‌شده (فقط نوار عنوان باز می‌ماند).

fullscreen

قرار دادن پنجره در حالت تمام‌صفحه.

maximize

بزرگ‌نمایی (بیشینه‌سازی) پنجره.

horizontal

بزرگ‌نمایی پنجره فقط در جهت افقی.

vertical

بزرگ‌نمایی پنجره فقط در جهت عمودی.

minimize

کوچک‌نمایی (کمینه‌سازی) پنجره.

restore

بازگردانی پنجره به حالت عادی و پاک کردن وضعیت اضطرار.

hide

مخفی کردن پنجره.

unhide

آشکار کردن پنجره.

skip

عدم نمایش پنجره در نوار وظیفه (taskbar).

unskip

نمایش پنجره در نوار وظیفه.

sticky

نمایش پنجره در تمام فضاهای کاری (workspaces).

unsticky

نمایش پنجره فقط در یک فضای کاری.

urgent

تنظیم پرچم اضطرار برای چشمک‌زدن دکمهٔ نوار وظیفه.

resize WIDTH HEIGHT

تغییر اندازه پنجره به WIDTH در HEIGHT واحد پنجره. برای برنامه‌های مبتنی بر متن مانند ترمینال‌ها، یک واحد پنجره برابر با اندازهٔ یک سلول نویسه است.

sizeto WIDTH HEIGHT

تغییر اندازهٔ پنجره به WIDTH در HEIGHT پیکسل. اگر WIDTH یا HEIGHT با علامت درصد "%" پایان یابند، به درصدی از ناحیهٔ کاری میزکار اشاره دارند. برای نمونه، "sizeto 50% 100%" اندازه پنجره را به نیمی از عرض میزکار و تمام ارتفاع در دسترس بالا یا پایین نوار وظیفه تغییر می‌دهد.

sizeby WIDTH HEIGHT

تغییر اندازه پنجره به اندازهٔ WIDTH در HEIGHT پیکسل. اگر WIDTH یا HEIGHT با علامت درصد "%" پایان یابند، به درصدی از اندازهٔ کنونی پنجره اشاره دارند. برای نمونه، "sizeby 50% 200" عرض را ۵۰٪ و ارتفاع را ۲۰۰ پیکسل افزایش می‌دهد.

move X Y

انتقال پنجره یا پنجره‌های انتخاب‌شده به موقعیت X Y روی صفحه. برای تعیین مقادیر X یا Y به صورت نسبی از سمت راست یا لبهٔ پایینی، یک علامت منفی اضافی پیش از مقدار قرار دهید، مانند "move -+10 --20". هنگامی که X یا Y با علامت درصد "%" پایان یابند، به درصدی از ناحیهٔ کاری میزکار اشاره دارند.

moveby X Y

جابه‌جایی پنجره به اندازهٔ X Y پیکسل.

mousemove

آغاز جابه‌جایی پنجره با کنترل موشواره.

center

قرار دادن پنجره در مرکز ناحیهٔ کاری میزکار.

left

قرار دادن پنجره چسبیده به سمت چپ ناحیهٔ کاری میزکار.

right

قرار دادن پنجره چسبیده به سمت راست ناحیهٔ کاری میزکار.

top

قرار دادن پنجره چسبیده به لبهٔ بالایی ناحیهٔ کاری میزکار.

bottom

قرار دادن پنجره چسبیده به لبهٔ پایینی ناحیهٔ کاری میزکار.

setIconTitle TITLE

تنظیم عنوان آیکون به TITLE.

getIconTitle

چاپ عنوان آیکون.

setWindowTitle TITLE

تنظیم عنوان پنجره به TITLE.

getWindowTitle

چاپ عنوان پنجره.

setGeometry GEOMETRY

تنظیم ابعاد و موقعیت (geometry) پنجره به GEOMETRY. این هندسه باید در قالبی تعیین شود که توسط XParseGeometry(3) قابل تجزیه باشد. فاصله‌های نسبی منفی نسبت به لبهٔ پایینی یا سمت راست صفحه محاسبه می‌شوند. برای یک موقعیت واقعاً منفی از "+-" استفاده کنید.

getGeometry

چاپ ابعاد و موقعیت (geometry) پنجره.

setClass CLASS

تنظیم نام و کلاس منبع روی CLASS، که باید شامل یک نام منبع و یک کلاس منبع متصل‌شده با نقطه باشد. برای حفظ نام یا کلاس کنونی، از یک علامت درصد برای آن بخش استفاده کنید.

getClass

چاپ نام و کلاس منبع.

netState [STATE]

اگر STATE مشخص نشود، وضعیت پنجره EWMH نمایش داده می‌شود. اگر STATE با یک "+" آغاز شود، پرچم‌های درون STATE به وضعیت پنجره EWMH فعلی افزوده می‌شوند. اگر STATE با یک "-" آغاز شود، پرچم‌های درون STATE از وضعیت پنجره EWMH فعلی حذف می‌شوند. اگر STATE با یک "^" آغاز شود، پرچم‌های درون STATE نسبت به وضعیت پنجره EWMH فعلی معکوس می‌شوند. اگر STATE با یک "=" آغاز شود، وضعیت پنجره EWMH بر روی STATE تنظیم می‌شود. به بخش EXPRESSIONS در ادامه مراجعه کنید. فهرستی از پرچم‌های EWMH را می‌توان در خروجی دستور "icesh symbols" پیدا کرد..IP "setLayer LAYER" 4 انتقال پنجرهٔ مشخص‌شده به یک لایهٔ پنجره دیگر. برای مشاهدهٔ فهرستی از نمادهای LAYER بخش EXPRESSIONS در زیر را ببینید.

getLayer

چاپ لایهٔ پنجره برای پنجرهٔ مشخص‌شده.

setWorkspace WORKSPACE

انتقال پنجرهٔ مشخص‌شده به یک فضای کاری دیگر. برای تغییر فضای کاری فعلی، پنجرهٔ ریشه (root) را انتخاب کنید. اگر WORKSPACE برابر با "All" باشد، پنجرهٔ مشخص‌شده در تمام فضاهای کاری نمایان می‌شود. برای فضای کاری فعلی "this"، برای فضای کاری بعدی "next" یا برای فضای کاری قبلی "prev" را مشخص کنید.

getWorkspace

چاپ فضای کاری پنجرهٔ مشخص‌شده.

opacity [OPACITY]

چاپ میزان شفافیت پنجره در صورت مشخص نشدن OPACITY، در غیر این صورت، تنظیم شفافیت پنجره روی مقدار OPACITY.

setTrayOption TRAYOPTION

تنظیم گزینهٔ سینی IceWM پنجرهٔ مشخص‌شده روی TRAYOPTION. برای نمادهای TRAYOPTION، بخش IceWM tray options در زیر را ببینید.

getTrayOption

چاپ گزینهٔ سینی IceWM پنجرهٔ مشخص‌شده.

setNormalGravity GRAVITY

تنظیم فیلد گرانیگاه (gravity) پنجره در ویژگی WM_NORMAL_HINTS برای پنجرهٔ مشخص‌شده روی GRAVITY. برای نمادهای GRAVITY بخش زیر را ببینید.

getNormalGravity

چاپ گرانیگاه پنجره از ویژگی WM_NORMAL_HINTS برای پنجرهٔ مشخص‌شده.

setWindowGravity GRAVITY

تنظیم گرانیگاه پنجره برای پنجرهٔ مشخص‌شده روی GRAVITY. برای نمادهای GRAVITY بخش زیر را ببینید.

getWindowGravity

چاپ گرانیگاه پنجره برای پنجرهٔ مشخص‌شده.

setBitGravity GRAVITY

تنظیم گرانیگاه بیتی (bit gravity) پنجرهٔ مشخص‌شده روی GRAVITY. برای نمادهای GRAVITY بخش زیر را ببینید.

getBitGravity

چاپ گرانیگاه بیتی برای پنجرهٔ مشخص‌شده.

motif [funcs FUNCTIONS | decor DECORATIONS | remove]

پرس‌وجو، مقداردهی یا ویرایش ویژگی "_MOTIF_WM_HINTS" برای پنجرهٔ مشخص‌شده. بدون آرگومان، motif مقدار فعلی را نشان می‌دهد، اما تنها در صورتی که پنجره چنین ویژگی‌ای داشته باشد. این ویژگی را می‌توان با آرگومان remove حذف یا بازنشانی کرد. با funcs و decor می‌توان فیلدهای منفرد این ویژگی را فعال یا غیرفعال نمود. اگر FUNCTIONS یا DECORATIONS با علامت مثبت یا منفی آغاز شود، مقدار موجود ویرایش می‌شود؛ در غیر این صورت روی مقدار جدید تنظیم می‌گردد. توجه داشته باشید که با تنظیم "All"، سایر فیلدهای فعال، غیرفعال شده و فیلدهای پاک‌شده فعال می‌گردند.

borderless

پنهان کردن حاشیه‌های قاب و عنوان پنجره.

bordered

نمایش حاشیه‌های قاب و عنوان پنجره.

denormal

حذف ویژگی WM_NORMAL_HINTS در صورت وجود. این کار محدودیت‌های اندازهٔ قلم را هنگام تغییر اندازه، به‌ویژه در ترمینال‌ها، لغو می‌کند.

prop PROPERTY

چاپ مقدار ویژگی PROPERTY، در صورت وجود.

properties

چاپ تمام ویژگی‌ها و مقادیر مربوط به آن‌ها.

frame

چاپ شناسهٔ قاب (frame) پنجره.

extents

چاپ شناسهٔ پنجره و اندازه‌های حاشیهٔ قاب: چپ، راست، بالا و پایین.

focusmodel

چاپ مدل فوکوس ICCCM بر اساس آنچه توسط پنجرهٔ کلاینت اعلان شده است. این مقدار یکی از موارد Locally، Passive، Globally یا NoInput است.

override [0|1]

چاپ وضعیت override redirect برای پنجره، یا در صورت وارد کردن 0 یا 1، فعال یا غیرفعال کردن وضعیت override redirect.

tabto label

انتقال پنجره‌ها به‌صورت برگه به قابی که دارای برچسب "frame" با نام label است. در صورت نیاز، چنین قابی ایجاد خواهد شد.

untab

انتقال هر پنجره به قاب مستقل خودش، در صورتی که در حال حاضر در یک برگه قرار داشته باشد.

loadicon image.pam

بارگذاری یک آیکون از فایل، که باید در قالب تصویری PAM، با ابعاد حداکثر ۲۵۶، عمق ۴ و از نوع RGB_ALPHA باشد.

saveicon file000.pam

ذخیرهٔ یک آیکون در یک فایل جدید با قالب تصویری PAM. ارقام به‌صورت افزایشی تغییر می‌کنند تا یک نام فایل یکتا برای هر پنجره ایجاد شود. پنجره باید دارای ویژگی _NET_WM_ICON باشد.

usertime

نمایش زمان آخرین تعامل کاربر بر حسب میلی‌ثانیه.

click window-x window-y button

ارسال یک رویداد فشردن و رها کردن دکمه در موقعیت (window-x, window-y). موقعیت‌های منفی نسبت به گوشهٔ پایین سمت راست محاسبه می‌شوند. اشاره‌گر موشواره پیش از ارسال رویدادها به آن موقعیت منتقل می‌شود. شمارهٔ دکمه باید بین ۱ تا ۵ (شامل خود آن‌ها) باشد.

monitors top bottom left right

این گزینه نمایشگرهای مورد استفاده برای حالت تمام‌صفحه را تنظیم می‌کند. مقادیر top، bottom، left و right نمایه‌های دستور icesh xinerama هستند.

spy

زیر نظر گرفتن پنجره‌های انتخاب‌شده و گزارش هرگونه تغییر در آن‌ها. این مورد شامل فوکوس، پدیداری، موقعیت، اندازه و تمام ویژگی‌های پنجره می‌شود. برای پایش تمام پیام‌های درخواست پروتکل که برنامه‌های کلاینت ممکن است به icewm ارسال کنند، پنجرهٔ ریشه را نیز پایش کنید.

stacking

مرتب‌سازی فهرست پنجره‌ها از بالاترین تا پایین‌ترین پنجره در چیدمان لایه‌ای.

reverse

معکوس کردن ترتیب فهرست پنجره‌ها.

switchmenu

خروجی دادن فهرست به‌صورت یک منو برای QuickSwitch در icewm. این عمل برای استفاده در یک دستورالعمل switchkey در فایل "keys" در نظر گرفته شده است.

print format

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

if selection
then
    actions
elif selection
then
    actions
else
    actions
end

عبارت‌ها (EXPRESSIONS)

برخی از کنش‌های پنجره نیازمند یک یا دو آرگومان EXPRESSION هستند.

EXPRESSION ::= SYMBOL | EXPRESSION { "+" | "|" | "-" } SYMBOL

این گزاره بیان می‌کند که یک عبارت یا یک SYMBOL است، یا عبارتی که توسط یک عملگر با یک SYMBOL ترکیب شده است. به عبارت دیگر، یک عبارت دنباله‌ای از نمادهاست که با استفاده از عملگرها ترکیب شده‌اند، که در آن یک عملگر می‌تواند یک علامت به‌علاوه، یک خط عمودی یا یک علامت تفریق باشد.

هر SYMBOL بسته به زمینه‌ای که در آن به کار می‌رود، می‌تواند یک عدد یا یک نماد نام‌گذاری‌شده از یکی از دامنه‌های کاربردی زیر باشد:

Window layer

نمادهای نام‌گذاری‌شدهٔ دامنهٔ Window layer (محدوده عددی: 0-15):

Desktop                (0)
Below                  (2)
Normal                 (4)
OnTop                  (6)
Dock                   (8)
AboveDock             (10)
Menu                  (12)
Fullscreen            (14)
AboveAll              (15)

این نمادها با آرگومان LAYER برای کنش "setLayer" استفاده می‌شوند.

IceWM tray option

نمادهای نام‌گذاری‌شدهٔ دامنهٔ IceWM tray option (محدوده عددی: 0-2):

Ignore                 (0)
Minimized              (1)
Exclusive              (2)

این نمادها با آرگومان TRAYOPTION برای کنش "setTrayOption" استفاده می‌شوند.

Gravity symbols

نمادهای نام‌گذاری‌شده برای جاذبه (gravity) پنجره و بیت (محدوده عددی: 0-10):

ForgetGravity         (0)
NorthWestGravity      (1)
NorthGravity          (2)
NorthEastGravity      (3)
WestGravity           (4)
CenterGravity         (5)
EastGravity           (6)
SouthWestGravity      (7)
SouthGravity          (8)
SouthEastGravity      (9)
StaticGravity         (10)

Motif functions

All                  (1)
Resize               (2)
Move                 (4)
Minimize             (8)
Maximize             (16)
Close                (32)

Motif decorations

All                  (1)
Border               (2)
Resize               (4)
Title                (8)
Menu                 (16)
Minimize             (32)
Maximize             (64)

EWMH window state symbols

نمادهای نام‌گذاری‌شدهٔ دامنهٔ EWMH state (محدوده عددی: 0-8191):

    ABOVE                 (1)
    BELOW                 (2)
    DEMANDS_ATTENTION     (4)
    FOCUSED               (8)
    FULLSCREEN            (16)
    HIDDEN                (32)
    MAXIMIZED_HORZ        (64)
    MAXIMIZED_VERT        (128)
    MODAL                 (256)
    SHADED                (512)
    SKIP_PAGER            (1024)
    SKIP_TASKBAR          (2048)
    STICKY                (4096)
فهرست کردن نام تمام فضاهای کاری:

icesh listWorkspaces

نمونه خروجی:

workspace #0: `main'
workspace #1: `web'
workspace #2: `doc'
workspace #3: `dev'

بستن ترمینال work و فعال‌سازی ترمینال fun.

icesh -c work.XTerm close -a -c fun.XTerm activate

چاپ میزان شفافیت برای تمام xtermها.

icesh -c XTerm opacity

تغییر میزان شفافیت برای تمام xtermها.

icesh -c XTerm opacity 84

انتقال تمام پنجره‌های فضای کاری "Top" به فضای کاری جاری.

icesh -W "Top" setWorkspace "this"

بازیابی تمام کلاینت‌های پنهان، کمینه کردن تمام کلاینت‌های فضای کاری جاری و فعال‌سازی Firefox.

icesh -N HIDDEN restore -a -W "this" minimize -a -c Firefox activate

تغییر اندازه پنجره دارای فوکوس برای اشغال نیمه راست ناحیه میزکار.

icesh -f sizeto 49% 100% top right raise

تغییر وضعیت حاشیه قاب پنجره دارای فوکوس.

if icesh -f motif | grep -q 'decor:$'; then \
    icesh -f motif decor All; else icesh -f motif decor ""; fi

در ادامه راه‌حل دیگری با استفاده از شرط‌ها آورده شده است.

icesh -f if -P _NET_FRAME_EXTENTS=0 then bordered else borderless

در اینجا شرطی برای تغییر وضعیت پدیداری roxterm دارای مقدار WM_WINDOW_ROLE برابر با "special" یا اجرای آن با runonce آورده شده است.

icesh if -c roxterm.Roxterm -R special then \
    if -v then hide \
    elif -u then setWorkspace this activate end \
    else runonce roxterm --role=special

جمع‌آوری تمام ترمینال‌های urxvt از فضای کاری چهارم درون یک قاب واحد در فضای کاری جاری.

icesh -W 3 -c urxvt tabto myfunnyname

استفاده شرطی از ساختار حلقه برای انتظار تا زمان پدیدار شدن یک پنجره خاص.

icesh -t if -n Tooltip then list else delay 0.05 loop end

DISPLAY

نمایشگر پیش‌فرض.

وضعیت خروج (EXIT STATUS)

0

آخرین اقدام با موفقیت به پایان رسید.

1

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

2

یک عبارت شرطی دارای نحو نامعتبر است.

3

امکان باز کردن نمایشگر وجود نداشت.

4

کارساز X هنگام پردازش یک درخواست، خطایی گزارش می‌دهد.

سازگاری (COMPLIANCE)

icesh تا حد زیادی با مشخصات EWMH و ICCCM سازگار است. برخی از دستورها، مانند اقدامات مدیریتی، مختص IceWM هستند.

همچنین ببینید (SEE ALSO)

icewm(1), wmctrl(1), xdotool(1), xprop(1), xwininfo(1), XParseGeometry(3).

گزارش باگ‌ها (BUGS)

لطفاً باگ‌ها را در https://github.com/ice-wm/icewm/issues گزارش کنید.

نویسندگان (AUTHORS)

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

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

مجوز (LICENSE)

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