'\" t
.\"     Title: FvwmIconMan
.\"    Author: [بخش "نویسنده (AUTHOR)" را ببینید]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-28
.\"    Manual: Fvwm Modules
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "FVWMICONMAN" "1" "2026-06-28" "\ \&" "Fvwm Modules"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
FvwmIconMan \- یک مدیر آیکون برای fvwm
.SH "خلاصه دستور (SYNOPSIS)"
.sp
برنامه FvwmIconMan توسط fvwm اجرا می‌شود، بنابراین هیچ فراخوانی مستقیمی از خط فرمان کار نخواهد کرد.
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه FvwmIconMan یک مدیر آیکون است که بر اساس مدیر آیکون TWM الگوبرداری شده است. کاربر می‌تواند چندین مدیر آیکون داشته باشد که هر کدام مجهز به فهرستی از انواع پنجره‌هایی هستند که مدیریت می‌کنند. به عنوان مثال، کاربر می‌تواند یک مدیر داشته باشد که فقط پنجره‌های emacs را فهرست می‌کند، و مدیر دیگری که سایر موارد را فهرست می‌نماید. شما همچنین می‌توانید مشخص کنید که هر مدیر آیکون از چه تفکیک‌پذیری (رزولوشن) استفاده کند؛ به عنوان مثال، یک مدیر آیکون ممکن است پنجره‌ها را در تمام میزکارها مدیریت کند، و دیگری فقط پنجره‌های موجود در میزکار، صفحه یا نمایشگر جاری را مدیریت نماید.
FvwmIconMan می‌تواند آیکون‌های کوچکی را که توسط fvwm برای پنجره‌های تحت مدیریت آن ارائه می‌شود نمایش دهد. مدیرها می‌توانند حداکثر تعداد ستون داشته باشند (و بنابراین به صورت عمودی رشد کنند)، حداکثر تعداد ردیف داشته باشند (و سپس به صورت افقی رشد کنند)، یا در اندازه‌ای ثابت باقی بمانند و اندازه دکمه‌های پنجره را برای جا شدن تنظیم کنند (مانند نوار وظیفه ویندوز ۹۵). همچنین هنگامی که پشتیبانی از افزونه X Shape در زمان کامپایل فعال شده باشد، پنجره‌های مدیر می‌توانند دارای شکل سفارشی (shaped) باشند.
.sp
شما می‌توانید مشخص کنید که با دریافت رویدادهای ماوس یا کلیدها، چه عملیاتی اجرا شوند. به عنوان مثال، می‌توانید دکمه اول ماوس را برای آیکون‌کردن پنجره انتخاب‌شده مقید کنید و برای کلیدهای جهت‌نما کلیدهای میانبری بسازید تا بدون نیاز به ماوس در پنجره مدیر پیمایش کنید.
.sp
برنامه FvwmIconMan را می‌توان طوری تنظیم کرد که نشان دهد کدام پنجره در حال حاضر فوکوس صفحه‌کلید را دارد، و با پیوند دادن رویداد select (به زیر مراجعه کنید) به تابع Focus در fvwm، می‌توانید رفتار مدیر آیکون TWM را شبیه‌سازی کنید.
.SH "راه‌اندازی (INITIALIZATION)"
.sp
در طول راه‌اندازی، FvwmIconMan فایل پیکربندی fvwm را برای یافتن گزینه‌هایی که در زیر شرح داده شده‌اند جستجو می‌کند. اکیداً توصیه می‌شود که FvwmIconMan را به عنوان یک پنجره چسبان (sticky) تنظیم کنید. و اگر می‌خواهید از گزینه followfocus استفاده کنید، و/یا عملیاتی را به Focus پیوند دهید، باید FvwmIconMan را در حالت clicktofocus قرار دهید. همچنین هنگام استفاده از گزینه Shape، توصیه می‌شود که پنجره FvwmIconMan اصلاً توسط fvwm تزیین (decorate) نشود.
.SH "نحوه فراخوانی (INVOCATION)"
.sp
برنامه FvwmIconMan را می‌توان با درج خط \*(AqModule FvwmIconMan\*(Aq در فایل .fvwm2rc فراخوانی کرد. اگر قرار است FvwmIconMan در طول مقداردهی اولیه fvwm اجرا شود، این خط باید در بخش تعاریف StartFunction قرار گیرد، یا می‌توان آن را به یک منو، دکمه ماوس یا فشردن کلید پیوند داد تا بعداً فراخوانی شود.
.sp
اگر مایلید FvwmIconMan را در حالت گذرا (transient) اجرا کنید، مانند فهرست پنجره داخلی، آرگومان "\-Transient" را ارسال کنید. فراخوانی "Module FvwmIconMan \-Transient" برای این کار مناسب است. در این حالت، FvwmIconMan یک پنجره مدیر را مستقیماً زیر مکان‌نما باز می‌کند. هنگامی که دکمه ماوس رها می‌شود، عملیات مناسب را اجرا کرده و سپس خارج می‌شود. ماجرا از این جهت کمی پیچیده است که می‌توانید تعیین کنید FvwmIconMan چندین پنجره مدیر ایجاد کند، رفتاری که در اجرای گذرا نامناسب است. بنابراین هنگام اجرای گذرا، FvwmIconMan فقط یک پنجره مدیر ایجاد می‌کند. از شناسه مدیر \*(Aqtransient\*(Aq برای تعیین گزینه‌های این پنجره مدیر استفاده کنید.
.sp
برنامه FvwmIconMan می‌تواند یک نام مستعار (alias) را به عنوان آرگومان بپذیرد. به عنوان مثال، "Module FvwmIconMan FvwmIconMan\-Variant2".
.SH "جدول راهنمای گزینه‌های پیکربندی (CONFIGURATION OPTIONS REFERENCE CHART)"
.sp
برنامه FvwmIconMan گزینه‌های متعددی دارد. از آنجا که پیمایش در یک صفحه راهنمای طولانی خوشایند نیست، در اینجا یک جدول راهنمای خلاصه از گزینه‌های موجود آورده شده است. این گزینه‌ها در بخش بعدی با جزئیات بیشتر شرح داده شده‌اند.
.TS
allbox tab(:);
ltB ltB ltB.
T{
.sp
نام
T}:T{
.sp
توضیحات
T}:T{
.sp
پیش‌فرض
T}
.T&
lt lt lt.
T{
.sp
NumManagers
T}:T{
.sp
تعداد مدیرها
T}:T{
.sp
1
T}
T{
.sp
Action
T}:T{
.sp
اتصال دستور به رویداد
T}:T{
.sp
Mouse 0 N sendcommand Iconify
T}
T{
.sp
Background
T}:T{
.sp
پس‌زمینه پیش‌فرض
T}:T{
.sp
gray
T}
T{
.sp
ButtonGeometry
T}:T{
.sp
اندازه دکمه به پیکسل
T}:T{
.sp

T}
T{
.sp
Colorset
T}:T{
.sp
مجموعه رنگ پیش‌فرض
T}:T{
.sp

T}
T{
.sp
DontShow
T}:T{
.sp
فهرست پنجره‌ها برای نادیده‌گرفتن
T}:T{
.sp

T}
T{
.sp
DrawIcons
T}:T{
.sp
استفاده از آیکون‌های کوچک
T}:T{
.sp
false
T}
T{
.sp
FocusAndSelectButton
T}:T{
.sp

T}:T{
.sp
flat grey black
T}
T{
.sp
FocusAndSelectColorset
T}:T{
.sp

T}:T{
.sp

T}
T{
.sp
FocusButton
T}:T{
.sp
سبک دکمه‌های دارای فوکوس
T}:T{
.sp
up grey black
T}
T{
.sp
FocusColorset
T}:T{
.sp

T}:T{
.sp

T}
T{
.sp
FollowFocus
T}:T{
.sp
نمایش پنجره دارای فوکوس
T}:T{
.sp
false
T}
T{
.sp
Font
T}:T{
.sp

T}:T{
.sp
8x13
T}
T{
.sp
Foreground
T}:T{
.sp
رنگ متن پیش‌فرض
T}:T{
.sp
white
T}
T{
.sp
Format
T}:T{
.sp
توصیف برچسب دکمه
T}:T{
.sp
"%c: %i"
T}
T{
.sp
IconName
T}:T{
.sp
نام آیکون مدیر
T}:T{
.sp
FvwmIconMan
T}
T{
.sp
IconAndSelectButton
T}:T{
.sp

T}:T{
.sp
up black grey
T}
T{
.sp
IconAndSelectColorset
T}:T{
.sp

T}:T{
.sp

T}
T{
.sp
IconButton
T}:T{
.sp
سبک دکمه‌های آیکون
T}:T{
.sp
up black grey
T}
T{
.sp
IconColorset
T}:T{
.sp

T}:T{
.sp

T}
T{
.sp
ManagerGeometry
T}:T{
.sp
اندازه مدیر بر حسب دکمه
T}:T{
.sp
0x1
T}
T{
.sp
MaxButtonWidth
T}:T{
.sp
حداکثر عرض یک دکمه
T}:T{
.sp

T}
T{
.sp
MaxButtonWidthByColumns
T}:T{
.sp

T}:T{
.sp

T}
T{
.sp
NoIconAction
T}:T{
.sp
پویانمایی آیکون‌سازی
T}:T{
.sp
NOP
T}
T{
.sp
PlainButton
T}:T{
.sp
سبک دکمه‌های معمولی
T}:T{
.sp
up black grey
T}
T{
.sp
PlainColorset
T}:T{
.sp

T}:T{
.sp

T}
T{
.sp
ReliefThickness
T}:T{
.sp
ضخامت برجستگی دکمه
T}:T{
.sp
2
T}
T{
.sp
Resolution
T}:T{
.sp
فیلترهای پنجره
T}:T{
.sp
desk page
T}
T{
.sp
Reverse
T}:T{
.sp
حالت normal، icon یا none
T}:T{
.sp
none
T}
T{
.sp
SelectButton
T}:T{
.sp
سبک دکمه‌های انتخاب‌شده
T}:T{
.sp
flat black grey
T}
T{
.sp
SelectColorset
T}:T{
.sp

T}:T{
.sp

T}
T{
.sp
Shape
T}:T{
.sp
استفاده از افزونه shape
T}:T{
.sp
false
T}
T{
.sp
Show
T}:T{
.sp
فهرست پنجره‌ها برای نمایش
T}:T{
.sp

T}
T{
.sp
ShowOnlyIcons
T}:T{
.sp
فقط آیکون‌ها مرئی باشند
T}:T{
.sp
false
T}
T{
.sp
ShowNoIcons
T}:T{
.sp
آیکون‌ها نمایش داده نشوند
T}:T{
.sp
false
T}
T{
.sp
ShowTransient
T}:T{
.sp
پنجره‌های گذرا مرئی باشند
T}:T{
.sp
false
T}
T{
.sp
ShowOnlyFocused
T}:T{
.sp
فقط پنجره دارای فوکوس مرئی باشد
T}:T{
.sp
false
T}
T{
.sp
Sort
T}:T{
.sp
مرتب نگه‌داشتن مدیرها
T}:T{
.sp
name
T}
T{
.sp
SortWeight
T}:T{
.sp
وزن برای مرتب‌سازی
T}:T{
.sp

T}
T{
.sp
Tips
T}:T{
.sp
حالت نکات راهنما
T}:T{
.sp
none
T}
T{
.sp
TipsDelays
T}:T{
.sp
تأخیرهای نگاشت نکات راهنما
T}:T{
.sp
1000 300
T}
T{
.sp
TipsFont
T}:T{
.sp
فونت نکات راهنما
T}:T{
.sp
default fvwm font
T}
T{
.sp
TipsColorset
T}:T{
.sp
مجموعه رنگ نکات راهنما
T}:T{
.sp
0
T}
T{
.sp
TipsFormat
T}:T{
.sp
توصیف برچسب نکات راهنما
T}:T{
.sp
مقدار Format
T}
T{
.sp
TipsBorderWidth
T}:T{
.sp
اندازه حاشیه نکات راهنما
T}:T{
.sp
1
T}
T{
.sp
TipsPlacement
T}:T{
.sp
جای‌گیری نکته راهنما نسبت به دکمه
T}:T{
.sp
updown
T}
T{
.sp
TipsJustification
T}:T{
.sp
تراز نکته راهنما نسبت به دکمه
T}:T{
.sp
leftup
T}
T{
.sp
TipsOffsets
T}:T{
.sp
آفست‌های جای‌گیری نکات راهنما
T}:T{
.sp
3 2
T}
T{
.sp
Title
T}:T{
.sp
عنوان مدیر
T}:T{
.sp
FvwmIconMan
T}
T{
.sp
TitleButton
T}:T{
.sp
سبک دکمه عنوان
T}:T{
.sp
raisededge black grey
T}
T{
.sp
TitleColorset
T}:T{
.sp

T}:T{
.sp

T}
T{
.sp
UseWinList
T}:T{
.sp
رعایت WinListSkip؟
T}:T{
.sp
true
T}
.TE
.sp
.SH "گزینه‌های پیکربندی (CONFIGURATION OPTIONS)"
.sp
به استثنای گزینه nummanagers، تمام گزینه‌ها را می‌توان بر اساس هر مدیر به صورت جداگانه تعریف کرد. بنابراین برای مثال، کاربر می‌تواند مدیر emacs خود را با رنگ متن قرمز و مدیر xterm خود را با رنگ آبی داشته باشد. یک خط پیکربندی می‌تواند یکی از دو فرم زیر را داشته باشد:
.sp
*FvwmIconMan: OptionName OptionValue
.RS 4
برای مشخص کردن اینکه \fIOptionName\fP مقدار \fIOptionValue\fP را برای همه مدیرها می‌گیرد.
.RE
.sp
*FvwmIconMan: ManagerId OptionName OptionValue
.RS 4
برای مشخص کردن اینکه گزینه \fIOptionName\fP مقدار \fIOptionValue\fP را برای مدیر \fIManagerId\fP می‌گیرد. مقدار \fIManagerId\fP می‌تواند یک عدد صحیح مثبت یا رشته "transient" باشد. یک شناسه عددی به مدیرهایی اشاره دارد که FvwmIconMan در حالت عادی ایجاد می‌کند، و شناسه "transient" به تک مدیری اشاره دارد که FvwmIconMan هنگام اجرای گذرا ایجاد می‌کند.
.RE
.sp
نحو قدیمی که به جای فاصله قبل از \fIManagerId\fP و \fIOptionName\fP از ستاره استفاده می‌کرد نیز پشتیبانی می‌شود، اما اکنون منسوخ شده است.
.sp
گزینه‌های زیر را می‌توان مشخص کرد:
.sp
*FvwmIconMan: NumManagers num
.RS 4
مقدار \fInum\fP یک عدد صحیح مثبت است که تعداد کل مدیرهای آیکون را مشخص می‌کند. از آنجا که FvwmIconMan قبل از مدیریت گزینه‌های خاص هر مدیر باید بداند چه تعداد مدیر وجود دارد، این گزینه باید اول بیاید. مقدار پیش‌فرض 1 است.
.RE
.sp
*FvwmIconMan: [id] Action type binding
.RS 4
یک دستور FvwmIconMan را به یک رویداد پیوند می‌دهد. مقدار \fIType\fP می‌تواند یکی از مقادیر Key، Mouse یا Select باشد. عملیات‌ها در بخش بعدی ACTIONS شرح داده شده‌اند.
.RE
.sp
*FvwmIconMan: [id] Background background
.RS 4
رنگ پس‌زمینه پیش‌فرض را تعیین می‌کند.
.RE
.sp
*FvwmIconMan: [id] ButtonGeometry geometry
.RS 4
هندسه اولیه یک دکمه منفرد را به پیکسل مشخص می‌کند. اگر ارتفاع مشخص‌شده 0 باشد، ارتفاع دکمه از اندازه قلم تعیین می‌شود. مختصات X و Y نادیده گرفته می‌شوند.
.RE
.sp
*FvwmIconMan: [id] Colorset colorset
.RS 4
مجموعه رنگ پیش‌فرض مورد استفاده را تعیین می‌کند. بر پس‌زمینه و پیش‌زمینه اولویت دارد.
.RE
.sp
*FvwmIconMan: [id] DrawIcons value
.RS 4
این گزینه رفتار فضای قرار داده شده قبل از هر برچسب دکمه را تنظیم می‌کند. مقدار پیش‌فرض "false" است که به این معنی است که قبل از هر برچسب یک فضای خالی وجود دارد که در آن یک دکمه برجسته در کنار تمام پنجره‌های آیکون‌شده کشیده می‌شود، به شرطی که \*(AqReliefThickness\*(Aq صفر نباشد. اگر روی "true" تنظیم شود، یک آیکون کوچک به جای دکمه برجسته در کنار تمام پنجره‌های آیکون‌شده کشیده می‌شود. اگر روی "always" تنظیم شود، یک آیکون کوچک برای تمام پنجره‌ها کشیده می‌شود. توجه داشته باشید پنجره‌های آیکون‌شده بدون آیکون کوچک همچنان یک دکمه برجسته را نشان می‌دهند مگر اینکه \*(AqReliefThickness\*(Aq صفر باشد. در نهایت، اگر این مقدار "none" باشد، فضای قبل از برچسب کاملاً حذف می‌شود و هیچ آیکون کوچک یا دکمه برجسته‌ای نشان داده نمی‌شود.
.RE
.sp
*FvwmIconMan: [id] FocusAndSelectButton style [forecolor backcolor]
.RS 4
مشابه گزینه plainbutton است، اما ظاهر دکمه‌هایی را مشخص می‌کند که هم انتخاب شده‌اند و هم فوکوس صفحه‌کلید را دارند.
.RE
.sp
*FvwmIconMan: [id] FocusAndSelectColorset colorset
.RS 4
مانند focusandselectbutton کار می‌کند اما در عوض از مجموعه‌های رنگ استفاده می‌نماید. تنظیم style همچنان فقط می‌تواند با focusandselectbutton اعمال شود.
.RE
.sp
*FvwmIconMan: [id] FocusButton style [forecolor backcolor]
.RS 4
مشابه گزینه plainbutton است، اما ظاهر دکمه‌هایی را مشخص می‌کند که پنجره‌های آن‌ها دارای فوکوس صفحه‌کلید هستند.
.RE
.sp
*FvwmIconMan: [id] FocusColorset colorset
.RS 4
مانند focusbutton کار می‌کند اما در عوض از مجموعه‌های رنگ استفاده می‌نماید. تنظیم style همچنان فقط می‌تواند با focusbutton اعمال شود.
.RE
.sp
*FvwmIconMan: [id] FollowFocus boolean
.RS 4
اگر \fItrue\fP باشد، ظاهر دکمه منعکس می‌کند که کدام پنجره در حال حاضر فوکوس دارد. مقدار پیش‌فرض false است.
.RE
.sp
*FvwmIconMan: [id] Font font
.RS 4
قلم مورد استفاده برای برچسب‌گذاری دکمه‌ها را مشخص می‌کند. پیش‌فرض 8x13 است.
.RE
.sp
*FvwmIconMan: [id] Foreground foreground
.RS 4
رنگ متن پیش‌فرض را تعیین می‌کند.
.RE
.sp
*FvwmIconMan: [id] Format formatstring
.RS 4
یک رشته فرمت شبیه به printf که رشته‌ای را که قرار است در پنجره مدیر برای هر پنجره مدیریت‌شده چاپ شود توصیف می‌کند. فلگ‌های مجاز عبارتند از: %t، %i، %c، %r و %s به ترتیب برای عنوان پنجره، عنوان آیکون، کلاس، نام منبع یا نمایشگر. پیش‌فرض "%c: %i" است.
.RE
.sp
*FvwmIconMan: [id] IconName iconstring
.RS 4
نام آیکون پنجره را برای آن پنجره مدیر مشخص می‌کند. مقدار \fIIconstring\fP می‌تواند یک کلمه یا یک رشته درون گیومه باشد. پیش‌فرض "FvwmIconMan" است.
.RE
.sp
*FvwmIconMan: [id] IconAndSelectButton style [forecolor backcolor]
.RS 4
مشابه گزینه plainbutton است، اما ظاهر دکمه‌هایی را مشخص می‌کند که پنجره‌های آنها آیکون شده و دکمه انتخاب شده است.
.RE
.sp
*FvwmIconMan: [id] IconButton style [forecolor backcolor]
.RS 4
مشابه گزینه plainbutton است، اما ظاهر دکمه‌هایی را مشخص می‌کند که پنجره‌های آنها آیکون شده‌اند.
.RE
.sp
*FvwmIconMan: [id] IconAndSelectColorset colorset
.RS 4
مانند IconAndSelectButton کار می‌کند اما در عوض از مجموعه‌های رنگ استفاده می‌نماید. تنظیم style همچنان فقط می‌تواند با iconbutton اعمال شود.
.RE
.sp
*FvwmIconMan: [id] IconColorset colorset
.RS 4
مانند iconbutton کار می‌کند اما در عوض از مجموعه‌های رنگ استفاده می‌نماید. تنظیم style همچنان فقط می‌تواند با iconbutton اعمال شود.
.RE
.sp
*FvwmIconMan: [id] ManagerGeometry geometry
.RS 4
هندسه اولیه مدیر را بر حسب واحد دکمه مشخص می‌کند. اگر \fIheight\fP صفر باشد، مدیر از \fIwidth\fP ستون استفاده می‌کند و هنگامی که بیش از \fIwidth\fP پنجره داشته باشد به صورت عمودی رشد خواهد کرد. به همین ترتیب، اگر \fIwidth\fP صفر باشد، از \fIheight\fP ردیف استفاده می‌کند و به صورت افقی رشد می‌نماید. اگر هر دو غیر صفر باشند، پنجره مدیر دقیقاً همان اندازه خواهد بود و همان‌طور باقی می‌ماند. با ایجاد ستون‌ها، دکمه‌ها باریک‌تر می‌شوند تا جا شوند. اگر هندسه با یک مختصات منفی y مشخص شود، مدیر پنجره به سمت بالا رشد می‌کند. در غیر این صورت، به سمت پایین رشد خواهد کرد.
.RE
.sp
*FvwmIconMan: [id] MaxButtonWidth width
.RS 4
حداکثر عرض یک دکمه را (به پیکسل) تعریف می‌کند. به‌طور پیش‌فرض هیچ حداکثری وجود ندارد. مقدار 0 پیش‌فرض را بازنشانی می‌کند. حداکثر فقط با مدیری که رشد نمی‌کند استفاده می‌شود (گزینه ManagerGeometry عرض و ارتفاع غیر صفر مشخص می‌کند).
.RE
.sp
*FvwmIconMan: [id] MaxButtonWidthByColumns col
.RS 4
این روش دیگری برای تنظیم عرض دکمه است. مقدار col تعداد ستون‌های آیکون‌ها است. عرض دکمه با تقسیم عرض کل FvwmIconMan بر تعداد ستون‌ها تعیین می‌شود. به عنوان مثال اگر عرض مدیر FvwmIconMan برابر 1024 باشد و MaxButtonWidthByColumns برابر 4 باشد، MaxButtonWidth برابر 256 خواهد بود. این زمانی مفید است که هنگام پیکربندی عرض مدیر را نمی‌دانید، برای مثال برای یک FvwmIconMan بلعیده شده (swallowed).
.RE
.sp
*FvwmIconMan: [id] NoIconAction action
.RS 4
به FvwmIconMan می‌گوید زمانی که پنجره‌ای با سبک NoIcon آیکون یا از حالت آیکون خارج می‌شود، \fIaction\fP را انجام دهد. مختصات مربوطه به \fIaction\fP اضافه می‌شوند تا بتوان آیکون را به یک دکمه FvwmIconMan ردیابی کرد. یک نمونه عملیات عبارت است از "*FvwmIconMan: NoIconAction SendToModule FvwmAnimate animate". یک عملیات خالی یا پوچ این ویژگی را خاموش می‌کند.
.RE
.sp
*FvwmIconMan: [id] PlainButton style [forecolor backcolor]
.RS 4
مشخص می‌کند که دکمه‌های معمولی چگونه به نظر برسند. مقدار \fIstyle\fP می‌تواند یکی از \fIflat\fP، \fIup\fP، \fIdown\fP، \fIraisededge\fP یا \fIsunkedge\fP باشد و نحوه کشیده شدن دکمه را توصیف می‌کند. گزینه‌های رنگ هر دو اختیاری هستند و اگر تنظیم نشوند، از رنگ‌های پیش‌فرض استفاده می‌شود. اگر روی صفحه تک‌رنگ باشد، گزینه \fIstyle\fP نادیده گرفته می‌شود، اما همچنان باید تنظیم شود.
.RE
.sp
*FvwmIconMan: [id] PlainColorset colorset
.RS 4
مانند plainbutton کار می‌کند اما به جای آن از مجموعه‌های رنگ استفاده می‌نماید. تنظیم style همچنان فقط می‌تواند با plainbutton اعمال شود.
.RE
.sp
*FvwmIconMan: [id] ReliefThickness num
.RS 4
مقدار \fInum\fP یک عدد صحیح است که ضخامت برجستگی در لبه دکمه‌های غیر تخت را بر حسب پیکسل مشخص می‌کند. تنظیم این مقدار روی 0 دکمه‌های تخت ایجاد می‌کند، گویی که مقادیر \fIFocusAndSelectButton\fP، \fIFocusButton\fP، \fIIconAndSelectButton\fP، \fIIconButton\fP، \fIPlainButton\fP، \fISelectButton\fP و \fITitleButton\fP همگی روی \fIflat\fP تنظیم شده باشند. اگر \fInum\fP منفی باشد، دکمه معکوس خواهد شد گویی که از \fIReverse\fP برای همه کلاس‌ها استفاده کرده‌اید.
.RE
.sp
*FvwmIconMan: [id] Resolution [\fIfilter(s)\fP]
.RS 4
فهرستی از \fIfilters\fP جدا شده با فاصله را مشخص می‌کند که پیکربندی می‌کنند کدام پنجره‌ها نمایش داده شوند. اگر هیچ فیلتری داده نشود، تمام پنجره‌های نوع مناسب نشان داده می‌شوند (به گزینه‌های show و dontshow در زیر مراجعه کنید). سپس هر \fIfilter\fP پنجره‌های نمایش‌داده‌شده را محدود می‌کند و می‌تواند یکی از مقادیر زیر را بگیرد: desk، page، screen، !desk، !page، !screen یا invert. مقدار \fIdesk\fP فقط پنجره‌های میزکار جاری را نشان می‌دهد، و \fIpage\fP فقط پنجره‌های صفحه جاری را نشان می‌دهد. مقادیر \fI!desk\fP و \fI!page\fP به ترتیب فقط پنجره‌هایی را نشان می‌دهند که در میزکار یا صفحه جاری نیستند. مقدار \fIinvert\fP فیلتر را معکوس کرده و پنجره‌هایی را که مطابقت نداشتند نمایش می‌دهد.
.sp
نکات: \fIpage\fP و \fIdesk\fP مستقل هستند. اگر تنها فیلتر \fIpage\fP باشد، پنجره‌های موجود در صفحه جاری را در تمام میزکارها خواهید دید. برای دیدن پنجره‌ها فقط در صفحه و میزکار جاری (پیش‌فرض) به هر دو فیلتر نیاز دارید: \*(Aqdesk page\*(Aq. شما فقط می‌توانید یکی از desk/!desk، page/!page یا screen/!screen را داشته باشید و آخرین موردی که صادر شده اولویت دارد. فیلتر invert کل فیلتر را معکوس می‌کند، بنابراین \*(Aqinvert desk page\*(Aq با \*(Aq!desk !page\*(Aq یکسان نیست. پنجره‌های چسبان (sticky) در همه صفحه‌ها و میزکارها قابل مشاهده هستند، بنابراین با تمام فیلترهای page و desk مطابقت دارند، اما با فیلتر معکوس مطابقت نخواهند داشت.
.sp
فیلترها می‌توانند پارامترهای اضافی برای بیان اینکه کدام میزکار، صفحه یا نمایشگر نشان داده شود (یا نشان داده نشود) دریافت کنند. فیلتر \fI[!]desk [n]\fP می‌تواند شماره میزکار را بگیرد که فقط پنجره‌های روی میزکار ذکر شده را نشان می‌دهد (یا نشان نمی‌دهد). فیلتر \fI[!]page [x] [y]\fP می‌تواند شماره‌های صفحه افقی \fIx\fP و عمودی \fIy\fP را بگیرد که فقط پنجره‌های روی صفحه ذکر شده را نشان می‌دهد (یا نشان نمی‌دهد).
.sp
فیلتر \fI[!]screen [S]\fP پنجره‌های روی مانیتور \fIS\fP را نشان می‌دهد (یا نشان نمی‌دهد)، که می‌تواند موارد زیر باشد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fINAME\fP: نام "NAME" مانیتور خاص RandR.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIc\fP: مانیتور جاری RandR (شامل مکان‌نما)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIp\fP: مانیتور اصلی RandR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIg\fP: مانیتور سراسری (global)
.RE
.sp
از آنجا که تمام پنجره‌ها روی مانیتور سراسری هستند، \fIscreen g\fP عملاً کاری انجام نمی‌دهد. مقدار \fIc\fP مانیتور جاری در زمان اعمال تفکیک‌پذیری است و پس از تنظیم تغییر نخواهد کرد. این فیلتر بهتر است با یک \fINAME\fP در RandR استفاده شود.
.sp
این خط پیکربندی زمانی که FvwmIconMan در حال اجرا است نیز رعایت می‌شود، و تفکیک‌پذیری با ارسال به fvwm به صورت پویا تغییر می‌کند.
.RE
.sp
*FvwmIconMan: [id] Reverse class
.RS 4
باعث می‌شود خطوط برجستگی کلاس‌های خاصی از دکمه‌ها معکوس شوند تا سبک‌های بالا و پایین معکوس گردند. این تاثیری روی دکمه‌های تخت ندارد. کلاس می‌تواند icon، normal یا none باشد. مقدار پیش‌فرض none است.
.RE
.sp
*FvwmIconMan: [id] SelectButton style [forecolor backcolor]
.RS 4
مشابه گزینه plainbutton است، اما ظاهر دکمه‌ها را زمانی که ماوس روی آنها قرار دارد مشخص می‌کند.
.RE
.sp
*FvwmIconMan: [id] SelectColorset colorset
.RS 4
مانند selectbutton کار می‌کند اما در عوض از مجموعه‌های رنگ استفاده می‌نماید. تنظیم style همچنان فقط می‌تواند با selectbutton اعمال شود.
.RE
.sp
*FvwmIconMan: [id] Shape boolean
.RS 4
اگر \fITrue\fP باشد، پنجره را به صورت شکل‌دار (shaped) می‌سازد. احتمالاً فقط در صورتی مفید است که چندین ستون یا ردیف داشته باشید. اگر FvwmIconMan برای پشتیبانی از افزونه Shape کامپایل نشده باشد، یک پیام خطا تولید می‌کند. هنگام استفاده از پنجره‌های شکل‌دار، توصیه می‌شود که یک سبک fvwm بدون حاشیه برای FvwmIconMan ایجاد شود. در غیر این صورت، fvwm دچار سردرگمی خواهد شد.
.RE
.sp
*FvwmIconMan: [id] Sort value
.RS 4
اگر \fIname\fP باشد، فهرست مدیر بر اساس نام مرتب می‌شود. اگر \fInamewithcase\fP باشد، بر اساس نام و حساس به حروف بزرگ و کوچک مرتب می‌شود. اگر \fIid\fP باشد، فهرست مدیر بر اساس شناسه پنجره مرتب می‌شود که پس از ایجاد پنجره هرگز تغییر نمی‌کند. اگر \fIweighted\fP باشد، فهرست مدیر بر اساس وزن مرتب می‌شود (به توضیحات \fIsortweight\fP در زیر مراجعه کنید). یا می‌توان آن را روی \fInone\fP تنظیم کرد که منجر به عدم مرتب‌سازی می‌شود. مقدار پیش‌فرض \fIname\fP است.
.RE
.sp
*FvwmIconMan: [id] SortWeight weight pattern\-list
.RS 4
مقدار \fIweight\fP مشخص‌شده را به پنجره‌هایی که با \fIpattern\-list\fP مطابقت دارند اختصاص می‌دهد. فهرست از الگوهایی به شکل \fItype=pattern\fP تشکیل شده است، که در آن type یکی از \fIclass\fP، \fIresource\fP، \fItitle\fP، \fIicon\fP یا \fIscreen\fP است و pattern عبارتی با همان فرمت استفاده شده در دستور style در fvwm است (تطبیق الگوی مینیمالیستی شل). می‌توان چندین وزن مرتب‌سازی تعیین کرد. هر پنجره با فهرست وزن‌های مرتب‌سازی به ترتیب مطابقت داده می‌شود و وزن اولین تطابق را دریافت می‌کند. پنجره‌های با وزن کمتر در ابتدای فهرست مدیر قرار می‌گیرند. برای مثال:
.sp
.if n .RS 4
.nf
.fam C
  *FvwmIconMan: Sort weighted
  *FvwmIconMan: SortWeight 1 class=XTerm title=special*
  *FvwmIconMan: SortWeight 10 class=XTerm
  *FvwmIconMan: SortWeight 5
.fam
.fi
.if n .RE
.sp
در این مثال، پنجره‌های xterm که عنوان آنها با "special" شروع می‌شود (وزن 1) ابتدا فهرست می‌شوند، و پس از آن همه چیز به جز سایر xtermها (وزن 5)، و سایر xtermها (وزن 10) در آخر فهرست می‌شوند. اگر وزن پیش‌فرضی (فهرست الگوی خالی) داده نشود، وزن پیش‌فرض 0 است. این گزینه فقط در صورتی مرتبط است که نوع مرتب‌سازی روی \fIweighted\fP تنظیم شده باشد.
.RE
.sp
*FvwmIconMan: [id] Title title\-string
.RS 4
رشته عنوان پنجره را برای آن پنجره مدیر مشخص می‌کند. مقدار \fITitlestring\fP می‌تواند یک کلمه منفرد یا یک رشته درون گیومه باشد. مقدار پیش‌فرض "FvwmIconMan" است. این رشته در نوار عنوان پنجره مدیر (در صورت وجود) و در دکمه عنوان (دکمه‌ای که هنگام خالی بودن مدیر رسم می‌شود) کشیده خواهد شد.
.RE
.sp
*FvwmIconMan: [id] TitleButton style [forecolor backcolor]
.RS 4
مشابه گزینه plainbutton است، اما ظاهر دکمه عنوان (دکمه‌ای که هنگام خالی بودن مدیر رسم می‌شود) را مشخص می‌کند. عنوان مدیر در دکمه عنوان کشیده می‌شود.
.RE
.sp
*FvwmIconMan: [id] UseWinList boolean
.RS 4
اگر \fItrue\fP باشد، به فلگ سبک WinListSkip احترام می‌گذارد. در غیر این صورت، تمام پنجره‌ها بر اساس فهرست‌های show و dontshow مشمول مدیریت احتمالی هستند.
.sp
دو گزینه زیر کنترل می‌کنند که کدام پنجره‌ها توسط کدام مدیرها مدیریت شوند. یک مدیر می‌تواند دو فهرست دریافت کند: یکی از پنجره‌ها برای نمایش و دیگری از پنجره‌ها برای نادیده‌گرفتن. اگر فقط فهرست \fIshow\fP داده شود، آن مدیر فقط پنجره‌های موجود در فهرست را نشان می‌دهد. اگر فقط فهرست \fIDontShow\fP داده شود، مدیر همه پنجره‌ها را به جز پنجره‌های موجود در فهرست نشان می‌دهد. اگر هر دو فهرست داده شوند، پنجره‌ای نشان داده می‌شود که در فهرست \fIDontShow\fP نباشد و در فهرست \fIShow\fP باشد. و در نهایت، اگر هیچ‌کدام از فهرست‌ها داده نشود، مدیر تمام پنجره‌ها را مدیریت خواهد کرد. هر فهرست از الگوهایی به فرم \fItype=pattern\fP تشکیل شده است، که در آن type یکی از \fIclass\fP، \fIresource\fP، \fItitle\fP یا \fIicon\fP است و pattern عبارتی با همان فرمت مورد استفاده در دستور style در fvwm است (تطبیق الگوی مینیمالیستی شل). گیومه‌های اطراف الگو به عنوان بخشی از عبارت در نظر گرفته می‌شوند. اگر پنجره‌ای توسط بیش از یک مدیر قابل مدیریت باشد، مدیری با کمترین شناسه آن را دریافت می‌کند.
.RE
.sp
*FvwmIconMan: [id] Show pattern list
.RS 4
اگر پنجره‌ای با یکی از الگوهای موجود در فهرست مطابقت داشته باشد، می‌تواند توسط این مدیر مدیریت شود.
.RE
.sp
*FvwmIconMan: [id] DontShow pattern list
.RS 4
اگر پنجره‌ای با یکی از الگوهای موجود در فهرست مطابقت داشته باشد، ممکن است توسط این مدیر مدیریت نشود.
.RE
.sp
*FvwmIconMan: [id] ShowTransient boolean
.RS 4
پنجره‌های گذرا را در فهرست نشان می‌دهد (پیش‌فرض false).
.RE
.sp
*FvwmIconMan: [id] ShowOnlyIcons boolean
.RS 4
اگر \fIboolean\fP برابر true باشد، فقط پنجره‌های آیکون‌شده نشان داده می‌شوند.
.RE
.sp
*FvwmIconMan: [id] ShowNoIcons boolean
.RS 4
اگر \fIboolean\fP برابر true باشد، فقط پنجره‌هایی که آیکون نشده‌اند نشان داده می‌شوند.
.RE
.sp
*FvwmIconMan: [id] ShowOnlyFocused boolean
.RS 4
اگر \fIboolean\fP برابر true باشد، فقط پنجره دارای فوکوس نشان داده می‌شود.
.sp
گزینه‌های زیر نکات راهنما (tips) را کنترل می‌کنند.
.RE
.sp
*FvwmIconMan: [id] Tips value
.RS 4
که در آن \fIvalue\fP می‌تواند always، needed یا false باشد. پیش‌فرض false است و هیچ نکته راهنمایی نمایش داده نمی‌شود. با always، نکات راهنما فعال می‌شوند. با needed، نکته راهنما فقط در صورتی نمایش داده می‌شود که رشته دکمه کوتاه شده باشد یا رشته نکته راهنما با رشته دکمه برابر نباشد. این خط پیکربندی در زمان اجرای FvwmIconMan نیز رعایت می‌شود.
.RE
.sp
*FvwmIconMan: [id] TipsDelays delay [mappeddelay]
.RS 4
که در آن \fIdelay\fP و \fImappeddelay\fP مقادیر زمان وقفه بر حسب میلی‌ثانیه هستند. اگر \fImappeddelay\fP داده نشود، مقدار \fIdelay\fP فرض می‌شود. پیش‌فرض 1000 300 است. هنگامی که مکان‌نما روی یک دکمه است، FvwmIconMan به مدت \fIdelay\fP میلی‌ثانیه قبل از نمایش نکته راهنما صبر می‌کند. در صورتی که یک نکته راهنما از قبل نگاشت شده باشد و مکان‌نما به دکمه دیگری برود، FvwmIconMan به مدت \fImappeddelay\fP میلی‌ثانیه قبل از نمایش نکته راهنمای جدید صبر می‌کند.
.RE
.sp
*FvwmIconMan: [id] TipsFont fontname
.RS 4
قلم مورد استفاده برای نکات راهنما را مشخص می‌کند. پیش‌فرض قلم پیش‌فرض fvwm است.
.RE
.sp
*FvwmIconMan: [id] TipsColorset colorset
.RS 4
رنگ‌های پنجره نکات راهنما را مشخص می‌کند. پیش‌فرض مجموعه رنگ 0 است.
.RE
.sp
*FvwmIconMan: [id] TipsFormat formatstring
.RS 4
مشابه گزینه Format اما برای پنجره نکات راهنما است. پیش‌فرض رشته فرمت از گزینه Format است.
.RE
.sp
*FvwmIconMan: [id] TipsBorderWidth pixels
.RS 4
عرض حاشیه (به پیکسل) پنجره نکات راهنما را مشخص می‌کند. پیش‌فرض 1 است.
.RE
.sp
*FvwmIconMan: [id] TipsPlacement value
.RS 4
که در آن \fIvalue\fP می‌تواند up، down، right، left، updown یا leftright باشد. این مقدار موقعیت پنجره نکات راهنما را نسبت به دکمه آن مشخص می‌کند. پیش‌فرض updown است که در آن دکمه‌های نیمه بالایی صفحه نکات راهنما را زیر دکمه دریافت می‌کنند، در غیر این صورت نکات راهنما بالای دکمه هستند.
.RE
.sp
*FvwmIconMan: [id] TipsJustification value
.RS 4
که در آن \fIvalue\fP می‌تواند leftup، rightdown یا center باشد. تراز (جهت) پنجره نکات راهنما را نسبت به دکمه آن پس از قرارگیری پنجره نکات راهنما مشخص می‌کند. پیش‌فرض leftup است که به این معنی است که اگر نکته راهنما در بالا یا پایین دکمه قرار گیرد، لبه چپ نکته راهنما و دکمه تراز می‌شوند. اگر نکته راهنما در سمت چپ یا راست دکمه قرار گیرد، leftup لبه‌های بالا را تراز می‌کند. مقادیر rightdown و center مانند leftup اما در جهات مختلف کار می‌کنند. تراز توسط گزینه TipsOffset تنظیم می‌شود. گزینه بعدی را ببینید.
.RE
.sp
*FvwmIconMan: [id] TipsOffsets placementoffset justoffset
.RS 4
که در آن \fIplacementoffset\fP و \fIjustoffset\fP آفست‌هایی به پیکسل برای گزینه‌های پیکربندی TipsPlacement و TipsJustification هستند. پیش‌فرض 3 2 است.
.RE
.SH "عملیات‌ها (ACTIONS)"
.sp
عملیات‌ها دستوراتی هستند که می‌توان آنها را به یک رویداد از نوع: فشردن کلید، کلیک ماوس یا ورود ماوس به دکمه مدیر پنجره متصل کرد \- که با انواع عملیات \fIKey\fP، \fIMouse\fP و \fISelect\fP نشان داده می‌شوند.
.sp
به طور معمول، عملیات‌های متصل به کلیک ماوس زمانی اجرا می‌شوند که دکمه فشرده می‌شود. در حالت گذرا، عملیات زمانی اجرا می‌شود که دکمه رها می‌شود، زیرا فرض بر این است که FvwmIconMan به رویداد ماوس متصل شده است. یک نکته/هشدار: FvwmIconMan همچنان دکمه ماوس و کلیدهای تغییردهنده (modifier) را در این مورد ردیابی می‌کند، بنابراین اگر FvwmIconMan را به عنوان مثال به meta\-button3 متصل کنید، عاقلانه است که اطمینان حاصل کنید عملیاتی که می‌خواهید اجرا شود زمانی اجرا می‌شود که رویداد meta\-button3 رخ دهد (که رها کردن دکمه خواهد بود، با فرض اینکه انگشت خود را روی کلید meta نگه داشته‌اید).
.sp
نحو عملیات‌ها عبارت است از:
.sp
عملیات‌های کلید: Key Keysym Modifiers FunctionList
.RS 4
مقادیر \fIKeysym\fP و \fIModifiers\fP دقیقاً همانند دستور \fIKey\fP در fvwm هستند.
.RE
.sp
عملیات‌های ماوس: Mouse Button Modifiers FunctionList
.RS 4
مقادیر \fIButton\fP و \fIModifiers\fP دقیقاً همانند دستور \fIMouse\fP در fvwm هستند.
.RE
.sp
عملیات‌های انتخاب: Select FunctionList
.RS 4
یک \fIFunctionList\fP دنباله‌ای از دستورات است که با کاما از هم جدا شده‌اند. آنها به ترتیب از چپ به راست، در یک زمینه مشترک اجرا می‌شوند \- که در حال حاضر فقط حاوی اشاره‌گری به دکمه "جاری" است. اگر هنگام اجرای عملیات دکمه‌ای انتخاب شده باشد (معمولاً با قرار گرفتن مکان‌نمای ماوس روی آن)، دکمه جاری با آن دکمه مقداردهی اولیه می‌شود. در غیر این صورت، به هیچ چیز اشاره نمی‌کند.
.RE
.sp
بیشتر دستورات موجود سپس این دکمه "جاری" را تغییر می‌دهند، یا با جابجا کردن آن، یا تبدیل آن به دکمه انتخاب‌شده، یا ارسال دستورات به fvwm که روی پنجره نشان داده شده توسط آن دکمه عمل می‌کنند. توجه داشته باشید که اگرچه این دکمه جاری طوری مقداردهی اولیه می‌شود که دکمه انتخاب‌شده باشد، دکمه انتخاب‌شده به طور ضمنی آن را دنبال نمی‌کند. به این ترتیب، کاربر می‌تواند دستوراتی را به پنجره‌های مختلف ارسال کند، بدون اینکه دکمه انتخاب‌شده تغییر کند.
.sp
دستورات پنج نوع آرگومان می‌گیرند: \fIInteger\fP، \fIManager\fP، \fIWindow\fP، \fIButton\fP و \fIString\fP. مقدار \fIString\fP رشته‌ای است که دقیقاً مانند fvwm مشخص می‌شود \- یا در گیومه یا به صورت یک کلمه منفرد بدون گیومه. مجدداً، می‌توانید دنباله‌ای از دستورات را با فهرست کردن آنها با کاما به یک رویداد متصل کنید.
.sp
انواع \fIWindow\fP و \fIButton\fP در فایل .fvwm2rc کاملاً یکسان به نظر می‌رسند، اما به عنوان مشخص‌کننده پنجره تحت مدیریت یا دکمه FvwmIconMan نشان‌دهنده یک پنجره تفسیر می‌شوند. آنها می‌توانند یک عدد صحیح باشند (که به صورت modulo N تفسیر می‌شود که در آن N تعداد دکمه‌ها است \- بنابراین 0 اولین و N\-1 آخرین است)، یا یکی از رشته‌های: \fISelect\fP، \fIFocus\fP، \fIUp\fP، \fIDown\fP، \fIRight\fP، \fILeft\fP، \fINext\fP، \fIPrev\fP. مقادیر \fISelect\fP و \fIFocus\fP به دکمه یا پنجره جاری انتخاب‌شده یا دارای فوکوس اشاره دارند. مقادیر \fIUp\fP، \fIDown\fP، \fIRight\fP و \fILeft\fP به دکمه یا پنجره بالا، پایین، راست یا چپ دکمه جاری در پنجره مدیر اشاره دارند و امکان پیمایش در پنجره مدیر را فراهم می‌کنند. مقادیر \fINext\fP و \fIPrev\fP پنجره، دکمه یا مدیر بعد یا قبل از دکمه جاری را مشخص می‌کنند و امکان پیمایش در فهرست تک‌بعدی پنجره‌هایی را که در پنجره مدیر کشیده شده‌اند فراهم می‌سازند. اگر مدیر مرتب شده باشد، \fINext\fP و \fIPrev\fP در پنجره‌ها به ترتیب مرتب‌شده حرکت می‌کنند.
.sp
نوع \fIManager\fP می‌تواند یک عدد صحیح، \fINext\fP یا \fIPrev\fP باشد. معنی آن مشابه نوع \fIButton\fP است، اما بر حسب شاخص عددی مدیرها، محدود به مدیرهایی که خالی نیستند.
.sp
توابع زیر در حال حاضر تعریف شده‌اند:
.sp
bif Button Integer/String
.RS 4
یک دستور انشعاب نسبی. اگر \fIButton\fP مقدار \fISelect\fP یا \fIFocus\fP باشد، در صورتی که دکمه انتخاب‌شده یا دکمه دارای فوکوس وجود داشته باشد، انشعاب انجام می‌شود. اگر \fIButton\fP یک عدد صحیح باشد، در صورت غیر صفر بودن انشعاب می‌یابد. اگر یکی از \fIUp\fP، \fIDown\fP، \fIRight\fP، \fILeft\fP، \fINext\fP، \fIPrev\fP باشد، انشعاب زمانی انجام می‌شود که دکمه جاری بتواند در آن جهت حرکت کند. اگر انشعاب انجام شود، دستورات به تعداد \fIInteger\fP نادیده گرفته می‌شوند. انشعاب به عقب مجاز نیست.
.RE
.sp
bifn Button Integer/String
.RS 4
مکمل bif است. اگر \fIButton\fP بر اساس معیارهای ذکر شده برای bif نادرست (false) ارزیابی شود، انشعاب انجام می‌گیرد.
.RE
.sp
gotobutton Button
.RS 4
دکمه جاری را روی \fIButton\fP تنظیم می‌کند. اگر \fIButton\fP یک عدد صحیح باشد، دکمه جاری روی \fIButton\fP به پیمانه تعداد دکمه‌ها، در هر مدیری که شامل دکمه انتخاب‌شده باشد (در صورت وجود) تنظیم می‌شود.
.RE
.sp
gotomanager Manager
.RS 4
دکمه را روی دکمه 0 از \fIManager\fP تنظیم می‌کند. این فقط به یک مدیر مرئی و غیر خالی می‌رود. بنابراین یک آرگومان عددی به پیمانه تعداد چنین مدیرهایی محاسبه می‌شود.
.RE
.sp
jmp Integer/String
.RS 4
یک پرش نسبی به تعداد \fIInteger\fP دستورالعمل اجرا می‌کند. پرش به عقب مجاز نیست. پرش نسبت به دستورالعمل پس از jmp محاسبه می‌شود.
.RE
.sp
label String
.RS 4
برچسبی را ارائه می‌دهد که دستورالعمل‌های قبلی می‌توانند به آن بپرند. این برچسب برای دستورالعمل‌های پرش بعدی قابل مشاهده نخواهد بود، و همان برچسب می‌تواند چندین بار در همان فهرست دستورالعمل استفاده شود (اگرچه انجام این کار نامعقول است).
.RE
.sp
print String
.RS 4
مقدار \fIString\fP را در کنسول چاپ می‌کند. برای اشکال‌زدایی عملیات‌ها مفید است.
.RE
.sp
printdebug
.RS 4
عملیات‌های تعریف‌شده را در کنسول چاپ می‌کند. فقط باید توسط توسعه‌دهندگان استفاده شود. برای فعال کردن این دستور، متغیرهای CONFIG و FUNCTIONS را در modules/FvwmIconMan/debug.h روی \*(Aq1\*(Aq تنظیم کرده و این ماژول را مجدداً کامپایل کنید.
.RE
.sp
quit
.RS 4
از FvwmIconMan خارج می‌شود.
.RE
.sp
refresh
.RS 4
باعث می‌شود تمام پنجره‌های مدیر مجدداً خود را ترسیم کنند.
.RE
.sp
ret
.RS 4
اجرای کل عملیات را متوقف می‌کند.
.RE
.sp
searchback String
.RS 4
دکمه را روی دکمه قبل از دکمه جاری تنظیم می‌کند که رشته چاپ‌شده آن در پنجره مدیر با \fIString\fP مشخص‌شده (که می‌تواند حاوی نویسه‌های عمومی یا wildcard باشد) مطابقت دارد.
.RE
.sp
searchforward String
.RS 4
دکمه را روی دکمه بعد از دکمه جاری تنظیم می‌کند که رشته چاپ‌شده آن در پنجره مدیر با \fIString\fP مشخص‌شده (که می‌تواند حاوی نویسه‌های عمومی باشد) مطابقت دارد.
.RE
.sp
select
.RS 4
دکمه جاری را در صورت وجود انتخاب می‌کند. اگر عملیات انتخابی مشخص شده باشد، سپس اجرا خواهد شد. بنابراین، تنظیم دکمه انتخاب در عملیات select کار عاقلانه‌ای تلقی نمی‌شود.
.RE
.sp
sendcommand Command
.RS 4
دستور fvwm با نام \fICommand\fP را به پنجره نشان‌داده‌شده توسط دکمه جاری (در صورت وجود) ارسال می‌کند.
.RE
.sp
warp
.RS 4
مکان‌نما را به دکمه جاری در صورت وجود منتقل می‌کند (warp).
.RE
.sp
\fBمثال‌ها:\fP
.sp
.if n .RS 4
.nf
.fam C
gotobutton select, gotobutton Down, select
.fam
.fi
.if n .RE
.sp
دکمه زیر دکمه جاری انتخاب‌شده را انتخاب می‌کند. از آنجا که دکمه جاری از قبل با دکمه انتخاب‌شده مقداردهی اولیه شده است، می‌توان این را به "gotobutton Down, select" کوتاه کرد.
.sp
.if n .RS 4
.nf
.fam C
gotobutton Up, select
.fam
.fi
.if n .RE
.sp
دکمه بالای دکمه جاری انتخاب‌شده را انتخاب می‌کند.
.sp
.if n .RS 4
.nf
.fam C
gotobutton 0, select
.fam
.fi
.if n .RE
.sp
اولین دکمه مدیر جاری را انتخاب می‌کند. اگر مدیر جاری وجود نداشته باشد، که در صورت عدم انتخاب هیچ دکمه‌ای رخ می‌دهد، این دستور هیچ کاری انجام نمی‌دهد.
.sp
.if n .RS 4
.nf
.fam C
gotobutton \-1, select
.fam
.fi
.if n .RE
.sp
آخرین دکمه مدیر جاری را انتخاب می‌کند.
.sp
.if n .RS 4
.nf
.fam C
gotobutton focus, select
.fam
.fi
.if n .RE
.sp
دکمه مربوط به پنجره دارای فوکوس را انتخاب می‌کند.
.sp
.if n .RS 4
.nf
.fam C
gotobutton focus, Iconify
.fam
.fi
.if n .RE
.sp
دستور Iconify در fvwm را به پنجره دارای فوکوس ارسال می‌کند. توجه داشته باشید که این کار دکمه انتخاب‌شده را تغییر نمی‌دهد.
.sp
.if n .RS 4
.nf
.fam C
bif Next 3, gotobutton 0, select, ret, gotobutton Next, select
.fam
.fi
.if n .RE
.sp
اگر دکمه‌ای انتخاب شده باشد و آخرین دکمه باشد، به دکمه 0 می‌رود. اگر آخرین دکمه نباشد، به دکمه بعدی می‌رود. در غیر این صورت، هیچ کاری انجام نمی‌دهد. در اصل، این عملیات تمام دکمه‌های مدیر جاری را پیمایش چرخشی می‌کند.
.sp
.if n .RS 4
.nf
.fam C
bif select 7, bif focus 3, gotomanager 0, select, ret, gotobutton focus, \(rs
select, ret, gotobutton down, select
.fam
.fi
.if n .RE
.sp
این برای ارسال به FvwmIconMan با دستور SendToModule مناسب است. اگر دکمه انتخاب‌شده وجود داشته باشد، به پایین حرکت می‌کند. در غیر این صورت، اگر دکمه دارای فوکوس وجود داشته باشد، انتخاب می‌شود. در غیر این صورت، دکمه 0 از مدیر 0 انتخاب می‌گردد.
.sp
.if n .RS 4
.nf
.fam C
bif select Select, bif focus Focus, gotomanager 0, select, ret, label Focus, \(rs
gotobutton focus, select, ret, label Select, gotobutton down, select
.fam
.fi
.if n .RE
.sp
همانند مثال قبلی است، اما از دستورالعمل label استفاده می‌کند.
.sp
علاوه بر پیوند به کلیدها و ماوس، عملیات‌ها را می‌توان از طریق دستور SendToModule از fvwm به FvwmIconMan ارسال کرد. هنگام استفاده از SendToModule دستور را در گیومه قرار ندهید. همچنین به دلیل وجود اشکالی در نسخه فعلی fvwm، نام FvwmIconMan را نیز در گیومه قرار ندهید.
.SH "پیکربندی‌های نمونه (SAMPLE CONFIGURATIONS)"
.sp
این مثال اول ساده‌ترین فراخوانی FvwmIconMan است که فقط یک مدیر دارد و تمام پنجره‌ها را مدیریت می‌کند:
.sp
.if n .RS 4
.nf
.fam C
##############################################################
# Load any modules which should be started during
# fvwm initialization
ModulePath /usr/lib/X11/fvwm:/usr/bin/X11
Module FvwmIconMan

# Make FvwmIconMan title\-bar\-less, sticky, and give it an icon
Style "Fvwm*"\&      Icon toolbox.xpm,NoTitle,NoHandles,Sticky
Style "FvwmIconMan" HandleWidth 5, Handles, BorderWidth 5


##############################################################
##############################################################
#Definitions used by the modules

*FvwmIconMan: NumManagers\&        1
*FvwmIconMan: Resolution\&         global
*FvwmIconMan: Background\&         slategrey
*FvwmIconMan: Foreground\&         white
*FvwmIconMan: Font\&               7x13
*FvwmIconMan: ButtonGeometry\&     100x0
*FvwmIconMan: ManagerGeometry\&    1x0\-0+0
.fam
.fi
.if n .RE
.sp
این مثال نسخه خلاصه شده پیکربندی شخصی من است. این پیکربندی دارای دو مدیر است، یکی برای emacs و دیگری برای همه چیزهای دیگر، به استثنای مواردی که عنوان آیکون ندارند. فقط پنجره‌های موجود در صفحه جاری نمایش داده می‌شوند. استفاده از گزینه‌های \fIdrawicons\fP و \fIshape\fP نیازمند این است که fvwm و FvwmIconMan با گزینه‌های صحیح کامپایل شده باشند. توجه کنید که چگونه گزینه‌های geometry و show برای هر مدیر به طور جداگانه مشخص شده‌اند، و بقیه برای همه مشترک هستند:
.sp
.if n .RS 4
.nf
.fam C
Style "FvwmIconMan"\&  NoTitle, Sticky, WindowListSkip, BorderWidth 0
Style "FvwmIconMan"\&  HandleWidth 0


Key F8 A N SendToModule FvwmIconMan bif select Select, bif focus Focus, \(rs
  gotomanager 0, select, sendcommand WarpToWindow, ret, label Focus, \(rs
  gotobutton focus, select, sendcommand WarpToWindow, ret, label Select, \(rs
  gotobutton prev, select, sendcommand WarpToWindow
Key F9 A N SendToModule FvwmIconMan bif select Select, bif focus Focus, \(rs
  gotomanager 0, select, sendcommand WarpToWindow, ret, label Focus, \(rs
  gotobutton focus, select, sendcommand WarpToWindow, ret, label Select, \(rs
  gotobutton next, select, sendcommand WarpToWindow

*FvwmIconMan: NumManagers 2
*FvwmIconMan: Resolution\&  page
*FvwmIconMan: Background\&  steelblue
*FvwmIconMan: Foreground\&  white
*FvwmIconMan: Font\&        7x13
*FvwmIconMan: UseWinList\&  true
*FvwmIconMan: DrawIcons\&   true
*FvwmIconMan: Shape\&       true
*FvwmIconMan: FollowFocus true
*FvwmIconMan: Sort\&        name
*FvwmIconMan: PlainButton\&          up white steelblue
*FvwmIconMan: SelectButton\&         down white steelblue
*FvwmIconMan: FocusButton\&          up white brown
*FvwmIconMan: FocusAndSelectButton down white brown
*FvwmIconMan: TitleButton\&          raisededge white steelblue
*FvwmIconMan: NoIconAction\&         "SendToModule FvwmAnimate animate"

*FvwmIconMan: 1 Title\&           "Emacs windows"
*FvwmIconMan: 1 IconName\&        "FvwmIconMan: Emacs"
*FvwmIconMan: 1 Format\&          "%i"
*FvwmIconMan: 1 Show\&            resource=emacs resource=gemacs
*FvwmIconMan: 1 ManagerGeometry 1x0\-400+0
*FvwmIconMan: 1 ButtonGeometry\&  200x0

*FvwmIconMan: 2 Title\&           "All windows"
*FvwmIconMan: 2 IconName\&        "FvwmIconMan: all"
*FvwmIconMan: 2 Format\&          "%c: %i"
*FvwmIconMan: 2 DontShow\&        icon=Untitled
*FvwmIconMan: 2 ManagerGeometry 2x4\-0+0
*FvwmIconMan: 2 ButtonGeometry\&  200x0

*FvwmIconMan: transient Geometry 194x100
*FvwmIconMan: transient DontShow icon=Untitled
*FvwmIconMan: transient Action\&   Mouse 0 A sendcommand select select Iconify

*FvwmIconMan: Action\&        Mouse\&        1 N sendcommand Iconify
*FvwmIconMan: Action\&        Mouse\&        2 N sendcommand WarpToWindow
*FvwmIconMan: Action\&        Mouse\&        3 N sendcommand "Module FvwmIdent FvwmIdent"
*FvwmIconMan: Action\&        Key\&        Left\&  N gotobutton Left, select
*FvwmIconMan: Action\&        Key\&        Right N gotobutton Right, select
*FvwmIconMan: Action\&        Key\&        Up\&    N gotobutton Up, select
*FvwmIconMan: Action\&        Key\&        Down\&  N gotobutton Down, select
*FvwmIconMan: Action\&        Key\&        q\&     N quit
.fam
.fi
.if n .RE
.SH "کارهای ناتمام (UNFINISHED BUSINESS)"
.sp
یک باگ وجود دارد که من از آن مطلع هستم. یک راه‌حل اساسی و واقعی برای این مشکل مورد استقبال قرار خواهد گرفت. هنگامی که یک مدیر آیکون طوری تنظیم شده است که به سمت بالا یا چپ رشد کند، در برخی از سیستم‌ها ممکن است گهگاه سرگردان شود.
.sp
همچنین پنجره‌های بدون نام منبع را به آن روانی و خوبی که باید، مدیریت نمی‌کند.
.SH "نویسنده (AUTHOR)"
.sp
Brady Montz (\c
.MTO "bradym\(atcs.arizona.edu" "" ")."
.SH "تشکر و قدردانی (THANKS)"
.sp
با تشکر از:
David Berson \c
.MTO "berson\(atcs.pitt.edu" "" ","
Gren Klanderman \c
.MTO "greg\(atalphatech.com" "" ","
David Goldberg \c
.MTO "dsg\(atmitre.org" "" ","
Pete Forman \c
.MTO "gsez020\(atcompo.bedford.waii.com" "" ","
Neil Moore \c
.MTO "amethyst\(atmaxwell.ml.org" "" ","
Josh M. Osborne \c
.MTO "stripes\(atva.pubnix.com" "" ","
Adam Rice <\c
.MTO "wysiwyg\(atglympton.airtime.co.uk" "" ","
Chris Siebenmann \c
.MTO "cks\(athawkwind.utcs.toronto.edu" "" ","
Bjorn Victor \c
.MTO "victor\(atdelial.docs.uu.se" "" ","
به خاطر مشارکت در کد یا ایده‌های واقعاً عالی.