.\" -*- 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 "ICEWMHINT 1" .TH ICEWMHINT 1 2026-08-06 "icewm\ 4.1.0" "User Commands" .\" 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" icewmhint \- ارسال نشانه‌ها و ویژگی‌های پنجره به مدیر پنجره IceWM .SH "خلاصه دستور (SYNOPSIS)" .IX Subsection "SYNOPSIS" \&\fBicewmhint\fR \fICLASS\fR\fB.\fR\fIINSTANCE\fR \fIOPTION\fR \fIVALUE\fR ... .SH "توضیحات (DESCRIPTION)" .IX Subsection "DESCRIPTION" \&\fBicewmhint\fR ابزاری برای ارسال نشانه‌ها و ویژگی‌های پنجره (hints) در IceWM به \fBicewm\fR\|(1) است. \&\fBicewm\fR از این نشانه‌ها برای نخستین \fIکلاینت X11\fR که متعاقباً اجرا می‌شود استفاده می‌کند. این تنظیمات بر نشانه‌های موجود در پرونده \fBicewm\-winoptions\fR\|(1) اولویت دارند. .PP هر نشانه یک سه‌تایی متشکل از \fIclass.instance\fR، یک \fIIceWM winoption\fR و مقدار آن است. در هر بار اجرای \fBicewmhint\fR می‌توان چندین نشانه را مشخص کرد. .PP نشانه‌ها از طریق ویژگی \f(CW\*(C`_ICEWM_WINOPTHINT\*(C'\fR روی پنجره ریشه (root window) منتقل می‌شوند. \fBicewmhint\fR نشانه‌ها را به این ویژگی اضافه می‌کند، در حالی که \fBicewm\fR پس از خواندن ویژگی، آن را حذف می‌کند. .SH "گزینه‌ها (OPTIONS)" .IX Subsection "OPTIONS" \&\fBicewmhint\fR گزینه‌های زیر را می‌شناسد: .SS "گزینه‌های دستوری (COMMAND OPTIONS)" .IX Subsection "COMMAND OPTIONS" در هر بار اجرا فقط می‌توان یک گزینه دستوری را مشخص کرد. اگر هیچ گزینه دستوری مشخص نشود، تجزیه و پردازش آرگومان‌ها انجام می‌شود. .IP "\fB\-h\fR, \fB\-\-help\fR" 4 .IX Item "-h, --help" نمایش خلاصه راهنمای استفاده در خروجی استاندارد (\fIstdout\fR) و خروج. .IP "\fB\-V\fR, \fB\-\-version\fR" 4 .IX Item "-V, --version" نمایش نسخه برنامه در خروجی استاندارد (\fIstdout\fR) و خروج. .IP "\fB\-C\fR, \fB\-\-copying\fR" 4 .IX Item "-C, --copying" نمایش مجوزهای رونوشت‌برداری و حق نشر برنامه در خروجی استاندارد (\fIstdout\fR) و خروج. .SS "گزینه‌های عمومی (GENERAL OPTIONS)" .IX Subsection "GENERAL OPTIONS" .IP "\fB\-d\fR, \fB\-\-display\fR=\fIDISPLAY\fR" 4 .IX Item "-d, --display=DISPLAY" مشخص کردن DISPLAY در X11. در صورت عدم تعیین، مقدار پیش‌فرض \fR\f(CB$DISPLAY\fR\fB\fR خواهد بود. .SH "آرگومان‌ها (ARGUMENTS)" .IX Subsection "ARGUMENTS" سه آرگومان زیر برای هر نشانه الزامی هستند. .IP \fICLASS\fR\fB.\fR\fIINSTANCE\fR 4 .IX Item "CLASS.INSTANCE" ویژگی \fBWM_CLASS\fR در استاندارد ICCCM 2.0 را بر حسب کلاس منبع و نام منبع که با نقطه (\f(CW\*(C`.\*(C'\fR) جدا شده‌اند مشخص می‌کند. به عنوان مثال: \f(CW\*(C`XTerm.xterm\*(C'\fR. فقط کلاس منبع یا نام منبع بدون نقطه نیز قابل قبول است، مانند \f(CW\*(C`XTerm\*(C'\fR یا \f(CW\*(C`xterm\*(C'\fR. .IP \fIOPTION\fR 4 .IX Item "OPTION" گزینه (\fIOPTION\fR) مورد نظر برای اعمال تغییر را مشخص می‌کند. .IP \fIVALUE\fR 4 .IX Item "VALUE" مقدار (\fIVALUE\fR) را برای گزینه تعیین می‌کند. .PP می‌توان چندین نشانه را مشخص کرد. .SS "آرگومان‌های گزینه‌های عمومی (GENERAL OPTION ARGUMENTS)" .IX Subsection "GENERAL OPTION ARGUMENTS" .IP "\fBicon\fR \fINAME\fR" 4 .IX Item "icon NAME" نام آیکون پنجره‌های مربوط به \fICLASS\fR\fB.\fR\fIINSTANCE\fR را مشخص می‌کند. \fINAME\fR باید نام آیکون باشد. \fBicewm\fR\|(1) از روش معمول خود برای یافتن آیکون استفاده خواهد کرد. مقدار پیش‌فرض، نام ارائه‌شده توسط نشانه‌های مدیر پنجره است. .IP "\fBworkspace\fR \fIWORKSPACE\fR" 4 .IX Item "workspace WORKSPACE" فضای کاری که پنجره \fICLASS\fR\fB.\fR\fIINSTANCE\fR در ابتدا در آن قرار می‌گیرد را مشخص می‌کند. پیش‌فرض، فضای کاری جاری است. \fIWORKSPACE\fR باید شماره فضای کاری با شروع از 0 باشد. .IP "\fBgeometry\fR \fIGEOMETRY\fR" 4 .IX Item "geometry GEOMETRY" ابعاد و موقعیت هندسی اولیه را برای پنجره‌های \fICLASS\fR\fB.\fR\fIINSTANCE\fR داده‌شده مشخص می‌کند. \fIGEOMETRY\fR باید مقداری قابل تجزیه توسط \fBXParseGeometry\fR\|(3) باشد. پیش‌فرض، ابعاد و موقعیت ارائه‌شده توسط نشانه‌های مدیر پنجره است. .IP "\fBorder\fR \fINUMBER\fR" 4 .IX Item "order NUMBER" ترتیب مرتب‌سازی دکمه‌های نوار وظیفه و آیکون‌های سینی سیستم. مقدار پیش‌فرض صفر است. مقادیر مثبت بزرگ‌تر موقعیت را به سمت راست‌تر و مقادیر منفی کوچک‌تر موقعیت را به سمت چپ‌تر می‌برند. گزینه order بر پانل وظایف، پانل سینی و سینی سیستم اعمال می‌شود. .IP "\fBopacity\fR \fINUMBER\fR" 4 .IX Item "opacity NUMBER" اگر \fINUMBER\fR مقداری بین 1 و 100 باشد، ویژگی _NET_WM_WINDOW_OPACITY را تنظیم می‌کند. \fINUMBER\fR به عنوان درصد حداکثر مات بودن تفسیر می‌شود. .IP "\fBlayer\fR {\fILAYER\fR|\fINUMBER\fR}" 4 .IX Item "layer {LAYER|NUMBER}" این گزینه لایه مرتبط با \fICLASS\fR\fB.\fR\fIINSTANCE\fR را مشخص می‌کند. مقدار پیش‌فرض لایه \f(CW\*(C`Normal\*(C'\fR است. \fIVALUE\fR می‌تواند شماره لایه یا نام نمادین آن باشد. نام‌های نمادین لایه‌ها عبارتند از: .Sp .Vb 9 \& 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\*(Aqs. \& Fullscreen (14) When fullscreen and focused. \& AboveAll (15) Always above anything. .Ve .IP "\fBtray\fR {\fBIgnore\fR|\fBMinimized\fR|\fBExclusive\fR|\fINUMBER\fR}" 4 .IX Item "tray {Ignore|Minimized|Exclusive|NUMBER}" رفتار سینی سیستم را برای پنجره‌های با \fICLASS\fR\fB.\fR\fIINSTANCE\fR مشخص می‌کند. این گزینه مختص \fBicewm\fR\|(1) بوده و ویژگی \f(CW\*(C`_ICEWM_TRAY\*(C'\fR مرتبط با پنجره را تنظیم می‌کند. پیش‌فرض \f(CW\*(C`Ignore\*(C'\fR است. \fIVALUE\fR می‌تواند شماره گزینه یا یک نام نمادین به صورت زیر باشد: .Sp .Vb 3 \& Ignore (0) only in task list. \& Minimized (1) icon in tray, task list unminimized. \& Exclusive (2) only in tray, not in task list. .Ve .IP "\fBframe\fR \fIlabel\fR (default: none)" 4 .IX Item "frame label (default: none)" تمام پنجره‌های دارای برچسب فریم یکسان، به صورت زبانه‌ها در یک فریم واحد قرار می‌گیرند. .SS "آرگومان‌های گزینه‌های عملکرد (FUNCTION OPTION ARGUMENTS)" .IX Subsection "FUNCTION OPTION ARGUMENTS" مشخص می‌کند کدام عملکردها برای پنجره‌های با \fICLASS\fR\fB.\fR\fIINSTANCE\fR غیرفعال یا فعال (0/1) هستند. تمام عملکردها به صورت پیش‌فرض فعال (1) هستند مگر اینکه توسط برنامه لغو شوند. عملکردهای شبیه به Motif به شرح زیر هستند: .PP .Vb 7 \& 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). .Ve .SS "آرگومان‌های گزینه‌های تزئینات (DECOR OPTION ARGUMENTS)" .IX Subsection "DECOR OPTION ARGUMENTS" مشخص می‌کند کدام تزئینات ظاهری برای پنجره‌های با \fICLASS\fR\fB.\fR\fIINSTANCE\fR غیرفعال یا فعال (0/1) هستند. تمام گزینه‌های تزئینات دارای مقدار پیش‌فرض فعال (1) هستند مگر اینکه توسط برنامه لغو شوند. تزئینات شبیه به Motif به شرح زیر هستند: .PP .Vb 10 \& 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). .Ve .SS "آرگومان‌های گزینه‌های قابلیت‌ها (FEATURE OPTION ARGUMENTS)" .IX Subsection "FEATURE OPTION ARGUMENTS" مشخص می‌کند کدام قابلیت‌های پیشرفته برای پنجره‌های با \fICLASS\fR\fB.\fR\fIINSTANCE\fR فعال/غیرفعال (1/0) شوند. تمام قابلیت‌های پیشرفته دارای مقدار پیش‌فرض غیرفعال (0) هستند مگر اینکه توسط برنامه لغو شوند. قابلیت‌های پیشرفته عبارتند از: .PP .Vb 10 \& 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. .Ve .SH "مثال‌ها (EXAMPLES)" .IX Subsection "EXAMPLE" .Vb 2 \& # بارگذاری اولیه یک پردازش نامرئی پس‌زمینه از chromium \& # در فضای کاری چهارم که فقط در فهرست پنجره‌ها قابل مشاهده است: \& \& icewmhint Chromium\-browser startMinimized 1 \e \& Chromium\-browser workspace 3 \e \& Chromium\-browser ignorePagerPreview 1 \e \& Chromium\-browser ignorePositionHint 1 \e \& Chromium\-browser ignoreTaskBar 1 \e \& Chromium\-browser ignoreQuickSwitch 1 \e \& Chromium\-browser ignoreUrgentHint 1 \e \& Chromium\-browser noFocusOnAppRaise 1 \& chromium .Ve .SH "اشکالات (BUGS)" .IX Subsection "BUGS" لطفاً باگ‌ها را در گزارش دهید. .SH "نویسنده (AUTHOR)" .IX Subsection "AUTHOR" Brian Bidulock . .PP برای آگاهی از اعلامیه کامل حق نشر و مجوزهای رونوشت‌برداری، گزینه \fB\-\-copying\fR را ببینید. .SH "مجوز (LICENSE)" .IX Subsection "LICENSE" \&\fBIceWM\fR تحت مجوز GNU Library General Public License منتشر شده است. پرونده \fICOPYING\fR موجود در توزیع یا گزینه \fB\-\-copying\fR را برای نمایش مجوزها ببینید.