.\" 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\-theme" "5" "2026\-08\-22"
.PP
.SH "نام (NAME)"
.PP
labwc-theme \- فایل‌های تم در مدیر پنجره labwc
.PP
.SH "تم (THEME)"
.PP
موتور تم با هدف سازگاری با openbox طراحی شده است و تم‌ها به ترتیب زیر جستجو خواهند شد:
.PP
.PD 0
.IP \(bu 4
${XDG_DATA_HOME:\-$HOME/.\&local/share}/themes/<theme\-name>/labwc/
.IP \(bu 4
$HOME/.\&themes/<theme\-name>/labwc/
.IP \(bu 4
/usr/share/themes/<theme\-name>/labwc/
.IP \(bu 4
/usr/local/share/themes/<theme\-name>/labwc/
.IP \(bu 4
/opt/share/themes/<theme\-name>/labwc/
.IP \(bu 4
${XDG_DATA_HOME:\-$HOME/.\&local/share}/themes/<theme\-name>/openbox\-3/
.IP \(bu 4
$HOME/.\&themes/<theme\-name>/openbox\-3/
.IP \(bu 4
/usr/share/themes/<theme\-name>/openbox\-3/
.IP \(bu 4
/usr/local/share/themes/<theme\-name>/openbox\-3/
.IP \(bu 4
/opt/share/themes/<theme\-name>/openbox\-3/
.PD
.PP
هنگامی که متغیر $XDG_DATA_HOME تعریف شده باشد، جایگزین مسیر $HOME/.\&local/share می‌شود (نه اینکه به آن افزوده شود)\&. همین وضعیت برای $XDG_DATA_DIRS و /usr/share/ نیز برقرار است\&.
.PP
انتخاب تم با ویرایش کلید <name> در بخش <theme> از فایل پیکربندی rc.\&xml انجام می‌پذیرد (به labwc\-config(5) مراجعه کنید)\&.
.PP
یک تم شامل یک فایل themerc و در صورت تمایل تعدادی آیکون نوار عنوان (تحت عنوان دکمه‌ها یا buttons) است\&.
.PP
تنظیمات تم مشخص‌شده در themerc را می‌توان با ایجاد فایلی به نام \&'\&themerc\-override'\& در دایرکتوری پیکربندی بازنویسی کرد؛ این دایرکتوری معمولاً $HOME/.\&config/labwc/ است اما می‌تواند مطابق با توضیحات labwc\-config(5) در مکان‌های دیگری نیز باشد\&.
.PP
.SH "انواع داده (DATA TYPES)"
.PP
\fBcolor\fR
.RS 4
رنگ‌ها را می‌توان با نام یا با مقادیر هگزادسیمال قرمز-سبز-آبی (RGB) مشخص کرد:
.PP
عبارت \fBcolor name\fR به "نام رنگ X11" اشاره دارد، مانند: '\&white'\&، '\&grey40'\&، '\&pink'\& و '\&peach puff'\&. اطلاعات بیشتر را می‌توانید در اینجا بیابید:
.PD 0
.IP \(bu 4
<http://en.wikipedia.org/wiki/Web_colors#X11_color_names>
.IP \(bu 4
<http://en.wikipedia.org/wiki/X11_color_names>
.IP \(bu 4
<https://github.com/labwc/labwc/blob/master/src/common/rgb.txt>
.PD
.PP
\fBمقدار RGB (RGB value)\fR
.PP
.PD 0
.IP \(bu 4
#rrggbb (مقادیر هگزادسیمال RGB)
.IP \(bu 4
#rrggbb aaa (مشابه حالت قبل به همراه درصد اعشاری آلفا)
.IP \(bu 4
#rrggbbaa (مشابه حالت قبل با مقدار آلفا در کدگذاری هگزادسیمال)
.IP \(bu 4
#rgb (مقادیر هگزادسیمال RGB که در آن #fff فرم کوتاه #f0f0f0 است) (از نسخه 0.9.0)
.PD
.PP
نکته: نمادگذاری #rrggbb aaa از نسخه 0.7.2 به بعد منسوخ شده و ممکن است در نسخه‌های بعدی حذف شود\&.
.PP
.RE
\fBjustification\fR
.RS 4
تراز افقی متن را تعیین می‌کند\&.
گزینه‌های معتبر عبارتند از Left (چپ)، Center (وسط) و Right (راست)\&.
.PP
.RE
\fBtextures\fR
.RS 4
بافت‌ها ظاهر بصری یک عنصر را تعیین می‌کنند\&. آن‌ها از طریق یک رشته متنی با تعدادی فیلد مشخص می‌شوند\&. حروف کوچک و بزرگ تفاوتی ندارند\&. ساختار به شرح زیر است:
.PP
.RE
.nf
.RS 4
(Solid | Gradient <type>)
.fi
.RE
.PP
.RS 4
که در آن \fB|\fR به معنای "یا" است\&.
.PP
.PD 0
.IP \(bu 4
گزینه \fBSolid\fR به این معناست که پس‌زمینه بافت با یک رنگ ثابت پر می‌شود\&. این بافت باید با یک فیلد رنگی همراه باشد؛ برای نمونه:
.PD
.PP
.RE
.nf
.RS 4
window\&.*\&.title\&.bg: Solid
window\&.*\&.title\&.bg\&.color: #f8f5f2
.fi
.RE
.PP
.RS 4
.PD 0
.IP \(bu 4
گزینه \fBGradient\fR به این معناست که پس‌زمینه بافت با یک گرادیان از یک رنگ به رنگ دیگر پر می‌شود\&. هنگام تعیین Gradient، باید نوع گرادیان بلافاصله پس از آن بیاید\&. همچنین باید همراه با فیلدهای \fBcolor\fR و \fBcolorTo\fR باشد\&. انواع معتبر گرادیان عبارتند از:
(1) \fBVertical\fR که در آن گرادیان از لبه بالا به پایین حرکت می‌کند
(2) \fBSplitVertical\fR که در آن گرادیان در وسط تقسیم شده و به سمت لبه‌های بالا و پایین حرکت می‌کند\&. گرادیان‌های SplitVertical دارای دو فیلد رنگی اختیاری اضافی هستند: \fBcolor.\&splitTo\fR و \fBcolorTo.\&splitTo\fR\&. این رنگ‌ها رنگ‌های روشنی هستند که در بالاترین و پایین‌ترین نقاط گرادیان SplitVertical به کار می‌روند\&. در صورت حذف این موارد، مقادیر پیش‌فرض برای آن‌ها به ترتیب برابر با \fBcolor x 5/4\fR و \fBcolorTo x 17/16\fR خواهد بود\&. نمونه‌ها:
.PD
.PP
.RE
.nf
.RS 4
# Vertical gradient
window\&.*\&.title\&.bg: Gradient Vertical
window\&.*\&.title\&.bg\&.color: #658fb5
window\&.*\&.title\&.bg\&.colorTo: #4d6982

# SplitVertical gradient
window\&.*\&.title\&.bg: Gradient SplitVertical
window\&.*\&.title\&.bg\&.color: #658fb5
window\&.*\&.title\&.bg\&.color\&.splitTo: #7595b9
window\&.*\&.title\&.bg\&.colorTo: #4d6982
window\&.*\&.title\&.bg\&.colorTo\&.splitTo: #557485
.fi
.RE
.PP
.SH "عناصر تم (THEME ELEMENTS)"
.PP
\fBborder.\&width\fR
.RS 4
عرض خط (عدد صحیح) حاشیه کشیده‌شده در اطراف کادرهای پنجره\&.
مقدار پیش‌فرض 1 است\&.
.PP
.RE
\fBwindow.\&titlebar.\&padding.\&width\fR
.RS 4
اندازه فاصله درونی (padding) افقی نوار عنوان به پیکسل، بین حاشیه و اولین دکمه در سمت چپ/راست\&.
پیش‌فرض 0 است\&.
.PP
.RE
\fBwindow.\&titlebar.\&padding.\&height\fR
.RS 4
اندازه فاصله درونی عمودی نوار عنوان به پیکسل\&.
پیش‌فرض 0 است\&.
.PP
.RE
\fBwindow.\&active.\&border.\&color\fR
.RS 4
رنگ حاشیه پنجره فعال\&. پیش‌فرض #aaaaaa است\&.
.PP
.RE
\fBwindow.\&inactive.\&border.\&color\fR
.RS 4
رنگ حاشیه پنجره غیرفعال\&. پیش‌فرض #aaaaaa است\&.
.PP
.RE
\fBwindow.\&active.\&indicator.\&toggled\-keybind.\&color\fR
.RS 4
نشانگر وضعیت برای اقدام ToggleKeybinds\&. می‌توان آن را روی همان مقداری که برای window.\&active.\&border.\&color تعیین شده قرار داد تا نشانگر غیرفعال شود\&. پیش‌فرض #ff0000 است\&.
.PP
.RE
\fBwindow.\&active.\&title.\&bg\fR
.RS 4
بافت نوار عنوان پنجره دارای فوکوس\&. به بخش بافت‌ها در بالا مراجعه کنید\&.
پیش‌فرض \fBSolid\fR است\&.
.PP
.RE
\fBwindow.\&active.\&title.\&bg.\&color\fR
.RS 4
رنگ پس‌زمینه نوار عنوان پنجره دارای فوکوس\&.
پیش‌فرض #e1dedb است\&.
.PP
.RE
\fBwindow.\&inactive.\&title.\&bg\fR
.RS 4
بافت نوار عنوان پنجره‌های بدون فوکوس\&.
پیش‌فرض \fBSolid\fR است\&.
.PP
.RE
\fBwindow.\&inactive.\&title.\&bg.\&color\fR
.RS 4
رنگ پس‌زمینه نوار عنوان پنجره‌های بدون فوکوس\&.
پیش‌فرض #f6f5f4 است\&.
.PP
.RE
\fBwindow.\&active.\&label.\&text.\&color\fR
.RS 4
رنگ متن نوار عنوان پنجره دارای فوکوس\&. پیش‌فرض #000000 است\&.
.PP
.RE
\fBwindow.\&inactive.\&label.\&text.\&color\fR
.RS 4
رنگ متن نوار عنوان پنجره‌های بدون فوکوس\&. پیش‌فرض #000000 است\&.
.PP
.RE
\fBwindow.\&label.\&text.\&justify\fR
.RS 4
نحوه تراز شدن عنوان پنجره در نوار عنوان را برای هر دو حالت دارای فوکوس و بدون فوکوس تعیین می‌کند\&. از نوع justification است\&. پیش‌فرض Center می‌باشد\&.
.PP
.RE
\fBwindow.\&button.\&width\fR
.RS 4
عرض دکمه نوار عنوان به پیکسل\&.
پیش‌فرض 26 است\&.
.PP
.RE
\fBwindow.\&button.\&height\fR
.RS 4
ارتفاع دکمه نوار عنوان به پیکسل\&.
پیش‌فرض 26 است\&.
.PP
.RE
\fBwindow.\&button.\&spacing\fR
.RS 4
فاصله میان دکمه‌های نوار عنوان به پیکسل\&.
پیش‌فرض 0 است\&.
.PP
.RE
نکته: فضانام \fBwindow.\&button.\&hover\fR (در ادامه) به جلوه‌های هم‌پوشانی هاور (hover) دکمه‌ها مربوط می‌شود که با تمام دکمه‌ها از جمله svg، png و xbm کار می‌کند\&.
.PP
جلوه‌های \fBwindow.\&button.\&hover\fR تنها در صورتی نمایش داده می‌شوند که آیکون هاور متناظری مانند \fBclose_hover\-active.\&svg\fR وجود نداشته باشد\&.
.PP
ابزار Openbox تنها از جلوه‌های هاور که در پشت دکمه‌ها رندر می‌شوند پشتیبانی می‌کند که برای قالب xbm معقول است اما برای سایر قالب‌ها خیر\&.
.PP
\fBwindow.\&button.\&hover.\&bg.\&color\fR
.RS 4
رنگ جلوه هاور دکمه نوار عنوان\&. پیش‌فرض #80808020 است\&.
.PP
.RE
\fBwindow.\&button.\&hover.\&bg.\&corner\-radius\fR
.RS 4
شعاع گوشه (radius) جلوه هاور دکمه نوار عنوان به پیکسل\&.
پیش‌فرض 0 است\&.
.PP
نکته: برای داشتن جلوه هاور دایره‌ای، مقادیر \fBwindow.\&button.\&width\fR و \fBwindow.\&button.\&height\fR را برابر قرار داده و مقدار \fBwindow.\&button.\&hover.\&bg.\&corner\-radius\fR را نصف آن‌ها تعیین کنید\&.
.PP
.RE
\fBwindow.\&active.\&button.\&unpressed.\&image.\&color\fR
.RS 4
رنگ تصاویر در دکمه‌های نوار عنوان در وضعیت پیش‌فرض فشرده‌نشده\&. این عنصر مختص پنجره دارای فوکوس است\&. پیش‌فرض #000000 می‌باشد\&.
.PP
.RE
\fBwindow.\&inactive.\&button.\&unpressed.\&image.\&color\fR
.RS 4
رنگ تصاویر در دکمه‌های نوار عنوان در وضعیت پیش‌فرض فشرده‌نشده برای پنجره‌های بدون فوکوس\&. پیش‌فرض #000000 است\&.
.PP
.RE
نکته: عناصر دکمه‌ها را می‌توان برای هر نوع دکمه ("menu", "iconify", "max", "shade", "desk" یا "close") با افزودن نوع دکمه بعد از گره "button" به صورت یکتا تعریف کرد؛ برای نمونه:
.PP
.PD 0
.IP \(bu 4
مقدار window.\&active.\&button.\&iconify.\&unpressed.\&image.\&color رنگ دکمه کمینه‌سازی را برای پنجره‌های فعال مشخص می‌کند؛ در حالی که
.PD
.PP
.PD 0
.IP \(bu 4
مقدار window.\&inactive.\&button.\&close.\&unpressed.\&image.\&color رنگ دکمه بستن را برای پنجره‌های غیرفعال تعیین می‌نماید\&.
.PD
.PP
این نحو در Openbox مستند نشده است، اما پشتیبانی می‌شود و در تم‌های پرطرفدار متعددی استفاده می‌گردد\&.
.PP
\fBwindow.\&active.\&shadow.\&size\fR
.RS 4
اندازه سایه (drop-shadow) پنجره دارای فوکوس به پیکسل\&.
پیش‌فرض 60 است\&.
.PP
.RE
\fBwindow.\&inactive.\&shadow.\&size\fR
.RS 4
اندازه سایه پنجره‌های بدون فوکوس به پیکسل\&.
پیش‌فرض 40 است\&.
.PP
.RE
\fBwindow.\&active.\&shadow.\&color\fR
.RS 4
رنگ سایه پنجره دارای فوکوس، شامل میزان شفافیت (opacity)\&.
پیش‌فرض #00000060 (مشکی با ۳۸٪ شفافیت) است\&.
.PP
.RE
\fBwindow.\&inactive.\&shadow.\&color\fR
.RS 4
رنگ سایه پنجره‌های بدون فوکوس، شامل میزان شفافیت\&.
پیش‌فرض #00000040 (مشکی با ۲۵٪ شفافیت) است\&.
.PP
.RE
\fBmenu.\&overlap.\&x\fR
.RS 4
هم‌پوشانی افقی به پیکسل میان زیرمنوها و منوهای والد آنها\&. مقدار مثبت زیرمنوها را روی منوی والد می‌کشد، در حالی که مقدار منفی فاصله‌ای میان زیرمنوها و منوی والد ایجاد می‌کند\&.
پیش‌فرض 0 است\&.
.PP
.RE
\fBmenu.\&overlap.\&y\fR
.RS 4
آفست عمودی به پیکسل میان زیرمنوها و والدین آنها؛ مقادیر مثبت به سمت پایین و منفی به سمت بالا\&. پیش‌فرض 0 است\&.
.PP
.RE
\fBmenu.\&width.\&min\fR
.RS 4
حداقل عرض منوها\&. پیش‌فرض 20 است\&.
عرض ثابت را می‌توان با تنظیم مقادیر یکسان برای min.\& و max.\& به دست آورد\&.
.PP
.RE
\fBmenu.\&width.\&max\fR
.RS 4
حداکثر عرض منوها\&. پیش‌فرض 200 است\&.
.PP
.RE
\fBmenu.\&border.\&width\fR
.RS 4
عرض حاشیه منوها به پیکسل\&. در صورت عدم تنظیم، از \fBborder.\&width\fR ارث‌بری می‌کند\&.
.PP
.RE
\fBmenu.\&border.\&color\fR
.RS 4
رنگ حاشیه منوها\&. در صورت عدم تنظیم، از \fBwindow.\&active.\&border.\&color\fR ارث‌بری می‌کند\&.
.PP
.RE
\fBmenu.\&items.\&padding.\&x\fR
.RS 4
فاصله درونی افقی مدخل‌های متنی منو به پیکسل\&.
پیش‌فرض 7 است\&.
.PP
.RE
\fBmenu.\&items.\&padding.\&y\fR
.RS 4
فاصله درونی عمودی مدخل‌های متنی منو به پیکسل\&.
پیش‌فرض 4 است\&.
.PP
.RE
\fBmenu.\&items.\&bg.\&color\fR
.RS 4
رنگ پس‌زمینه آیتم‌های غیرفعال منو\&. پیش‌فرض #fcfbfa است\&.
.PP
.RE
\fBmenu.\&items.\&text.\&color\fR
.RS 4
رنگ متن آیتم‌های غیرفعال منو\&. پیش‌فرض #000000 است\&.
.PP
.RE
\fBmenu.\&items.\&active.\&bg.\&color\fR
.RS 4
رنگ پس‌زمینه آیتم‌های فعال منو\&. پیش‌فرض #e1dedb است\&.
.PP
.RE
\fBmenu.\&items.\&active.\&text.\&color\fR
.RS 4
رنگ متن آیتم‌های فعال منو\&. پیش‌فرض #000000 است\&.
.PP
.RE
\fBmenu.\&separator.\&width\fR
.RS 4
ضخامت خط جداکننده‌های منو\&. پیش‌فرض 1 است\&.
.PP
.RE
\fBmenu.\&separator.\&padding.\&width\fR
.RS 4
فضای سمت چپ و راست هر خط جداکننده\&. پیش‌فرض 6 است\&.
.PP
.RE
\fBmenu.\&separator.\&padding.\&height\fR
.RS 4
فضای بالا و پایین هر خط جداکننده\&. پیش‌فرض 3 است\&.
.PP
.RE
\fBmenu.\&separator.\&color\fR
.RS 4
رنگ جداکننده منو\&. پیش‌فرض #888888 است\&.
.PP
.RE
\fBmenu.\&title.\&bg.\&color\fR
.RS 4
رنگ عنوان منو\&. پیش‌فرض #589bda است\&.
نکته: عنوان منو یک خط جداکننده همراه با برچسب است\&.
.PP
.RE
\fBmenu.\&title.\&text.\&justify\fR
.RS 4
نحوه تراز شدن عنوان‌های منو را تعیین می‌کند\&. نوع justification\&. پیش‌فرض Center است\&.
.PP
.RE
\fBmenu.\&title.\&text.\&color\fR
.RS 4
رنگ متن برچسب جداکننده\&. پیش‌فرض #ffffff است\&.
.PP
.RE
\fBosd.\&bg.\&color\fR
.RS 4
رنگ پس‌زمینه نمایش روی صفحه (OSD)\&. در صورت عدم تنظیم از \fBwindow.\&active.\&title.\&bg.\&color\fR ارث‌بری می‌کند\&.
.PP
.RE
\fBosd.\&border.\&color\fR
.RS 4
رنگ حاشیه نمایش روی صفحه\&. در صورت عدم تنظیم از \fBosd.\&label.\&text.\&color\fR ارث‌بری می‌کند\&.
.PP
.RE
\fBosd.\&border.\&width\fR
.RS 4
عرض حاشیه نمایش روی صفحه\&. در صورت عدم تنظیم از \fBborder.\&width\fR ارث‌بری می‌کند\&.
.PP
.RE
\fBosd.\&label.\&text.\&color\fR
.RS 4
رنگ متن نمایش روی صفحه\&. در صورت عدم تنظیم از \fBwindow.\&active.\&label.\&text.\&color\fR ارث‌بری می‌کند\&.
.PP
.RE
\fBosd.\&window\-switcher.\&style\-classic\fR
.RS 4
تم برای تعویض‌کننده پنجره هنگام استفاده از <windowSwitcher style="classic" />\&.
.PP
.RE
\fBosd.\&window\-switcher.\&style\-classic.\&width\fR
.RS 4
عرض تعویض‌کننده پنجره به پیکسل\&. می‌تواند درصدی از عرض نمایشگر با پسوند '%' نیز باشد (مانند 70%)\&. پیش‌فرض 600 است\&.
.PP
.RE
\fBosd.\&window\-switcher.\&style\-classic.\&padding\fR
.RS 4
فاصله درونی تعویض‌کننده پنجره به پیکسل\&. پیش‌فرض 4 است\&.
.PP
.RE
\fBosd.\&window\-switcher.\&style\-classic.\&item.\&padding.\&x\fR
.RS 4
فاصله درونی افقی مدخل‌های تعویض‌کننده پنجره به پیکسل\&. پیش‌فرض 10 است\&.
.PP
.RE
\fBosd.\&window\-switcher.\&style\-classic.\&item.\&padding.\&y\fR
.RS 4
فاصله درونی عمودی مدخل‌های تعویض‌کننده پنجره به پیکسل\&. پیش‌فرض 1 است\&.
.PP
.RE
\fBosd.\&window\-switcher.\&style\-classic.\&item.\&active.\&border.\&width\fR
.RS 4
عرض حاشیه کادر انتخاب در تعویض‌کننده پنجره به پیکسل\&. پیش‌فرض 2 است\&.
.PP
.RE
\fBosd.\&window\-switcher.\&style\-classic.\&item.\&active.\&border.\&color\fR
.RS 4
رنگ حاشیه اطراف آیتم انتخاب‌شده تعویض‌کننده پنجره\&. پیش‌فرض \fBosd.\&label.\&text.\&color\fR با ۵۰٪ شفافیت است\&.
.PP
.RE
\fBosd.\&window\-switcher.\&style\-classic.\&item.\&active.\&bg.\&color\fR
.RS 4
رنگ پس‌زمینه آیتم انتخاب‌شده در تعویض‌کننده پنجره\&. پیش‌فرض \fBosd.\&label.\&text.\&color\fR با ۱۵٪ شفافیت است\&.
.PP
.RE
\fBosd.\&window\-switcher.\&style\-classic.\&item.\&icon.\&size\fR
.RS 4
اندازه آیکون در تعویض‌کننده پنجره به پیکسل\&. در صورت عدم تنظیم، از اندازه فونت استخراج‌شده استفاده می‌شود\&.
.PP
.RE
\fBosd.\&window\-switcher.\&style\-thumbnail\fR
.RS 4
تم برای تعویض‌کننده پنجره هنگام استفاده از <windowSwitcher style="thumbnail" />\&.
.PP
.RE
\fBosd.\&window\-switcher.\&style\-thumbnail.\&width.\&max\fR
.RS 4
حداکثر عرض تعویض‌کننده پنجره به پیکسل یا درصد\&. پیش‌فرض 80% است\&.
.PP
.RE
\fBosd.\&window\-switcher.\&style\-thumbnail.\&padding\fR
.RS 4
فاصله درونی تعویض‌کننده پنجره به پیکسل\&. پیش‌فرض 4 است\&.
.PP
.RE
\fBosd.\&window\-switcher.\&style\-thumbnail.\&item.\&width\fR
.RS 4
عرض آیتم‌های تعویض‌کننده پنجره به پیکسل\&. پیش‌فرض 300 است\&.
.PP
.RE
\fBosd.\&window\-switcher.\&style\-thumbnail.\&item.\&height\fR
.RS 4
ارتفاع آیتم‌های تعویض‌کننده پنجره به پیکسل\&. پیش‌فرض 250 است\&.
.PP
.RE
\fBosd.\&window\-switcher.\&style\-thumbnail.\&item.\&padding\fR
.RS 4
فاصله درونی آیتم‌های تعویض‌کننده پنجره به پیکسل\&. پیش‌فرض 2 است\&.
.PP
.RE
\fBosd.\&window\-switcher.\&style\-thumbnail.\&item.\&active.\&border.\&width\fR
.RS 4
عرض حاشیه آیتم‌های انتخاب‌شده تعویض‌کننده پنجره به پیکسل\&. پیش‌فرض 2 است\&.
.PP
.RE
\fBosd.\&window\-switcher.\&style\-thumbnail.\&item.\&active.\&border.\&color\fR
.RS 4
رنگ حاشیه اطراف آیتم‌های انتخاب‌شده تعویض‌کننده پنجره\&. پیش‌فرض \fBosd.\&label.\&text.\&color\fR با ۵۰٪ شفافیت است\&.
.PP
.RE
\fBosd.\&window\-switcher.\&style\-thumbnail.\&item.\&active.\&bg.\&color\fR
.RS 4
رنگ آیتم‌های انتخاب‌شده تعویض‌کننده پنجره\&. پیش‌فرض \fBosd.\&label.\&text.\&color\fR با ۱۵٪ شفافیت است\&.
.PP
.RE
\fBosd.\&window\-switcher.\&style\-thumbnail.\&item.\&icon.\&size\fR
.RS 4
اندازه آیکون‌های پنجره در آیتم‌های تعویض‌کننده پنجره به پیکسل\&. پیش‌فرض 60 است\&.
.PP
.RE
\fBosd.\&window\-switcher.\&preview.\&border.\&width\fR
.RS 4
عرض حاشیه طرح کلی نشان‌داده‌شده به عنوان پیش‌نمایش پنجره انتخاب‌شده\&. پیش‌فرض ارث‌بری از \fBosd.\&border.\&width\fR است\&.
.PP
.RE
\fBosd.\&window\-switcher.\&preview.\&border.\&color\fR
.RS 4
رنگ(های) طرح کلی نشان‌داده‌شده به عنوان پیش‌نمایش پنجره انتخاب‌شده توسط تعویض‌کننده پنجره\&. مقدار می‌تواند یک رنگ یا حداکثر ۳ رنگ جداشده با کاما باشد (مانند "#ffffff,#000000,#ffffff")\&.
.PP
.RE
\fBosd.\&workspace\-switcher.\&boxes.\&width\fR
.RS 4
عرض جعبه‌ها در تعویض‌کننده فضای کاری به پیکسل\&. تنظیم روی 0 جعبه‌ها را غیرفعال می‌کند\&. پیش‌فرض 20 است\&.
.PP
.RE
\fBosd.\&workspace\-switcher.\&boxes.\&height\fR
.RS 4
ارتفاع جعبه‌ها در تعویض‌کننده فضای کاری به پیکسل\&. پیش‌فرض 20 است\&.
.PP
.RE
\fBosd.\&workspace\-switcher.\&boxes.\&border.\&width\fR
.RS 4
عرض حاشیه جعبه‌ها در تعویض‌کننده فضای کاری به پیکسل\&. پیش‌فرض 2 است\&.
.PP
.RE
\fBsnapping.\&overlay.\&region.\&bg.\&enabled\fR [yes|no]
.RS 4
نمایش یک مستطیل توپر به عنوان هم‌پوشانی هنگام چفت شدن (snap) پنجره به یک ناحیه\&. پیش‌فرض yes برای رندرهای سخت‌افزاری و no برای رندرهای نرم‌افزاری است\&.
.PP
.RE
\fBsnapping.\&overlay.\&edge.\&bg.\&enabled\fR [yes|no]
.RS 4
نمایش یک مستطیل توپر هنگام چفت شدن پنجره به یک لبه\&.
.PP
.RE
\fBsnapping.\&overlay.\&region.\&border.\&enabled\fR [yes|no]
.RS 4
نمایش یک مستطیل توخالی (دارای خط حاشیه) به عنوان هم‌پوشانی هنگام چفت شدن پنجره به یک ناحیه\&. پیش‌فرض no برای سخت‌افزاری و yes برای نرم‌افزاری است\&.
.PP
.RE
\fBsnapping.\&overlay.\&edge.\&border.\&enabled\fR [yes|no]
.RS 4
نمایش یک مستطیل توخالی هنگام چفت شدن پنجره به یک لبه\&.
.PP
.RE
\fBsnapping.\&overlay.\&region.\&bg.\&color\fR
.RS 4
رنگ مستطیل توپر هنگام چفت شدن پنجره به یک ناحیه\&. پیش‌فرض #8080b380 است\&.
.PP
.RE
\fBsnapping.\&overlay.\&edge.\&bg.\&color\fR
.RS 4
رنگ مستطیل توپر هنگام چفت شدن پنجره به یک لبه\&. پیش‌فرض #8080b380 است\&.
.PP
.RE
\fBsnapping.\&overlay.\&region.\&border.\&width\fR
.RS 4
عرض حاشیه مستطیل توخالی هنگام چفت شدن پنجره به یک ناحیه\&. در صورت عدم تنظیم از osd.\&border.\&width ارث‌بری می‌کند\&.
.PP
.RE
\fBsnapping.\&overlay.\&edge.\&border.\&width\fR
.RS 4
عرض حاشیه مستطیل توخالی هنگام چفت شدن پنجره به یک لبه\&.
.PP
.RE
\fBsnapping.\&overlay.\&region.\&border.\&color\fR
.RS 4
رنگ(های) مستطیل توخالی هنگام چفت شدن پنجره به یک ناحیه\&.
.PP
.RE
\fBsnapping.\&overlay.\&edge.\&border.\&color\fR
.RS 4
رنگ(های) مستطیل توخالی هنگام چفت شدن پنجره به یک لبه\&.
.PP
.RE
\fBborder.\&color\fR
.RS 4
تنظیم همزمان \fBwindow.\&active.\&border.\&color\fR و \fBwindow.\&inactive.\&border.\&color\fR\&. این گزینه منسوخ است اما برای سازگاری با تم‌های قدیمی‌تر پشتیبانی می‌شود\&.
.PP
.RE
\fBmagnifier.\&border.\&width\fR
.RS 4
عرض حاشیه پنجره ذره‌بین به پیکسل\&. پیش‌فرض 1 است\&.
.PP
.RE
\fBmagnifier.\&border.\&color\fR
.RS 4
رنگ حاشیه پنجره ذره‌بین\&. پیش‌فرض #ff0000 (قرمز) است\&.
.PP
.RE
.SH "دکمه‌ها (BUTTONS)"
.PP
تصاویر مورد استفاده برای آیکون‌های نوار عنوان، دکمه‌ها نامیده می‌شوند\&.
.PP
قالب‌های تصویری زیر پشتیبانی می‌شوند و به ترتیب اولویت جستجو فهرست شده‌اند:
.PP
.PD 0
.IP \(bu 4
png
.IP \(bu 4
svg
.IP \(bu 4
xbm
.PD
.PP
به طور پیش‌فرض، دکمه‌ها فایل‌های ۱ بیتی xbm هستند\&. این‌ها ماسک‌هایی هستند که در آن‌ها 0 به معنی شفاف و 1 به معنای رنگی است\&. فایل‌های xbm در همان دایرکتوری حاوی فایل themerc در تم قرار می‌گیرند\&. دکمه‌های xbm زیر پشتیبانی می‌شوند:
.PP
.PD 0
.IP \(bu 4
max.\&xbm
.IP \(bu 4
iconify.\&xbm
.IP \(bu 4
close.\&xbm
.IP \(bu 4
menu.\&xbm
.IP \(bu 4
max_toggled.\&xbm
.IP \(bu 4
desk.\&xbm
.IP \(bu 4
desk_toggled.\&xbm
.IP \(bu 4
shade.\&xbm
.IP \(bu 4
shade_toggled.\&xbm
.PD
.PP
آیکون‌های اضافی را می‌توان برای نمایش در هنگام قرار گرفتن نشانگر ماوس روی دکمه مورد نظر تعریف کرد:
.PP
.PD 0
.IP \(bu 4
max_hover.\&xbm
.IP \(bu 4
iconify_hover.\&xbm
.IP \(bu 4
close_hover.\&xbm
.IP \(bu 4
menu_hover.\&xbm
.IP \(bu 4
max_toggled_hover.\&xbm
.IP \(bu 4
desk_hover.\&xbm
.IP \(bu 4
desk_toggle_hover.\&xbm
.IP \(bu 4
shade_hover.\&xbm
.IP \(bu 4
shade_toggle_hover.\&xbm
.PD
.PP
یک مزیت دکمه‌های xbm نسبت به سایر قالب‌ها این است که رنگ آن‌ها بر اساس تم تغییر می‌کند\&. قالب‌های دیگر از پسوندهای "-active" و "-inactive" برای هماهنگی با رنگ‌های نوار عنوان متناظر استفاده می‌کنند؛ مانند "close\-active.\&png"\&.
.PP
به دلایل سازگاری، نام‌های جایگزین زیر برای فایل‌های xbm پشتیبانی می‌شوند:
.PP
.PD 0
.IP \(bu 4
max_hover_toggled.\&xbm به جای max_toggled_hover.\&xbm
.PD
.PP
هنگام استفاده از آیکون‌های png یا svg، برای داشتن تجربه کامل یک تم، تمام آیکون‌های زیر باید اضافه شوند:
.PP
.PD 0
.IP \(bu 4
close\-active.\&[png|svg]
.IP \(bu 4
close_hover\-active.\&[png|svg]
.IP \(bu 4
close_hover\-inactive.\&[png|svg]
.IP \(bu 4
close\-inactive.\&[png|svg]
.IP \(bu 4
iconify\-active.\&[png|svg]
.IP \(bu 4
iconify_hover\-active.\&[png|svg]
.IP \(bu 4
iconify_hover\-inactive.\&[png|svg]
.IP \(bu 4
iconify\-inactive.\&[png|svg]
.IP \(bu 4
max\-active.\&[png|svg]
.IP \(bu 4
max_hover\-active.\&[png|svg]
.IP \(bu 4
max_hover\-inactive.\&[png|svg]
.IP \(bu 4
max\-inactive.\&[png|svg]
.IP \(bu 4
max_toggled\-active.\&[png|svg]
.IP \(bu 4
max_toggled_hover\-active.\&[png|svg]
.IP \(bu 4
max_toggled_hover\-inactive.\&[png|svg]
.IP \(bu 4
max_toggled\-inactive.\&[png|svg]
.IP \(bu 4
menu\-active.\&[png|svg]
.IP \(bu 4
menu_hover\-active.\&[png|svg]
.IP \(bu 4
menu_hover\-inactive.\&[png|svg]
.IP \(bu 4
menu\-inactive.\&[png|svg]
.IP \(bu 4
shade\-active.\&[png|svg]
.IP \(bu 4
shade_hover\-active.\&[png|svg]
.IP \(bu 4
shade_hover\-inactive.\&[png|svg]
.IP \(bu 4
shade\-inactive.\&[png|svg]
.IP \(bu 4
shade_toggled\-active.\&[png|svg]
.IP \(bu 4
shade_toggled\-inactive.\&[png|svg]
.IP \(bu 4
shade_toggled_hover\-active.\&[png|svg]
.IP \(bu 4
shade_toggled_hover\-inactive.\&[png|svg]
.IP \(bu 4
desk\-active.\&[png|svg]
.IP \(bu 4
desk_hover\-active.\&[png|svg]
.IP \(bu 4
desk_hover\-inactive.\&[png|svg]
.IP \(bu 4
desk\-inactive.\&[png|svg]
.IP \(bu 4
desk_toggled\-active.\&[png|svg]
.IP \(bu 4
desk_toggled\-inactive.\&[png|svg]
.IP \(bu 4
desk_toggled_hover\-active.\&[png|svg]
.IP \(bu 4
desk_toggled_hover\-inactive.\&[png|svg]
.PD
.PP
.SH "تعاریف (DEFINITIONS)"
.PP
دستگیره (handle) تزئین لبه پنجره در پایین پنجره است\&.
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
labwc(1), labwc\-config(5), labwc\-actions(5)