.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "ICEWM-WINOPTIONS 5" .TH ICEWM-WINOPTIONS 5 2026-08-06 "icewm\ 4.1.0" "Standards, Environments and Macros" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" .IX Subsection "NAME" .Vb 1 \& icewm\-winoptions \- فایل پیکربندی گزینه‌های پنجره در IceWM .Ve .SH "خلاصه دستور (SYNOPSIS)" .IX Subsection "SYNOPSIS" .Vb 5 \& $ICEWM_PRIVCFG/winoptions \& $XDG_CONFIG_HOME/icewm/winoptions \& $HOME/.icewm/winoptions \& /usr/etc/icewm/winoptions \& /usr/share/icewm/winoptions .Ve .SH "توضیحات (DESCRIPTION)" .IX Subsection "DESCRIPTION" فایل \fIwinoptions\fR در IceWM شامل تنظیماتی برای کنترل ظاهر و رفتار پنجره‌ها \fIبه‌ازای هر برنامه\fR است. به عنوان مثال، این گزینه‌ها کادر پنجره، محل قرارگیری و اندازه، لایه پنجره، فضای کاری آن، وضعیت نمایش در نوار وظیفه و رفتار فوکوس را کنترل می‌کنند. .PP گزینه‌های winoptions هنگام شروع به کار \fBicewm\fR\|(1) اعمال می‌شوند. با این حال، می‌توان بعداً با استفاده از \fBicesh\fR\|(1) یا \fBicewmhint\fR\|(1) آن‌ها را بازنویسی کرد. دستور \f(CW\*(C`icesh winoptions\*(C'\fR به icewm دستور می‌دهد تا فایل \fIwinoptions\fR را مجدداً بارگذاری کند، در حالی که \fIicewmhint\fR یک نمونهٔ خاص از برنامه را هنگام شروع تنظیم می‌کند. .SH "قالب‌بندی (FORMAT)" .IX Subsection "FORMAT" هر خط در این فایل باید در یکی از قالب‌های زیر باشد: .RS 4 .IP "\fINAME\fR\fB.\fR\fICLASS\fR\fB.\fR\fIOPTION\fR\fB:\fR \fIVALUE\fR" 4 .IX Item "NAME.CLASS.OPTION: VALUE" .PD 0 .IP "\fICLASS\fR\fB.\fR\fIROLE\fR\fB.\fR\fIOPTION\fR\fB:\fR \fIVALUE\fR" 4 .IX Item "CLASS.ROLE.OPTION: VALUE" .IP "\fINAME\fR\fB.\fR\fIROLE\fR\fB.\fR\fIOPTION\fR\fB:\fR \fIVALUE\fR" 4 .IX Item "NAME.ROLE.OPTION: VALUE" .IP "\fICLASS\fR\fB.\fR\fIOPTION\fR\fB:\fR \fIVALUE\fR" 4 .IX Item "CLASS.OPTION: VALUE" .IP "\fINAME\fR\fB.\fR\fIOPTION\fR\fB:\fR \fIVALUE\fR" 4 .IX Item "NAME.OPTION: VALUE" .IP "\fIROLE\fR\fB.\fR\fIOPTION\fR\fB:\fR \fIVALUE\fR" 4 .IX Item "ROLE.OPTION: VALUE" .IP "\fB.\fR\fIOPTION\fR\fB:\fR \fIVALUE\fR" 4 .IX Item ".OPTION: VALUE" .PD .RE .RS 4 .RE .PP در اینجا \fINAME\fR و \fICLASS\fR از ویژگی \fBWM_CLASS\fR پنجره گرفته شده‌اند. این مقادیر را می‌توان در خروجی دستور \f(CW\*(C`icesh \-a getClass\*(C'\fR یافت. .PP در حالی که \fIROLE\fR به ویژگی \fBWM_WINDOW_ROLE\fR پنجره اشاره دارد که نام خاص نمونهٔ برنامه است. تنها اقلیتی از پنجره‌ها این ویژگی را دارند. خروجی \f(CW\*(C`icesh \-a list prop WM_WINDOW_ROLE\*(C'\fR را ببینید. .PP در موارد نادر، ممکن است یک نام، کلاس یا نقش حاوی یک نقطه باشد. در این صورت، نقطه باید با یک تک بک‌اسلش اسکیپ شود. .PP در نهایت، جفت \fIOPTION: VALUE\fR به گزینه‌ها و مقادیر شرح‌داده‌شده در ادامه اشاره دارد. خطی که فقط با یک نقطه شروع شود و پس از آن یک جفت گزینه/مقدار بیاید، بر تمام پنجره‌ها اعمال می‌شود. .SH "گزینه‌ها (OPTIONS)" .IX Subsection "OPTIONS" چهار دسته‌بندی وجود دارد: \fIعمومی (general)\fR، \fIعملکردی (function)\fR، \fIتزیینات (decor)\fR و \fIویژگی‌ها (feature)\fR. .SS "گزینه‌های عمومی (GENERAL OPTIONS)" .IX Subsection "GENERAL OPTIONS" این گزینه‌ها ویژگی‌های عمومی پنجره‌ها را کنترل می‌کنند: .IP "\fBicon\fR: \fINAME\fR (پیش‌فرض: none)" 4 .IX Item "icon: NAME (default: none)" نام آیکون پنجره را مشخص می‌کند. \fINAME\fR نام آیکون است، مانند \fIutilities\-terminal\fR. همچنین می‌تواند یک فایل مانند \fIxterm.png\fR، یک مسیر کامل، یا پیشوندی از یک مسیر بدون اندازه یا پسوند باشد. .IP "\fBworkspace\fR: \fIWORKSPACE\fR (پیش‌فرض: current)" 4 .IX Item "workspace: WORKSPACE (default: current)" فضای کاری پیش‌فرض پنجره را تعیین می‌کند. \fIWORKSPACE\fR شماره فضای کاری با شمارش از صفر (0) است. .IP "\fBlayer\fR: {\fILAYER\fR|\fINUMBER\fR} (پیش‌فرض: Normal)" 4 .IX Item "layer: {LAYER|NUMBER} (default: Normal)" لایهٔ پیش‌فرض پنجره را مشخص می‌کند. لایه می‌تواند یکی از نام‌های زیر یا عددی بین صفر تا پانزده باشد: .Sp .Vb 9 \& Desktop (0) پنجره میزکار (Desktop). \& Below (2) زیر لایه پیش‌فرض. \& Normal (4) لایه پیش‌فرض برای پنجره‌ها. \& OnTop (6) بالای لایه پیش‌فرض. \& Dock (8) پنجره‌های متصل (Dock) در لبه صفحه. \& AboveDock (10) پنجره‌های بالاتر از Dock. \& Menu (12) لایه مخصوص منوها. \& Fullscreen (14) هنگام تمام‌صفحه بودن و داشتن فوکوس. \& AboveAll (15) همیشه بالاتر از همه‌چیز. .Ve .IP "\fBgeometry\fR \fIgeometry\fR (پیش‌فرض: ویژگی WM_SIZE_HINTS)" 4 .IX Item "geometry geometry (default: WM_SIZE_HINTS property)" ابعاد و موقعیت (geometry) پیش‌فرض پنجره. این هندسه باید در قالبی مشخص شود که توسط \fBXParseGeometry\fR\|(3) قابل تجزیه باشد: .Sp .Vb 1 \& [=][{xX}][{+\-}{+\-}] .Ve .Sp هندسه پیش‌فرض از ویژگی WM_SIZE_HINTS پنجره یا در غیر این صورت از هندسه اولیه پنجره گرفته می‌شود. این گزینه پیش‌فرض را بازنویسی می‌کند. .IP "\fBtray\fR: {\fBIgnore\fR|\fBMinimized\fR|\fBExclusive\fR|\fINUMBER\fR} (پیش‌فرض: 0)" 4 .IX Item "tray: {Ignore|Minimized|Exclusive|NUMBER} (default: 0)" گزینه سینی سیستم (tray) پیش‌فرض برای پنجره. این گزینه هم بر سینی و هم بر پنل وظایف تأثیر می‌گذارد. Tray می‌تواند یکی از سه رشته زیر یا عددی از صفر (0) تا دو (2) باشد: .Sp .Vb 3 \& Ignore (0) هیچ آیکونی به سینی اضافه نمی‌شود. \& Minimized (1) اضافه شدن به سینی، بدون دکمه در نوار وظیفه هنگام کمینه‌شدن. \& Exclusive (2) اضافه شدن به سینی، بدون دکمه در نوار وظیفه. .Ve .IP "\fBorder\fR: \fINUMBER\fR (پیش‌فرض: 0)" 4 .IX Item "order: NUMBER (default: 0)" ترتیب مرتب‌سازی برای دکمه‌های نوار وظیفه، آیکون‌های سینی، جابجایی سریع و فهرست پنجره‌ها. مقدار پیش‌فرض صفر است. مقادیر مثبت افزایشی به سمت راست و مقادیر منفی کاهشی به سمت چپ می‌روند. .IP "\fBopacity\fR: \fINUMBER\fR (پیش‌فرض: 0)" 4 .IX Item "opacity: NUMBER (default: 0)" اگر \fINUMBER\fR مقداری بین 1 تا 100 باشد، ویژگی _NET_WM_WINDOW_OPACITY را تنظیم می‌کند. \fINUMBER\fR به عنوان درصدی از حداکثر کدر بودن (عدم شفافیت) تفسیر می‌شود. .IP "\fBkeyboard\fR: \fIlayout\fR (پیش‌فرض: none)" 4 .IX Item "keyboard: layout (default: none)" چیدمان صفحه‌کلید مورد استفاده برای این پنجره را مشخص می‌کند. \fIlayout\fR نام چیدمان صفحه‌کلید است. این مقدار می‌تواند فهرستی از آرگومان‌های جداشده با فاصله برای برنامهٔ \fBsetxkbmap\fR باشد. لطفاً توجه داشته باشید که برای کارکرد این قابلیت، \fBsetxkbmap\fR باید نصب باشد. همچنین یک چیدمان صفحه‌کلید پیش‌فرض را در \fIpreferences\fR تعریف کنید. .IP "\fBframe\fR: \fIlabel\fR (پیش‌فرض: none)" 4 .IX Item "frame: label (default: none)" همه پنجره‌های دارای برچسب فریم یکسان، تبدیل به تب‌هایی در یک فریم واحد می‌شوند. .SS "گزینه‌های عملکردی (FUNCTION OPTIONS)" .IX Subsection "FUNCTION OPTIONS" گزینه‌های عملکردی توانایی انجام یک عمل روی پنجره را فعال/غیرفعال (1/0) می‌کنند. حالت پیش‌فرض برای همه گزینه‌ها فعال (1) است مگر اینکه توسط برنامه بازنویسی شود: .PP .Vb 7 \& fClose: {0|1} قابل بستن باشد. (پیش‌فرض: 1) \& fHide: {0|1} قابل مخفی‌سازی باشد. (پیش‌فرض: 1) \& fMaximize: {0|1} قابل بیشینه‌سازی باشد. (پیش‌فرض: 1) \& fMinimize: {0|1} قابل کمینه‌سازی باشد. (پیش‌فرض: 1) \& fMove: {0|1} قابل جابجایی باشد. (پیش‌فرض: 1) \& fResize: {0|1} قابل تغییر اندازه باشد. (پیش‌فرض: 1) \& fRollup: {0|1} قابل جمع‌شدن به بالا باشد. (پیش‌فرض: 1) .Ve .SS "گزینه‌های تزیینات (DECOR OPTIONS)" .IX Subsection "DECOR OPTIONS" گزینه‌های تزیینات، تزیینات پنجره را فعال/غیرفعال (1/0) می‌کنند. حالت پیش‌فرض برای همه گزینه‌ها فعال (1) است مگر اینکه توسط برنامه یا پوسته بازنویسی شود: .PP .Vb 10 \& dBorder: {0|1} دارای حاشیه/کادر باشد. (پیش‌فرض: 1) \& dClose: {0|1} دارای دکمه بستن باشد. (پیش‌فرض: 1) \& dDepth: {0|1} دارای دکمه عمق باشد. (پیش‌فرض: 1) \& dHide: {0|1} دارای دکمه مخفی‌سازی باشد. (پیش‌فرض: 1) \& dMaximize: {0|1} دارای دکمه بیشینه‌سازی باشد. (پیش‌فرض: 1) \& dMinimize: {0|1} دارای دکمه کمینه‌سازی باشد. (پیش‌فرض: 1) \& dResize: {0|1} دارای دستگیره تغییر اندازه. (پیش‌فرض: 1) \& dRollup: {0|1} دارای دکمه جمع‌شدن باشد. (پیش‌فرض: 1) \& dSysMenu: {0|1} دارای منوی پنجره باشد. (پیش‌فرض: 1) \& dTitleBar: {0|1} دارای نوار عنوان باشد. (پیش‌فرض: 1) .Ve .SS "گزینه‌های ویژگی‌ها (FEATURE OPTIONS)" .IX Subsection "FEATURE OPTIONS" گزینه‌های ویژگی‌ها، امکانات اضافی پنجره را فعال/غیرفعال (1/0) می‌کنند. حالت پیش‌فرض برای همه گزینه‌ها غیرفعال (0) است مگر اینکه توسط برنامه بازنویسی شود: .PP .Vb 10 \& allWorkspaces: {1|0} نمایش در تمام فضاهای کاری. \& appTakesFocus: {1|0} اجازه به برنامه برای گرفتن فوکوس. \& doNotCover: {1|0} پنجره‌های دیگر روی آن قرار نگیرند. \& doNotFocus: {1|0} به آن فوکوس داده نشود. \& doNotManage: {1|0} به هیچ وجه مدیریت نشود. \& forcedClose: {1|0} بدون پنجرهٔ تأیید برای بستن. \& fullKeys: {1|0} کلیدهای میانبر icewm اعمال نشوند. \& ignoreNoFocusHint: {1|0} فوکوس حتی در صورت تنظیم no\-input. \& ignorePagerPreview: {1|0} عدم نمایش در پیش‌نمایش صفحه‌بندی. \& ignorePositionHint: {1|0} همیشه اجازه جای‌گذاری پنجره به icewm. \& ignoreQuickSwitch: {1|0} عدم نمایش در جابجایی سریع (Alt+Tab). \& ignoreTaskBar: {1|0} عدم نمایش در نوار وظیفه. \& ignoreUrgentHint: {1|0} نادیده گرفتن هشدارهای فوری. \& ignoreWinList: {1|0} عدم نمایش در فهرست پنجره‌ها. \& ignoreActivationMessages: {1|0} تنها کاربر بتواند به پنجره فوکوس دهد. \& ignoreOverrideRedirect: {1|0} نادیده گرفتن پرچم override redirect. \& ignoreUserTime: {1|0} نادیده گرفتن wm_user_time و startup_id. \& noFocusOnAppRaise: {1|0} عدم فوکوس خودکار هنگام بالا آمدن. \& noFocusOnMap: {1|0} عدم فوکوس هنگام مپ شدن پنجره. \& noIgnoreTaskBar: {1|0} همیشه در نوار وظیفه نمایش داده شود. \& startClose: {1|0} پنجره فوراً بسته شود. \& startFullscreen: {1|0} شروع به‌صورت تمام‌صفحه. \& startMaximized: {1|0} شروع به‌صورت بیشینه (بزرگ‌شده). \& startMaximizedHorz: {1|0} شروع به‌صورت افقی بیشینه. \& startMaximizedVert: {1|0} شروع به‌صورت عمودی بیشینه. \& startMinimized: {1|0} شروع به‌صورت کمینه (کوچک‌شده). .Ve .SH "مثال‌ها (EXAMPLES)" .IX Subsection "EXAMPLES" این مثال از مقدار ویژگی WM_WINDOW_ROLE با عنوان \f(CW\*(C`pop\-up\*(C'\fR استفاده می‌کند تا فوکوس ورودی را از پنجره‌های پاپ‌آپ \fIChrome\fR سلب کرده و درخواست بستن فوری آن‌ها را بدهد. .PP .Vb 9 \& google\-chrome.pop\-up.doNotFocus: 1 \& google\-chrome.pop\-up.forcedClose: 1 \& google\-chrome.pop\-up.ignorePagerPreview: 1 \& google\-chrome.pop\-up.ignoreUrgentHint: 1 \& google\-chrome.pop\-up.layer: Below \& google\-chrome.pop\-up.noFocusOnAppRaise: 1 \& google\-chrome.pop\-up.noFocusOnMap: 1 \& google\-chrome.pop\-up.startClose: 1 \& google\-chrome.pop\-up.startMinimized: 1 .Ve .PP نرم‌افزار IceWM برنامه‌های متصل (dockapps) را به‌طور خودکار در یک نگه‌دارنده قرار می‌دهد، اما برای مواردی که با پروتکل سازگار نیستند، می‌توان آن را شبیه‌سازی کرد. یک dockapp شبیه‌سازی‌شده باید در تمام فضاهای کاری ظاهر شود، بدون تزیینات باشد و همیشه در یک مکان ثابت قابل مشاهده باشد. .PP .Vb 8 \& wmtime.wmtime.allWorkspaces: 1 \& wmtime.wmtime.ignoreTaskBar: 1 \& wmtime.wmtime.ignoreQuickSwitch: 1 \& wmtime.wmtime.ignoreWinList: 1 \& wmtime.wmtime.layer: Below \& wmtime.wmtime.dTitleBar: 0 \& wmtime.wmtime.dBorder: 1 \& wmtime.wmtime.geometry: 64x64\-74\-100 .Ve .PP مثال زیر نشان می‌دهد که چگونه یک برنامه فقط-خروجی با اشکال خاص، بدون نوار عنوان و با حداقل کارکرد نمایش داده می‌شود. .PP .Vb 11 \& xeyes.tray: Exclusive \& xeyes.ignoreWinList: 0 \& xeyes.ignoreTaskBar: 1 \& xeyes.allWorkspaces: 1 \& xeyes.dTitleBar: 0 \& xeyes.dBorder: 0 \& xeyes.dSysMenu: 0 \& xeyes.dResize: 0 \& xeyes.dClose: 0 \& xeyes.dMinimize: 0 \& xeyes.dMaximize: 0 .Ve .SH "فایل‌ها (FILES)" .IX Subsection "FILES" مسیرهای قرارگیری فایل \fIwinoptions\fR به شرح زیر است: .PP .Vb 5 \& $ICEWM_PRIVCFG/winoptions \& $XDG_CONFIG_HOME/icewm/winoptions \& $HOME/.icewm/winoptions \& /usr/etc/icewm/winoptions \& /usr/share/icewm/winoptions .Ve .PP مسیرها به ترتیب فهرست‌شده جستجو می‌شوند؛ اولین فایل یافت‌شده خوانده شده و بقیه نادیده گرفته می‌شوند. .SH "همچنین ببینید (SEE ALSO)" .IX Subsection "SEE ALSO" \&\fBicewm\fR\|(1), \&\fBicesh\fR\|(1), \&\fBicewmhint\fR\|(1), \&\fBsetxkbmap\fR\|(1), \&\fBXParseGeometry\fR\|(3). .SH "نویسندگان (AUTHORS)" .IX Subsection "AUTHOR" Brian Bidulock . .SH "مجوز (LICENSE)" .IX Subsection "LICENSE" \&\fBIceWM\fR تحت مجوز GNU Library General Public License منتشر شده است. فایل \fICOPYING\fR موجود در بسته توزیع را ببینید.