ICEWMHINT(1)                     User Commands                    ICEWMHINT(1)


نام (NAME)
       icewmhint - ارسال نشانه‌ها و ویژگی‌های پنجره به مدیر پنجره IceWM

خلاصه دستور (SYNOPSIS)
       icewmhint CLASS.INSTANCE OPTION VALUE ...

توضیحات (DESCRIPTION)
       icewmhint ابزاری برای ارسال نشانه‌ها و ویژگی‌های پنجره (hints) در IceWM
       به icewm(1) است.  icewm از این نشانه‌ها برای نخستین کلاینت X11 که
       متعاقباً اجرا می‌شود استفاده می‌کند. این تنظیمات بر نشانه‌های موجود در
       پرونده icewm-winoptions(1) اولویت دارند.

       هر نشانه یک سه‌تایی متشکل از class.instance، یک IceWM winoption و مقدار
       آن است. در هر بار اجرای icewmhint می‌توان چندین نشانه را مشخص کرد.

       نشانه‌ها از طریق ویژگی "_ICEWM_WINOPTHINT" روی پنجره ریشه (root window)
       منتقل می‌شوند. icewmhint نشانه‌ها را به این ویژگی اضافه می‌کند، در حالی که
       icewm پس از خواندن ویژگی، آن را حذف می‌کند.

گزینه‌ها (OPTIONS)
       icewmhint گزینه‌های زیر را می‌شناسد:

   گزینه‌های دستوری (COMMAND OPTIONS)
       در هر بار اجرا فقط می‌توان یک گزینه دستوری را مشخص کرد. اگر هیچ گزینه
       دستوری مشخص نشود، تجزیه و پردازش آرگومان‌ها انجام می‌شود.

       -h, --help
           نمایش خلاصه راهنمای استفاده در خروجی استاندارد (stdout) و خروج.

       -V, --version
           نمایش نسخه برنامه در خروجی استاندارد (stdout) و خروج.

       -C, --copying
           نمایش مجوزهای رونوشت‌برداری و حق نشر برنامه در خروجی استاندارد
           (stdout) و خروج.

   گزینه‌های عمومی (GENERAL OPTIONS)
       -d, --display=DISPLAY
           مشخص کردن DISPLAY در X11. در صورت عدم تعیین، مقدار پیش‌فرض $DISPLAY
           خواهد بود.

