.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "labwc\-actions" "5" "2026\-08\-22"
.PP
.SH "نام (NAME)"
.PP
labwc\-actions \- اقدامات و عملیات‌های پیکربندی labwc
.PP
.SH "اقدامات (ACTIONS)"
.PP
اقدامات در منوها و کلیدهای میانبر صفحه‌کلید/ماوس استفاده می‌شوند.\&
.PP
\fB<action name="Close" />\fR
.RS 4
بستن بالاترین پنجره.\&
.PP
.RE
\fB<action name="Kill" />\fR
.RS 4
کشتن پردازش مرتبط با پنجره فعلی از طریق ارسال سیگنال
SIGTERM به آن.\&
.PP
.RE
\fB<action name="Execute" command="value" />\fR
.RS 4
اجرای دستور.\& توجه داشته باشید که جهت حفظ سازگاری با نسخه‌های پیشین،
labwc از <execute> به عنوان جایگزینی برای <command> پشتیبانی می‌کند، اگرچه
مستندات openbox اشاره کرده که این مورد منسوخ شده است.\&
نکته: علامت مدک (\(ti) در دستور، پیش از ارسال به execvp() بسط داده می‌شود.\&
.PP
.RE
\fB<action name="Exit" />\fR
.RS 4
خروج از labwc.\&
.PP
.RE
\fB<action name="Focus" />\fR
.RS 4
دادن فوکوس به پنجره زیر مکان‌نما.\&
.PP
.RE
\fB<action name="Unfocus" />\fR
.RS 4
برداشتن فوکوس از پنجره‌ای که در حال حاضر دارای فوکوس است.\&
.PP
.RE
\fB<action name="Raise" />\fR
.RS 4
بالا آوردن پنجره فعلی روی سایر پنجره‌های باز در ترتیب چیدمان.\&
.PP
.RE
\fB<action name="Lower" />\fR
.RS 4
پایین بردن پنجره فعلی به زیر سایر پنجره‌های باز در ترتیب چیدمان.\&
.PP
.RE
\fB<action name="Iconify" />\fR
.RS 4
کمینه‌سازی (کوچک‌کردن به آیکون) پنجره دارای فوکوس.\&
.PP
.RE
\fB<action name="Move" />\fR
.RS 4
شروع جابه‌جایی تعاملی پنجره زیر مکان‌نما.\&
.PP
.RE
\fB<action name="MoveToEdge" direction="value" snapWindows="value" />\fR
.RS 4
جابه‌جا کردن پنجره تا برخورد با لبه بعدی.\&
.PP
\fBdirection\fR [left|up|right|down] جهتی که پنجره در آن جابه‌جا می‌شود.\&
.PP
\fBsnapWindows\fR [yes|no] حرکت پنجره تا زمانی که به لبه یک پنجره دیگر
یا لبه صفحه برخورد کند.\& اگر روی "no" تنظیم شود، فقط تا لبه بعدی صفحه
حرکت می‌کند.\& مقدار پیش‌فرض yes است.\&
.PP
.RE
\fB<action name="Resize" direction="value" />\fR
.RS 4
شروع تغییر اندازه تعاملی پنجره زیر مکان‌نما.\&
.PP
\fBdirection\fR [up|down|left|right|up\-left|up\-right|down\-left|down\-right]
لبه یا گوشه‌ای که تغییر اندازه از آنجا آغاز می‌شود.\& اگر مشخص نشود،
جهت با توجه به موقعیت مکان‌نما تعیین می‌گردد.\&
.PP
.RE
\fB<action name="ResizeRelative" left="" right="" top="" bottom="" />\fR
.RS 4
تغییر اندازه پنجره نسبت به اندازه فعلی آن.\& مقادیر left، right،
top یا bottom مشخص می‌کنند که در کدام لبه پنجره چه مقدار تغییر اندازه انجام شود؛
مقادیر مثبت پنجره را بزرگ‌تر و مقادیر منفی پنجره را کوچک‌تر می‌کنند.\&
.PP
توجه داشته باشید که برخی برنامه‌ها مانند شبیه‌سازهای ترمینال ممکن است از
بزرگ یا کوچک شدن به مقدار اندک خودداری کنند تا اندازه پنجره با اندازه سلول متنی
داخلی آن‌ها تراز باقی بماند.\&
.PP
.RE
\fB<action name="GrowToEdge" direction="value" />\fR
.RS 4
تغییر اندازه پنجره برای پر کردن فضای خالی میان لبه آن و لبه هر پنجره دیگر.\&
.PP
\fBdirection\fR [left|up|right|down] جهتی که پنجره در آن گسترش می‌یابد.\&
.PP
.RE
\fB<action name="ShrinkToEdge" direction="value" />\fR
.RS 4
معکوس GrowToEdge.\& پنجره را حداکثر تا ۵۰٪ کوچک می‌کند.\&
.PP
\fBdirection\fR [left|up|right|down] جهتی که پنجره در آن جمع و کوچک می‌شود.\&
.PP
.RE
\fB<action name="MoveTo" x="" y="" />\fR
.RS 4
جابه‌جایی به مختصات (x, y).\&
.PP
.RE
\fB<action name="ResizeTo" width="" height="" />\fR
.RS 4
تغییر اندازه پنجره.\&
.PP
\fBwidth\fR عرض جدید پنجره بر حسب پیکسل.\&
.PP
\fBheight\fR ارتفاع جدید پنجره بر حسب پیکسل.\&
.PP
.RE
\fB<action name="MoveToCursor" />\fR
.RS 4
جابه‌جا کردن پنجره به گونه‌ای که مرکز آن روی مکان‌نما قرار گیرد.\&
تلاش می‌کند از خارج شدن هر بخشی از پنجره از صفحه جلوگیری کند.\&
این اقدام از نگارش 0.\&7.\&3 به بعد منسوخ شده است.\& برای اطمینان از کارکرد
پیکربندی خود در نسخه‌های آینده labwc، لطفاً از این دستور استفاده کنید:
.PP
\fB<action name="AutoPlace" policy="cursor">\fR
.PP
.RE
\fB<action name="MoveRelative" x="" y="" />\fR
.RS 4
جابه‌جا کردن پنجره نسبت به موقعیت فعلی آن.\& مقدار مثبت x آن را به
راست و مقدار منفی به چپ می‌برد.\& مقدار مثبت y آن را به پایین و مقدار منفی به بالا می‌برد.\&
.PP
.RE
\fB<action name="ToggleSnapToEdge" direction="value" combine="value" />\fR
.br
\fB<action name="SnapToEdge" direction="value" combine="value" />\fR
.RS 4
تغییر اندازه پنجره برای پر کردن نیم یا یک‌چهارم صفحه خروجی در جهت داده‌شده.\&
.PP
\fBdirection\fR [up|down|left|right|up\-left|up\-right|down\-left|down\-right|center]
.RS 4
جهتی که پنجره به آن چسبانده (اسنپ) می‌شود.\&
.PP
.RE
\fBcombine\fR [yes|no]
.RS 4
امکان چسباندن پنجره به یک گوشه صفحه خروجی از طریق ترکیب دو جهت را فراهم می‌کند.\&
برای نمونه، چسباندن پنجره به \fBright\fR و سپس به \fBup\fR، آن را در یک‌چهارم
\fBup\-right\fR (بالا\-راست) خروجی قرار می‌دهد.\&
مقدار پیش‌فرض no است.\&
.PP
.RE
دستور ToggleSnapToEdge علاوه بر این، وضعیت پنجره فعال را میان حالت کاشی‌شده در جهت داده‌شده
و موقعیت کاشی‌نشده اولیه جابه‌جا (تغییر وضعیت) می‌کند.\&
.PP
.RE
\fB<action name="ToggleSnapToRegion" region="value" />\fR
.br
\fB<action name="SnapToRegion" region="value" />\fR
.RS 4
تغییر اندازه و جابه‌جایی پنجره فعال مطابق با ناحیه (region) مشخص‌شده.\&
.PP
دستور ToggleSnapToRegion علاوه بر این، وضعیت پنجره فعال را میان حالت کاشی‌شده در ناحیه مشخص‌شده
و موقعیت اولیه کاشی‌نشده جابه‌جا می‌کند.\&
.PP
برای اطلاعات بیشتر در مورد چگونگی تعریف ناحیه‌ها به labwc\-config(5) مراجعه کنید.\&
.PP
.RE
\fB<action name="UnSnap" />\fR
.RS 4
تغییر اندازه و بازگرداندن پنجره فعال به موقعیت پیشین کاشی‌نشده یا بیشینه‌نشده، در صورتی که پنجره
پیش‌تر بیشینه شده یا به یک جهت یا ناحیه چسبانده (کاشی) شده باشد.\&
.PP
.RE
\fB<action name="NextWindow" workspace="current" output="all" identifier="all" />\fR
.br
\fB<action name="PreviousWindow" workspace="current" output="all" identifier="all" />\fR
.br
\fB<action name="NextWindowImmediate" workspace="current" output="all" identifier="all" />\fR
.br
\fB<action name="PreviousWindowImmediate" workspace="current" output="all" identifier="all" />\fR
.br
چرخش فوکوس به ترتیب به پنجره بعدی یا قبلی.\&
.PP
.RS 4
کلیدهای میانبر پیش‌فرض برای NextWindow و PreviousWindow به ترتیب Alt\-Tab و
Shift\-Alt\-Tab هستند.\& هنگام پیمایش میان پنجره‌ها، کلیدهای جهتی پنجره انتخابی را به
جلو/عقب می‌برند و کلید escape چرخش را متوقف می‌کند.\&
.PP
دستورهای NextWindowImmediate و PreviousWindowImmediate رابط جابه‌جایی پنجره (Window Switcher)
و نمایشگر روی صفحه (OSD) را نادیده می‌گیرند، که برای اتصال به کلیدهای بدون کلید تغییردهنده (modifier) مفید است.\&
.PP
\fBworkspace\fR [all|current]
تعیین می‌کند که آیا چرخش میان پنجره‌های تمام فضاهای کاری انجام شود یا فقط در
فضای کاری فعلی.\& پیش‌فرض "current" است.\&
.PP
\fBoutput\fR [all|focused|cursor]
تعیین می‌کند که چرخش میان پنجره‌های تمام خروجی‌ها انجام شود، خروجی دارای فوکوس،
یا خروجی زیر مکان‌نما.\& پیش‌فرض "all" است.\&
.PP
\fBidentifier\fR [all|current]
تعیین می‌کند که آیا چرخش میان تمام پنجره‌ها انجام شود یا فقط میان پنجره‌های متعلق به
همان برنامه پنجره دارای فوکوس فعلی.\& پیش‌فرض "all" است.\&
.PP
.RE
\fB<action name="Reconfigure" />\fR
.RS 4
بارگذاری مجدد فایل‌های پیکربندی و تم.\&
.PP
.RE
\fB<action name="ShowMenu" menu="root\-menu" />\fR
.RS 4
نمایش یک منو.\&
.PP
.RE
.nf
.RS 4
<action name="ShowMenu" menu="MENU">
  <atCursor>yes|no</atCursor>
  <position>
    <x>X</x>
    <y>Y</y>
  </position>
</action>
.fi
.RE
.PP
.RS 4
\fBmenu\fR نام منویی که باید نمایش داده شود.\& وجود منوهای "root\-menu" و
"client\-menu" و "client\-send\-to\-menu" و "client\-list\-combined\-menu"
تضمین شده است، اما سایر منوها نیز می‌توانند به طور صریح تعریف شوند.\&
برای اطلاعات بیشتر به labwc\-menu(5) مراجعه کنید.\&
.PP
\fBatCursor\fR [yes|no] هنگام باز کردن یک منو، منو در محل قرارگیری
مکان‌نمای ماوس باز شود.\& اگر روی no تنظیم شود، منو در گوشه بالا\-چپ
پنجره مرتبط با آن اقدام یا زیر دکمه پنجره‌ای که منو را باز کرده ظاهر می‌شود.\&
مقدار پیش‌فرض yes است.\&
.PP
\fBposition\fR نمایش منو در موقعیت مشخص‌شده روی مانیتوری
که فوکوس مکان‌نما را در اختیار دارد؛ توضیحات زیر را ببینید.\&
.PP
تگ position دارای دو زیرتگ است.\& تگ‌های <x> و <y> یک موقعیت را تعیین می‌کنند و
می‌توانند یک مقدار پیکسلی، رشته "center" (که منو را در آن بعد در مرکز قرار می‌دهد)،
یا یک مقدار نسبی به صورت درصد دریافت کنند.\& مقدار نسبی بر اساس مانیتوری که منو قرار است روی آن
نمایش داده شود تفسیر می‌گردد؛ برای مقادیر مثبت، نسبت به لبه چپ/بالای پنجره منو و
مانیتور سنجیده می‌شود و برای مقادیر منفی، نسبت به لبه راست/پایین.\&
.PP
مثال زیر نشان می‌دهد که چگونه می‌توان '\&root\-menu'\& را از یک پنل تراز پایین
با استفاده از دستور `wtype \-M logo \-k Space` باز کرد:
.PP
.RE
.nf
.RS 4
<keybind key="W\-Space">
  <action name="ShowMenu">
  <menu>root\-menu</menu>
  <position>
    <x>0</x>
    <y>\-0</y>
  </position>
  </action>
</keybind>
.fi
.RE
.PP
\fB<action name="SetDecorations" decorations="value" forceSSD="no" />\fR
.RS 4
تنظیم دکوراسیون (تزئینات) پنجره دارای فوکوس.\&
.PP
\fBdecorations\fR [full|border|none] مقدار \fBfull\fR تمام دکوراسیون سمت سرور را فعال می‌کند.\&
با مقدار \fBborder\fR فقط حاشیه‌ها و ناحیه نامرئی تغییر اندازه فعال می‌شوند.\&
مقدار \fBnone\fR همه‌چیز را غیرفعال می‌کند.\&
.PP
\fBforceSSD\fR [yes|no] اگر این گزینه روی no باشد، این اقدام برای پنجره‌هایی
که دارای دکوراسیون سمت کلاینت (CSD) هستند، در صورتی که باعث افزایش میزان
تزئینات پنجره شود، نادیده گرفته خواهد شد.\& مقدار پیش‌فرض no است.\&
.PP
.RE
\fB<action name="ToggleDecorations" />\fR
.RS 4
تغییر وضعیت دکوراسیون پنجره دارای فوکوس.\&
.PP
این یک اقدام سه‌حالته است که می‌تواند چندین بار اجرا شود:
.PD 0
.IP \(bu 4
فقط نوار عنوان پنهان می‌شود، حاشیه‌ها و ناحیه تغییر اندازه حفظ می‌گردند
.IP \(bu 4
باقی‌مانده دکوراسیون غیرفعال خواهد شد
.IP \(bu 4
دکوراسیون به صورت عادی نمایش داده می‌شود
.PD
.PP
با غیرفعال کردن پیکربندی تم '\&keepBorder'\&، مرحله اول حذف شده و اقدام
تنها میان روشن و خاموش تغییر وضعیت می‌دهد.\&
.PP
.RE
\fB<action name="ToggleFullscreen" />\fR
.RS 4
تغییر وضعیت تمام‌صفحه پنجره دارای فوکوس.\&
.PP
.RE
\fB<action name="ToggleMaximize" direction="value" />\fR
.RS 4
تغییر وضعیت بیشینه‌سازی پنجره دارای فوکوس.\& جهت‌های پشتیبانی‌شده عبارتند از
"both" (پیش‌فرض)، "horizontal" و "vertical".\&
.PP
.RE
\fB<action name="Maximize" direction="value" />\fR
.RS 4
بیشینه‌سازی پنجره دارای فوکوس در جهت(های) مشخص‌شده.\& جهت‌های پشتیبانی‌شده
عبارتند از "both" (پیش‌فرض)، "horizontal" و "vertical".\&
.PP
.RE
\fB<action name="UnMaximize" direction="value" />\fR
.RS 4
خروج پنجره دارای فوکوس از حالت بیشینه در جهت(های) مشخص‌شده و بازگرداندن آن به
ابعاد پیش از بیشینه‌سازی.\& جهت‌های پشتیبانی‌شده عبارتند از "both" (پیش‌فرض)،
"horizontal" و "vertical".\&
.PP
.RE
\fB<action name="ToggleAlwaysOnTop" />\fR
.RS 4
تغییر وضعیت حالت «همیشه در بالا» برای پنجره دارای فوکوس.\&
.PP
.RE
\fB<action name="ToggleAlwaysOnBottom" />\fR
.RS 4
تغییر وضعیت میان لایه‌های '\&always\-on\-bottom'\& (همیشه در پایین) و '\&normal'\& (عادی).\&
هنگامی که پنجره‌ای در لایه '\&always\-on\-bottom'\& قرار دارد، زیر تمامی پنجره‌های سطح بالای
دیگر رندر می‌شود.\& پیش‌بینی می‌شود این اقدام هنگام تعریف قوانین پنجره (window\-rules) برای
ابزارهای مدیریت میزکار که از پروتکل wlr\-layer\-shell پشتیبانی نمی‌کنند، مفید باشد.\&
.PP
.RE
\fB<action name="ToggleOmnipresent" />\fR
.RS 4
تغییر وضعیت حالت همه‌جاحاضر (نمایش در تمام فضاهای کاری / چسبان) برای پنجره
دارای فوکوس.\&
.PP
.RE
\fB<action name="ToggleKeybinds" />\fR
.RS 4
توقف پردازش کلیدهای میانبر صفحه‌کلید/ماوس به جز خود ToggleKeybinds.\&
این اقدام می‌تواند برای ارسال میانبرهایی مانند Alt\-Tab و موارد مشابه به
ماشین‌های مجازی، کلاینت‌های VNC یا کامپوزیتورهای تو در تو استفاده شود.\&
فراخوانی مجدد این اقدام تمامی کلیدهای میانبر اصلی را بازمی‌گرداند.\&
.PP
این اقدام تنها روی پنجره‌ای تأثیر می‌گذارد که هنگام اجرای کلید میانبر دارای
فوکوس صفحه‌کلید بوده است.\& بنابراین با رفتن به پنجره‌ای دیگر، تمامی کلیدهای میانبر
عادی دوباره عمل می‌کنند تا زمانی که به پنجره اصلی بازگردید.\& چندین پنجره می‌توانند
به طور همزمان در این حالت قرار گیرند.\&
.PP
.RE
\fB<action name="ToggleTearing" />\fR
.RS 4
تغییر وضعیت بریدگی تصویر (tearing) برای پنجره دارای فوکوس میان فعال و غیرفعال.\&
این اقدام اولویت پنجره (نکته راهنمای بریدگی یا tearing hint) را بازنویسی می‌کند.\&
.PP
نیازمند گزینه پیکربندی '\&allowTearing'\& است.\& هنگامی که '\&allowTearing'\& روی
'\&fullscreen'\& یا '\&fullscreenForced'\& تنظیم شده باشد، بریدگی تصویر تنها در صورتی
فعال خواهد شد که پنجره فعال در حالت تمام‌صفحه باشد.\&
.PP
.RE
\fB<action name="FocusOutput" output="HDMI\-A\-1" direction="value" wrap="no" />\fR
.RS 4
دادن فوکوس به بالاترین پنجره در خروجی دیگر و پرش دادن (warp) مکان‌نما
به مرکز آن پنجره.\&
.PP
اگر \fBoutput\fR مشخص شده باشد، فوکوس به خروجی تعیین‌شده داده می‌شود و
\fBdirection\fR نادیده گرفته خواهد شد.\& اگر \fBoutput\fR ذکر نشود، \fBdirection\fR می‌تواند
یکی از مقادیر "left"، "right"، "up" یا "down" باشد تا نشان دهد فوکوس باید به خروجی
بعدی در آن جهت (در صورت وجود) داده شود.\&
.PP
\fBwrap\fR [yes|no] هنگام استفاده از مشخصه direction، چرخش حلقه‌ای
از راست به چپ یا بالا به پایین و برعکس انجام شود.\& مقدار پیش‌فرض no است.\&
.PP
اگر خروجی مقصد هیچ پنجره‌ای نداشته باشد، مکان‌نما در مرکز صفحه خروجی قرار می‌گیرد.\&
.PP
.RE
\fB<action name="MoveToOutput" output="HDMI\-A\-1" direction="value" wrap="no" />\fR
.RS 4
انتقال پنجره فعال به خروجی دیگر، مگر اینکه وضعیت پنجره تمام‌صفحه باشد.\&
.PP
اگر \fBoutput\fR مشخص شده باشد، پنجره مستقیماً به خروجی تعیین‌شده فرستاده می‌شود و
\fBdirection\fR نادیده گرفته خواهد شد.\& اگر \fBoutput\fR ذکر نشود، \fBdirection\fR می‌تواند
یکی از مقادیر "left"، "right"، "up" یا "down" باشد تا نشان دهد پنجره باید به خروجی
بعدی در آن جهت (در صورت وجود) منتقل شود.\&
.PP
\fBwrap\fR [yes|no] هنگام استفاده از مشخصه direction، چرخش حلقه‌ای
از راست به چپ یا بالا به پایین و برعکس انجام شود.\& مقدار پیش‌فرض no است.\&
.PP
.RE
\fB<action name="FitToOutput" />\fR
.RS 4
تغییر ابعاد پنجره فعال به عرض و ارتفاع خروجی در صورتی که اندازه پنجره از
اندازه خروجی بیشتر شود.\&
.PP
.RE
\fB<action name="GoToDesktop" to="value" wrap="yes" toggle="no" />\fR
.RS 4
رفتن به فضای کاری.\&
.PP
\fBto\fR فضای کاری مورد نظر برای جابه‌جایی.\& مقادیر پشتیبانی‌شده عبارتند از "current"، "last"،
"left"، "right"، "left\-occupied"، "right\-occupied" یا نام کامل یک فضای کاری
یا شماره نمایه آن (شروع از ۱) همان‌گونه که در rc.\&xml پیکربندی شده است.\&
.PP
\fBwrap\fR [yes|no] چرخش حلقه‌ای از آخرین میزکار به اولین میزکار و برعکس.\&
مقدار پیش‌فرض yes است.\&
.PP
\fBtoggle\fR [yes|no] در صورتی که هم‌اکنون در همان فضای کاری مقصد باشید،
به “last” (آخرین فضای کاری) جابه‌جا شود.\& مقدار پیش‌فرض no است.\&
.PP
.RE
\fB<action name="SendToDesktop" to="value" follow="yes" wrap="yes" />\fR
.RS 4
فرستادن پنجره فعال به فضای کاری.\&
.PP
\fBto\fR فضای کاری برای انتقال پنجره.\& مقادیر پشتیبانی‌شده مشابه دستور GoToDesktop هستند.\&
.PP
\fBfollow\fR [yes|no] همراه با انتقال پنجره، به فضای کاری مشخص‌شده نیز تغییر وضعیت داده شود.\&
مقدار پیش‌فرض yes است.\&
.PP
\fBwrap\fR [yes|no] چرخش حلقه‌ای از آخرین میزکار به اولین میزکار و برعکس.\&
مقدار پیش‌فرض yes است.\&
.PP
.RE
\fB<action name="VirtualOutputAdd" output_name="value" />\fR
.RS 4
افزودن خروجی مجازی (بک‌اند بدون سر / headless).\&
.PP
برای نمونه، می‌توان از آن برای پوشش دادن یک خروجی مجازی روی یک خروجی واقعی
اما با وضوح تصویر متفاوت استفاده کرد (این کار می‌تواند با `wlr\-randr` یا
`wdisplays` انجام شود).\& پس از آن، خروجی مجازی می‌تواند برای اشتراک‌گذاری صفحه
(کستینگ) انتخاب شود و عملاً فقط همان ناحیه از صفحه به اشتراک گذاشته شود.\&
.PP
باید توجه داشت که انداختن خروجی مجازی روی خروجی واقعی توسط wlroots به طور رسمی
تأیید یا پشتیبانی نمی‌شود.\& به عنوان مثال، پس از پیکربندی خروجی مجازی، خروجی واقعی
نیز باید مجدداً پیکربندی شود (تا پیکربندی پوششی به درستی کار کند).\& نمونه این
پیکربندی به صورت زیر است:
.PP
.RE
.nf
.RS 4
<keybind key="W\-v">
  <action name="VirtualOutputAdd" output_name="ScreenCasting" />
  <action name="Execute" command=\&'sh \-c "wlr\-randr \-\-output ScreenCasting \-\-pos 0,0 \-\-scale 2 \-\-custom\-mode 3840x2110; wlr\-randr \-\-output eDP\-1 \-\-pos 0,0 \-\-scale 2 \-\-mode 3840x2160"\&' />
</keybind>
<keybind key="W\-c">
  <action name="VirtualOutputRemove" />
</keybind>
.fi
.RE
.PP
.RS 4
توجه داشته باشید که وضوح عمودی خروجی "ScreenCasting" دقیقاً 50 پیکسل از
خروجی "eDP\-1" کوچک‌تر است تا پنل پایینی از اشتراک‌گذاری صفحه بریده و حذف شود.\&
.PP
خروجی مجازی همچنین برای گسترش میزکار به سیستم‌های از راه دور (شاید همراه)
مانند تبلت‌ها مفید است؛ برای مثال، صرفاً با افزودن یک خروجی مجازی، اتصال wayvnc به آن
و اجرای یک کلاینت VNC در سیستم راه دور.\&
.PP
\fBoutput_name\fR نام خروجی مجازی.\& تعیین نام خروجی مجازی برای خودکارسازی‌های بعدی
مفید خواهد بود.\& مقدار پیش‌فرض "HEADLESS\-X" است.\&
.PP
.RE
\fB<action name="VirtualOutputRemove" output_name="value" />\fR
.RS 4
حذف خروجی مجازی (بک‌اند headless).\&
.PP
\fBoutput_name\fR نام خروجی مجازی.\& در صورت عدم ارائه، آخرین خروجی مجازی
اضافه‌شده حذف خواهد شد.\&
.PP
.RE
\fB<action name="AutoPlace" policy="value" />\fR
.RS 4
تغییر موقعیت پنجره بر اساس سیاست جانمایی مورد نظر.\&
.PP
\fBpolicy\fR [automatic|cursor|center|cascade] استفاده از سیاست تعیین‌شده،
که همان معنای مقدار متناظر در
\fB<placement><policy>\fR را دارد.\& پیش‌فرض automatic است.\&
.PP
.RE
\fB<action name="Shade" />\fR
.br
\fB<action name="Unshade" />\fR
.br
\fB<action name="ToggleShade" />\fR
.RS 4
به ترتیب فعال کردن، غیرفعال کردن یا تغییر وضعیت حالت «لوله‌شده» (shaded) پنجره فعال.\&
هنگامی که پنجره لوله‌شده باشد، محتوای پنجره پنهان شده و فقط نوار عنوان قابل مشاهده باقی می‌ماند.\&
پنجره‌های تمام‌صفحه یا پنجره‌های بدون دکوراسیون سمت سرور (از جمله پنجره‌هایی که نوار عنوان سمت سرور
آن‌ها پنهان شده است) واجد شرایط لوله‌شدن نیستند.\&
.PP
.RE
\fB<action name="WarpCursor" to="output" x="center" y="center" />\fR
.RS 4
پرش دادن (warp) مکان‌نما به موقعیتی نسبت به خروجی یا پنجره فعال.\&
.PP
\fBto\fR [output|window] ناحیه هدف پرش مکان‌نما را تعیین می‌کند.\&
پیش‌فرض "output" است
.PP
\fBx\fR [center|value] موقعیت افقی پرش درون ناحیه هدف را مشخص می‌کند.\&
مقدار "center": مکان‌نما را به مرکز افقی ناحیه هدف می‌برد.\& اعداد صحیح مثبت یا منفی
مکان‌نما را به موقعیتی با افست تعیین‌شده به تعداد پیکسل از لبه چپ یا راست
ناحیه هدف جابه‌جا می‌کنند.\& پیش‌فرض "center" است
.PP
\fBy\fR [center|value] عملکرد مشابه برای موقعیت عمودی پرش در ناحیه هدف.\&
پیش‌فرض "center" است
.PP
.RE
\fB<action name="HideCursor" />\fR
.RS 4
پنهان کردن اشاره‌گر یا مکان‌نمای قلم نوری.\& مکان‌نما پس از اقدامات بعدی اشاره‌گر،
اقدامات قلم نوری یا ژست‌های تاچ‌پد مجدداً قابل مشاهده می‌شود.\&
همراه با اقدام WarpCursor استفاده شود تا نه تنها مکان‌نما پنهان گردد بلکه به دورتر نیز
منتقل شود تا به عنوان مثال از ایجاد جلوه‌های هاور (hover) جلوگیری شود.\&
.PP
.RE
\fB<action name="EnableScrollWheelEmulation" />\fR
.br
\fB<action name="DisableScrollWheelEmulation" />\fR
.br
\fB<action name="ToggleScrollWheelEmulation">\fR
.RS 4
به ترتیب فعال‌سازی، غیرفعال‌سازی یا تغییر وضعیت شبیه‌سازی چرخ اسکرول با حرکت مکان‌نما.\&
این قابلیت برای ماوس‌های ترک‌بال (گوی چرخان) مفید است تا از گوی چرخان نه تنها برای حرکت مکان‌نما،
بلکه برای اسکرول (چرخ ماوس) نیز استفاده شود.\&
.PP
همچنین برای تنظیم دقیق سرعت اسکرول به \fB<libinput><scrollFactor>\fR در
labwc\-config(5) مراجعه کنید.\&
.PP
.RE
\fB<action name="EnableTabletMouseEmulation" />\fR
.br
\fB<action name="DisableTabletMouseEmulation" />\fR
.br
\fB<action name="ToggleTabletMouseEmulation">\fR
.RS 4
به ترتیب فعال‌سازی، غیرفعال‌سازی یا تغییر وضعیت شبیه‌سازی ماوس برای تبلت‌های طراحی.\&
.PP
.RE
\fB<action name="ToggleMagnify">\fR
.RS 4
خاموش یا روشن کردن ذره‌بین صفحه در آخرین سطح بزرگ‌نمایی استفاده‌شده.\&
.PP
.RE
\fB<action name="ToggleShowDesktop" />\fR
.RS 4
کمینه‌سازی تمام پنجره‌ها در فضای کاری فعلی به طوری که میزکار نمایان شود.\&
با فراخوانی مجدد این اقدام، پنجره‌های پنهان‌شده از حالت کمینه خارج می‌شوند، مشروط بر اینکه
از زمان اجرای اولیه `ShowDesktop`: (الف) هیچ پنجره‌ای به صورت دستی از حالت کمینه خارج نشده باشد؛
(ب) فضاهای کاری تعویض نشده باشند؛ و (ج) هیچ برنامه جدیدی اجرا نشده باشد.\&
.PP
.RE
\fB<action name="ZoomIn">\fR
.br
\fB<action name="ZoomOut">\fR
.RS 4
افزایش یا کاهش سطح بزرگ‌نمایی ذره‌بین صفحه نمایش.\&
اگر ذره‌بین در حال حاضر خاموش باشد، ZoomIn آن را در کمترین سطح بزرگ‌نمایی فعال می‌کند
که برابر با (۱ + گام افزایش ذره‌بین تنظیم‌شده در تم) است.\&
اگر ذره‌بین روشن و در کمترین سطح بزرگ‌نمایی باشد، ZoomOut آن را خاموش می‌کند.\&
.PP
.RE
\fB<action name="None" />\fR
.RS 4
اگر به عنوان تنها اقدام برای یک کلید میانبر استفاده شود: پاک کردن کلید میانبر تعریف‌شده قبلی.\&
.PP
.RE
\fB<action name="DebugToggleKeyStateIndicator" />\fR
.RS 4
تغییر وضعیت نمایش نشانگر وضعیت کلیدها روی صفحه (OSD).\& نکته: این اقدام صرفاً
برای مقاصد اشکال‌زدایی است.\&
.PP
.RE
.SH "اقدامات شرطی (CONDITIONAL ACTIONS)"
.PP
اقداماتی که اقدامات دیگر را اجرا می‌کنند.\& در کلیدهای میانبر صفحه‌کلید/ماوس استفاده می‌شوند.\&
.PP
\fB<action name="If">\fR
.RS 4
این اقدام در صورتی که پنجره دارای فوکوس با معیارها مطابقت داشته باشد یک مجموعه از
اقدامات را اجرا می‌کند، و در غیر این صورت مجموعه‌ای دیگر را.\&
.PP
آرگومان‌ها به شرح زیر هستند:
.PP
.nf
.RS 4
<action name="If">
  <query />
  <prompt message="" />
  <then><action /></then>
  <else><action /></else>
</action>
.fi
.RE
.PP
\fBquery\fR
.RS 4
تعریف یک پرس‌وجو با صفر یا چند شرط.\& تمام شرط‌ها باید به صورت درستی (true) ارزیابی شوند
تا پنجره با این پرس‌وجو مطابقت داشته باشد.\& چندین پرس‌وجو می‌توانند تعریف شوند.\&
.PP
تطبیق الگو بر اساس glob(7) انجام می‌شود و به بزرگی و کوچکی حروف حساس نیست.\&
.PP
شرط‌ها به شرح زیر هستند:
.PP
\fBidentifier\fR
.RS 4
شناسه app_id در شل XDG برای کلاینت‌های Wayland، و WM_CLASS برای
کلاینت‌های XWayland.\&
.PP
.RE
\fBtitle\fR
.RS 4
عنوان شل XDG برای کلاینت‌های Wayland، و WM_NAME برای
کلاینت‌های XWayland.\&
.PP
.RE
\fBtype\fR
.RS 4
روش‌های ابتکاری (هیوریستیک) داخلی برای کلاینت‌های Wayland، و
NET_WM_WINDOW_TYPE برای کلاینت‌های XWayland.\&
.PP
.RE
\fBshaded\fR [yes|no]
.RS 4
آیا کلاینت لوله‌شده (جمع‌شده) است یا خیر.\&
.PP
.RE
\fBmaximized\fR [both|horizontal|vertical|none]
.RS 4
آیا کلاینت در هر دو محور، تنها در محور افقی، تنها در محور عمودی بیشینه شده است،
یا در هیچ‌یک از محورها بیشینه نیست (none).\&
.PP
.RE
\fBiconified\fR [yes|no]
.RS 4
آیا کلاینت کمینه (آیکون) شده است یا خیر.\&
.PP
.RE
\fBfocused\fR [yes|no]
.RS 4
آیا کلاینت دارای فوکوس است یا خیر.\&
.PP
.RE
\fBomnipresent\fR [yes|no]
.RS 4
آیا کلاینت در تمامی میزکارها نمایان است یا خیر.\&
.PP
.RE
\fBdesktop\fR
.RS 4
میزکاری که کلاینت در حال حاضر در آن قرار دارد.\& این مقدار می‌تواند شماره
یا نام یک میزکار باشد، یا مقادیر نسبی ویژه شامل
"current"، "other"، "left"، "right"، "left\-occupied"،
"right\-occupied" یا "last".\&
جهت‌های "left" و "right" و "left\-occupied" و
"right\-occupied" چرخش حلقه‌ای نخواهند داشت.\&
.PP
.RE
\fBtiled\fR [up|right|down|left|up\-left|up\-right|down\-left|down\-right|center|any]
.RS 4
آیا کلاینت در راستای لبه مشخص‌شده صفحه کاشی‌بندی (اسنپ) شده است یا خیر.\&
.PP
.RE
\fBtiled_region\fR
.RS 4
آیا کلاینت در ناحیه مشخص‌شده کاشی‌بندی (اسنپ) شده است یا خیر.\& ناحیه
مشخص‌شده می‌تواند یک الگوی glob باشد.\&
.PP
.RE
\fBdecoration\fR [full|border|none]
.RS 4
آیا کلاینت دارای دکوراسیون کامل سمت سرور، فقط حاشیه‌ها، یا فاقد هرگونه
دکوراسیون سمت سرور است.\&
.PP
.RE
\fBmonitor\fR [current|left|right|<monitor_name>]
.RS 4
آیا کلاینت در مانیتوری نسبت به مانیتور دارای فوکوس فعلی (current، left یا right) قرار دارد
یا در مانیتوری با <monitor_name> داده‌شده.\&
.PP
.RE
این آرگومان اختیاری است.\&
.PP
.RE
\fBprompt\fR
.RS 4
نمایش یک کادر گفتگوی پرسش بله/خیر (پیش‌فرض labnag).\& اگر '\&yes'\&
انتخاب شود، شاخه \fBthen\fR اجرا خواهد شد؛ و به طور مشابه با انتخاب
\&'\&no'\& شاخه \fBelse\fR اجرا می‌شود.\& این آرگومان اختیاری است.\& توجه داشته باشید که ساختار
نحوی آن با Openbox متفاوت است؛ در Openbox یک عنصر prompt به اقدامات If وابسته نیست
بلکه صرفاً فرزندی از اقدام پایینی خواهد بود.\& دلیل این تفاوت، افزایش انعطاف‌پذیری
و کارایی حاصل از استفاده اختیاری از شاخه \fBelse\fR است.\&
.PP
.nf
.RS 4
<keybind key="W\-q">
  <action name="If">
    <prompt message="Quit?" />
    <then>
      <action name="Exit" />
    </then>
  </action>
</keybind>
.fi
.RE
.PP
.RE
\fBthen\fR
.RS 4
فهرستی از اقداماتی که در صورت مطابقت پنجره با هر یک از پرس‌وجوها
اجرا می‌شوند.\& این آرگومان اختیاری است.\&
.PP
.RE
\fBelse\fR
.RS 4
فهرستی از اقداماتی که در صورت عدم مطابقت پنجره با هیچ‌یک از پرس‌وجوها
اجرا می‌شوند.\& این آرگومان اختیاری است.\&
.PP
.RE
.RE
\fB<action name="ForEach">\fR
.RS 4
مشابه اقدام "If"، اما به جای تنها پنجره دارای فوکوس، بر روی تمام پنجره‌ها اعمال می‌شود.\&
.PP
اقدام \fBForEach\fR دارای یک شاخه اختیاری دیگر به نام \fBnone\fR است که
زمانی اجرا می‌شود که هیچ پنجره‌ای با پرس‌وجو مطابقت نداشته باشد.\& این امکان
به عنوان مثال برای پیاده‌سازی قابلیت اجرا یا بالا آوردن (run\-or\-raise) کاربرد دارد.\&
.PP
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
labwc(1), labwc\-config(5), labwc\-theme(5), glob(7)