آرگومان‌ها (ARGUMENTS)
       سه آرگومان زیر برای هر نشانه الزامی هستند.

       CLASS.INSTANCE
           ویژگی WM_CLASS در استاندارد ICCCM 2.0 را بر حسب کلاس منبع و نام
           منبع که با نقطه (".") جدا شده‌اند مشخص می‌کند. به عنوان مثال:
           "XTerm.xterm". فقط کلاس منبع یا نام منبع بدون نقطه نیز قابل قبول
           است، مانند "XTerm" یا "xterm".

       OPTION
           گزینه (OPTION) مورد نظر برای اعمال تغییر را مشخص می‌کند.

       VALUE
           مقدار (VALUE) را برای گزینه تعیین می‌کند.

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

   آرگومان‌های گزینه‌های عمومی (GENERAL OPTION ARGUMENTS)
       icon NAME
           نام آیکون پنجره‌های مربوط به CLASS.INSTANCE را مشخص می‌کند. NAME باید
           نام آیکون باشد. icewm(1) از روش معمول خود برای یافتن آیکون استفاده
           خواهد کرد. مقدار پیش‌فرض، نام ارائه‌شده توسط نشانه‌های مدیر پنجره است.

       workspace WORKSPACE
           فضای کاری که پنجره CLASS.INSTANCE در ابتدا در آن قرار می‌گیرد را
           مشخص می‌کند. پیش‌فرض، فضای کاری جاری است. WORKSPACE باید شماره فضای
           کاری با شروع از 0 باشد.

       geometry GEOMETRY
           ابعاد و موقعیت هندسی اولیه را برای پنجره‌های CLASS.INSTANCE داده‌شده
           مشخص می‌کند. GEOMETRY باید مقداری قابل تجزیه توسط XParseGeometry(3)
           باشد. پیش‌فرض، ابعاد و موقعیت ارائه‌شده توسط نشانه‌های مدیر پنجره است.

       order NUMBER
           ترتیب مرتب‌سازی دکمه‌های نوار وظیفه و آیکون‌های سینی سیستم. مقدار
           پیش‌فرض صفر است. مقادیر مثبت بزرگ‌تر موقعیت را به سمت راست‌تر و مقادیر
           منفی کوچک‌تر موقعیت را به سمت چپ‌تر می‌برند. گزینه order بر پانل
           وظایف، پانل سینی و سینی سیستم اعمال می‌شود.

       opacity NUMBER
           اگر NUMBER مقداری بین 1 و 100 باشد، ویژگی _NET_WM_WINDOW_OPACITY را
           تنظیم می‌کند. NUMBER به عنوان درصد حداکثر مات بودن تفسیر می‌شود.

       layer {LAYER|NUMBER}
           این گزینه لایه مرتبط با CLASS.INSTANCE را مشخص می‌کند. مقدار پیش‌فرض
           لایه "Normal" است. VALUE می‌تواند شماره لایه یا نام نمادین آن باشد.
           نام‌های نمادین لایه‌ها عبارتند از:

               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's.
               Fullscreen (14)  When fullscreen and focused.
               AboveAll   (15)  Always above anything.

       tray {Ignore|Minimized|Exclusive|NUMBER}
           رفتار سینی سیستم را برای پنجره‌های با CLASS.INSTANCE مشخص می‌کند. این
           گزینه مختص icewm(1) بوده و ویژگی "_ICEWM_TRAY" مرتبط با پنجره را
           تنظیم می‌کند. پیش‌فرض "Ignore" است. VALUE می‌تواند شماره گزینه یا یک
           نام نمادین به صورت زیر باشد:

               Ignore     (0)  only in task list.
               Minimized  (1)  icon in tray, task list unminimized.
               Exclusive  (2)  only in tray, not in task list.

       frame label (default: none)
           تمام پنجره‌های دارای برچسب فریم یکسان، به صورت زبانه‌ها در یک فریم
           واحد قرار می‌گیرند.

   آرگومان‌های گزینه‌های عملکرد (FUNCTION OPTION ARGUMENTS)
       مشخص می‌کند کدام عملکردها برای پنجره‌های با CLASS.INSTANCE غیرفعال یا
       فعال (0/1) هستند. تمام عملکردها به صورت پیش‌فرض فعال (1) هستند مگر اینکه
       توسط برنامه لغو شوند. عملکردهای شبیه به Motif به شرح زیر هستند:

           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).

   آرگومان‌های گزینه‌های تزئینات (DECOR OPTION ARGUMENTS)
       مشخص می‌کند کدام تزئینات ظاهری برای پنجره‌های با CLASS.INSTANCE غیرفعال
       یا فعال (0/1) هستند. تمام گزینه‌های تزئینات دارای مقدار پیش‌فرض فعال (1)
       هستند مگر اینکه توسط برنامه لغو شوند. تزئینات شبیه به Motif به شرح زیر
       هستند:

           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).

   آرگومان‌های گزینه‌های قابلیت‌ها (FEATURE OPTION ARGUMENTS)
       مشخص می‌کند کدام قابلیت‌های پیشرفته برای پنجره‌های با CLASS.INSTANCE
       فعال/غیرفعال (1/0) شوند. تمام قابلیت‌های پیشرفته دارای مقدار پیش‌فرض
       غیرفعال (0) هستند مگر اینکه توسط برنامه لغو شوند. قابلیت‌های پیشرفته
       عبارتند از:

           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.

مثال‌ها (EXAMPLES)
           # بارگذاری اولیه یک پردازش نامرئی پس‌زمینه از chromium
           # در فضای کاری چهارم که فقط در فهرست پنجره‌ها قابل مشاهده است:

           icewmhint Chromium-browser startMinimized 1 \
                     Chromium-browser workspace 3 \
                     Chromium-browser ignorePagerPreview 1 \
                     Chromium-browser ignorePositionHint 1 \
                     Chromium-browser ignoreTaskBar 1 \
                     Chromium-browser ignoreQuickSwitch 1 \
                     Chromium-browser ignoreUrgentHint 1 \
                     Chromium-browser noFocusOnAppRaise 1
           chromium

اشکالات (BUGS)
       لطفاً باگ‌ها را در <https://github.com/ice-wm/icewm/issues> گزارش دهید.

نویسنده (AUTHOR)
       Brian Bidulock <mailto:bidulock@openss7.org>.

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

مجوز (LICENSE)
       IceWM تحت مجوز GNU Library General Public License منتشر شده است.
       پرونده COPYING موجود در توزیع یا گزینه --copying را برای نمایش مجوزها
       ببینید.

icewm 4.1.0                       2026-08-06                      ICEWMHINT(1)