FvwmScript - آنلاین در ابر

برنامه:

نام

FvwmScript - ماژول برای ساخت رابط کاربری گرافیکی

خلاصه

FvwmScript باید توسط Fvwm ایجاد شود. از خط فرمان کار نخواهد کرد.

شرح

FvwmScript ماژولی است که به شما اجازه می دهد تا برنامه های گرافیکی زیادی مانند
لوازم جانبی دسکتاپ، پانل دکمه با منوهای بازشو، دیالوگ های مدال... در هنگام راه اندازی،
FvwmScript فایلی را که در خط فرمان مشخص شده است می خواند. این فایل حاوی
اسکریپت این اسکریپت در فایل پیکربندی Fvwm موجود نیست.

یک اسکریپت FvwmScript با استفاده از صفحه کلید کاملاً قابل کنترل است. (Shift)-Tab گردش می کند
در اطراف ویجت ها، Return یک کلیک ماوس را شبیه سازی می کند، فلش ها مکان نما را حرکت می دهند یا تغییر می دهند.
مقادیر ویجت و Escape برای Menu و PopupMenu "لغو" می شود.

فراخوانی

FvwmScript را می توان با درج خط "Module FvwmScript name_of_script" در
فایل fvwm2rc. فایل "name_of_script" می تواند با اسلش شروع شود، در این صورت، یک است
مسیر کاملا واجد شرایط، و فایل خوانده می شود. اگر "name_of_script" با a شروع نشود
اسلش، FvwmScript در چند مکان مختلف نگاه می کند. اگر .fvwm2rc شامل
خط فرمان «*FvwmScript: Path path_of_the_script_directory»، FvwmScript آن را امتحان خواهد کرد
فهرست راهنما. اگر کار نکرد، FvwmScript دایرکتوری پیکربندی سیستم را امتحان می کند و
دایرکتوری پیکربندی کاربر همانطور که تحت فرمان "Read" در fvwm man توضیح داده شده است
احتمال برد مراجعه کنید.

دستور شروع FvwmScript را می توان به تنهایی در یک خط قرار داد، اگر قرار باشد FvwmScript باشد.
در طول اولیه سازی fvwm ایجاد می شود، یا می توان آن را به منو یا دکمه ماوس یا
برای فراخوانی آن بعداً فشار دهید.

پیکربندی OPTIONS

دستورات زیر را می توان در فایل پیکربندی استفاده کرد (نگاه کنید به fvwm(1)، بخش MODULE
دستورات برای جزئیات). آنها فقط در صورتی استفاده می شوند که دستورات اسکریپت مربوطه نباشند
در فیلمنامه استفاده شده است.

*FvwmScript: DefaultFont فونت
فونت پیش فرض مورد استفاده را مشخص می کند. اگر با این دستور یا در مشخص نشده باشد
اسکریپت با دستور Font، فونت ثابت فرض می شود.

*FvwmScript: DefaultFore رنگ
رنگ پیش‌زمینه پیش‌فرض مورد استفاده را مشخص می‌کند. اگر با این مشخص نشده است
دستور یا در اسکریپت با دستور ForeColor از رنگ مشکی استفاده شده است.

*FvwmScript: DefaultBack رنگ
رنگ پس‌زمینه پیش‌فرض مورد استفاده را مشخص می‌کند. اگر با این مشخص نشده است
دستور یا در اسکریپت با دستور BackColor از grey85 استفاده شده است.

*FvwmScript: DefaultHilight رنگ
رنگ نور پیش فرض مورد استفاده را مشخص می کند. اگر با این دستور مشخص نشده باشد
یا در اسکریپت با دستور HilightColor از grey100 استفاده شده است.

*FvwmScript: DefaultShadow رنگ
رنگ سایه پیش فرض مورد استفاده را مشخص می کند. اگر با این دستور مشخص نشده باشد
یا در اسکریپت با دستور ShadowColor از grey55 استفاده شده است.

*FvwmScript: DefaultColorset رنگ بندی
به ماژول می گوید که از Colorset استفاده کند رنگ بندی به عنوان مجموعه رنگ پیش فرض رجوع به
صفحه مرد FvwmTheme برای جزئیات در مورد مجموعه رنگ ها.

آناتومی OF A اسکریپت

FvwmScript از یک زبان برنامه نویسی خاص استفاده می کند. یک فیلمنامه از پنج بخش تشکیل شده است.
عنوان شامل مشخصات کلی پنجره و ویژگی های پیش فرض برای همه است
ویجت ها بخش دوم شامل دستورالعمل هایی است که در هنگام راه اندازی اجرا می شوند
اسکریپت بخش سوم شامل وظایف دوره ای است که هر ثانیه اجرا می شوند. در
بخش چهارم شامل دستورالعمل هایی است که در هنگام خروج اجرا می شوند. و قسمت آخر شامل
توضیحات ویجت ها یک ویجت از یازده نوع آیتم تشکیل شده است: برچسب های متنی،
ورودی های متن تک خطی، دکمه های رادیویی، چک باکس، دکمه های فشاری، افقی و عمودی
اسکرول، مستطیل، منوهای بازشو، swallowexecs و مینی اسکرول میله ها.

هدینگ OF A اسکریپت

نحو به شرح زیر است:

WindowTitle رشته
این گزینه عنوان پنجره را تنظیم می کند.

اندازه Window عرض ارتفاع
این گزینه اندازه پنجره را تنظیم می کند. عرض و ارتفاع ارزش عددی هستند

موقعیت پنجره x y
این گزینه موقعیت پنجره را تنظیم می کند. x و y ارزش عددی هستند

رنگ جلو {رنگ}
این گزینه رنگ پیش زمینه پیش فرض را برای همه ویجت ها تنظیم می کند.

رنگ پس زمینه {رنگ}
این گزینه رنگ پس‌زمینه پیش‌فرض را برای همه ویجت‌ها تنظیم می‌کند.

هایلایت رنگ {رنگ}
این گزینه رنگ هایلایت پیش فرض را برای همه ویجت ها تنظیم می کند.

سایه رنگ {رنگ}
این گزینه رنگ سایه پیش فرض را برای همه ویجت ها تنظیم می کند.

مجموعه رنگ {n}
این گزینه مجموعه رنگ های پیش فرض را برای همه ویجت ها تنظیم می کند.

فونت {فونت}
این گزینه فونت پیش فرض را برای همه ویجت ها تنظیم می کند.

UseGettext [مسیر_محلی]
استفاده از مکانیسم gettext را که توسط WindowLocaleTitle استفاده می شود، فعال کنید.
دستورالعمل های LocaleTitle، ChangeLocaleTitle و تابع Gettext. اگر نه
آرگومان داده شده است، کاتالوگ محلی پیش فرض FvwmScript استفاده می شود. این کاتالوگ است
در فهرست محلی نصب fvwm و دامنه متنی FvwmScript است
(install_prefix/share/locale/*/LC_MESSAGES/FvwmScript.mo). می توانید این را بازنشانی کنید
کاتالوگ یا اضافه کردن برخی از کاتالوگ ها دقیقا به همان روش با LocalePath fvwm
دستور (به صفحه راهنمای fvwm مراجعه کنید). این دستورالعمل باید قبل از قرار داده شود
دستورالعمل WindowLocaleTitle.

WindowLocaleTitle رشته
این گزینه عنوان پنجره را تنظیم می کند، اما از کاتالوگ(های) محلی که با آن تعریف شده است استفاده کنید
از Gettext استفاده کنید.

اولیه سازی

این بخش حاوی دستورالعمل هایی است که در هنگام راه اندازی اجرا می شوند. مثلا:
آغاز
شروع
"Exec cat tada.voc > /dev/dsp" را انجام دهید
WarpPointer 1
$ToDo=Restart را تنظیم کنید
پایان
این دستورالعمل ها برای پخش صدا، انتقال نشانگر به ویجت 1 و به استفاده می شود
$ToDo را در هر راه اندازی به "Restart" مقداردهی کنید.

تناوبی وظایف

این قسمت از اسکریپت حاوی دستورالعمل هایی است که هر ثانیه اجرا می شوند. برای
مثال:
PeriodicTasks
شروع
اگر (RemainderOfDiv (GetTime) 10)==0 سپس
{Exec xcalc} را انجام دهید
پایان
این مثال نحوه راه اندازی xcalc را هر 10 ثانیه نشان می دهد.

L' ترک کنید FUNCTION

این قسمت از اسکریپت حاوی دستورالعمل هایی است که هنگام خروج از اسکریپت اجرا می شوند
(بعد از دستور Quit یا اگر پنجره را با Close، Delete یا Destroy ببندید
دستور fvwm). مثلا
QuitFunc
شروع
{Echo bye, bye} را انجام دهید
پایان
توجه داشته باشید که اگر از دستور KillModule fvwm برای بستن اسکریپت استفاده کرده اید، مقداری
دستورالعمل ها یا عملکردهایی که بر وجود یک پیوند ارتباطی بین
اسکریپت و fvwm اجرا نخواهند شد (مثلاً دستور Do). برای کشتن هموار a
اسکریپت با دستور fvwm را ببینید دستورات بخش.

صفحه اصلی OF A اسکریپت

بخش دوم اسکریپت شامل توضیحات هر ویجت در اسکریپت است.
هر توضیح ویجت دارای دو بخش است. بخش اول خصوصیات اولیه را توصیف می کند
بخش دوم شامل دستورالعمل هایی است که هنگام دریافت پیام توسط ویجت اجرا می شود.
همه ویجت ها می توانند پیام ارسال و دریافت کنند. همه پیام ها با یک شماره شناسایی می شوند. در
هنگامی که کاربر ویجت را اجرا می کند، پیام "UserAction" به یک ویجت ارسال می شود. نحو
برای قسمت اول این است:
شناسه ویجت # عددی بین 1 تا 999 شامل
نوع ملک مورد نظر
رشته را تایپ کنید
اندازه عرض ارتفاع
موقعیت xy
عنوان { رشته }
ارزش بین
MaxValue بین‌المللی
MinValue int
رشته قلم
ForeColor { color }
رنگ پشتی { رنگ }
هایلایت رنگ { رنگ }
ShadowColor { رنگ }
رنگ ست داخلی
پرچم‌ها را انتخاب کنید
گزینه flagsOpt به Flags یک لیست جدا شده از فاصله است که حاوی یک یا چند مورد است
کلید واژه ها پنهان, NoReliefString, NoFocus, ترک کرد / مرکز / درست. پنهان استفاده میشه برای
مشخص کنید که آیا ویجت هنگام راه اندازی مخفی باشد یا خیر. NoReliefString مشخص می کند که آیا رشته ها کشیده شده اند
با تسکین یا نه NoFocus مشخص می کند که آیا ویجت می تواند فوکوس صفحه کلید را دریافت کند یا خیر.
به طور پیش فرض همه ویجت ها فوکوس می کنند، به جز Rectangle، HDipstick و VDipstick که نمی توانند.
علاوه بر این، ویجت‌های NoFocus زمانی که در اطراف ویجت‌ها گردش می‌کنید حذف می‌شوند
میانبر (Shift-) Tab. ترک کرد / مرکز / درست موقعیت متن را مشخص می کند. اینها اعمال می شود
فقط به ItemDraw، List، Menu، PopupMenu و PushButton. پیش فرض است مرکز برای ItemDraw
و PushButton و ترک کرد برای سایر ویجت ها

LocaleTitle را می توان به جای عنوان استفاده کرد، برای استفاده از کاتالوگ (های) محلی تعریف شده با
از Gettext استفاده کنید.

موقعیت هر ویجت باید مشخص شود.

نحو قسمت دوم این است:
اصلی
پیام موردی از
SingleClic:
شروع
# لیست دستورالعمل هایی که خواهد بود
# هنگام دریافت ویجت اجرا می شود
# پیام "SingleClic". این پیام است
# تولید شده توسط کاربر.
پایان
1:
شروع
# لیست دستورالعمل هایی که خواهد بود
# هنگام دریافت ویجت اجرا می شود
#پیام 1
پایان
پایان

لیست OF ویجت ها

پانزده نوع ویجت وجود دارد.

چک باکس: نمایش کادر چک با یک رشته.

عنوان: عنوان چک باکس.

ارزش: اگر مقدار برابر با 1 باشد، کادر علامت زده می شود وگرنه اینطور نیست.

La اندازه دارایی نادیده گرفته می شود

HDipstick: نمایش یک عدد سنج افقی.
از این ویجت می توان برای نمایش میزان مصرف دیسک استفاده کرد.

ارزش: مقدار فعلی نشانگر را مشخص کنید.

MinValue: حداقل مقدار میله را مشخص کنید.

MaxValue: حداکثر مقدار میله را مشخص کنید.

حداقل اندازه 30x11 تحمیل شده است.

نوار HScroll: نمایش یک نوار اسکرول افقی.

ارزش: موقعیت انگشت شست.

MaxValue: حد بالایی مقدار

MinValue: حد پایین ارزش.

ویژگی ارتفاع نادیده گرفته می شود و حداقل عرض اعمال می شود. عرض باید باشد
حداقل محدوده به اضافه 37 اگر همه مقادیر قابل انتخاب باشند، به عنوان مثال یک دقیقه 0 و
max of 10 دارای محدوده 11 است و بنابراین باید حداقل عرض آن 48 باشد.

ItemDraw: نمایش یک نماد و/یا یک رشته.

عنوان: رشته برای نمایش.

شمایل: نماد برای نمایش

MaxValue: x مختصات مکان نما.

MinValue: y مختصات مکان نما.

اندازه به اندازه کافی بزرگ ساخته شده است که شامل عنوان و/یا نماد باشد.

فهرست: نمایش لیست
لیست به کاربر امکان می دهد بین گزینه های مختلف یکی را انتخاب کند.

ارزش: مشخص کنید کدام گزینه انتخاب شده است.

MinValue: اولین گزینه قابل مشاهده

عنوان: عنوان شامل گزینه های نمایش داده شده در لیست است. نحو به شرح زیر است:
{گزینه 1|گزینه 2|...|گزینه N}. تمام منوها در بالای پنجره نمایش داده می شوند.

حداقل ارتفاع سه آیتم تحمیل شده و عرض آن حداقل باشد
108.

فهرست: نمایش منویی که به کاربر امکان می دهد گزینه ای را انتخاب کند.
موارد از نوع Menu از چپ به راست در بالای پنجره چیده شده اند.
ویژگی های اندازه و موقعیت نادیده گرفته می شوند.

ارزش: مشخص کنید کدام گزینه انتخاب شده است.

عنوان: عنوان شامل گزینه های نمایش داده شده در منو است. نحو به شرح زیر است:
{گزینه 1|گزینه 2|...|گزینه N}.

مینی اسکرول: نمایش یک نوار پیمایش عمودی بسیار کوچک.

ارزش: موقعیت انگشت شست.

MaxValue: حد بالایی مقدار

MinValue: حد پایین ارزش.

اندازه روی 19x34 تنظیم شده است.

منوی پاپ آپ: نمایش یک منوی پاپ آپ.

ارزش: مشخص کنید چه گزینه ای انتخاب شده است.

عنوان: عنوان دارای نحو زیر است: {گزینه 1|گزینه 2|...|گزینه N}."گزینه
1|گزینه 2|...|گزینه N" منوی پاپ آپی است که با فشار دادن ماوس نمایش داده می شود
را فشار دهید.

ویژگی اندازه نادیده گرفته می شود.

دکمه را فشار دهید: نمایش دکمه فشاری با یک نماد و/یا یک رشته.

عنوان: این رشته دارای نحو زیر است {Title of the button|گزینه 1|گزینه
2|گزینه3|...|گزینه N}. "گزینه 1|گزینه 2|...|گزینه N" منوی پاپ آپی است که
با فشار دادن دکمه سمت راست نمایش داده می شود.

شمایل: نماد برای نمایش

دکمه به اندازه ای بزرگ ساخته شده است که با نماد و یا برچسب مناسب باشد.

دکمه رادیویی: نمایش دکمه رادیویی با یک رشته.

عنوان: عنوان دکمه رادیویی.

ارزش: اگر مقدار برابر با 1 باشد، کادر علامت زده می شود وگرنه اینطور نیست.

ویژگی اندازه نادیده گرفته می شود

مستطیل: نمایش یک مستطیل.
از این نوع ویجت می توان برای تزئین پنجره استفاده کرد.

SwallowExec
این نوع ویجت باعث می شود که FvwmScript یک فرآیند را ایجاد کند و اولین مورد را ضبط کند
پنجره ای که نام یا منبع آن برابر با عنوان است و آن را در اسکریپت نمایش دهید
پنجره.

عنوان: نام پنجره ای را که در اسکریپت گرفته شده و نمایش داده می شود را مشخص کنید
پنجره.

SwallowExec: خط فرمان را برای اجرا برای ایجاد فرآیند مشخص کنید. ماژول ها می توانند
نیز بلعیده شود.

ارزش: ظاهر حاشیه را مشخص کنید. مقدار ممکن: -1، 0، 1.

اندازه حداقل 30x30 ساخته شده است

متن: نمایش فیلد ورودی متن.
از فیلد ورودی متن می توان برای ویرایش یک رشته تک خطی استفاده کرد.

عنوان: محتوای فیلد متنی

ارزش: موقعیت نقطه درج.

MinValue: موقعیت انتهای انتخاب.

MaxValue: اولین کاراکتر قابل مشاهده عنوان

ویژگی height نادیده گرفته می شود، عرض حداقل 40 پیکسل گسترده تر ساخته شده است
نسبت به محتویات اولیه

VDipstick: یک میله عمودی را نمایش دهید.

ارزش: مقدار فعلی نشانگر را مشخص کنید.

MinValue: حداقل مقدار میله را مشخص کنید.

MaxValue: حداکثر مقدار میله را مشخص کنید.

اندازه حداقل 11x30 ساخته شده است.

VScrollBar: نمایش یک نوار پیمایش عمودی.

ارزش: موقعیت انگشت شست.

MaxValue: حد بالایی مقدار

MinValue: حد پایین ارزش.

ویژگی عرض نادیده گرفته می شود و حداقل ارتفاع اعمال می شود. ارتفاع باید
اگر قرار است همه مقادیر قابل انتخاب باشند، مثلاً یک دقیقه 37، حداقل محدوده به اضافه 0 باشد
و max of 10 دارای محدوده 11 است و بنابراین باید حداقل ارتفاع آن 48 باشد.

دستورالعمل ها

در اینجا شرح همه دستورالعمل ها آمده است.

HideWidget id : ویجت شماره گذاری شده را مخفی کنید id.

ShowWidget id: نشان دادن ویجت با شماره id.

ChangeValue idxnumx idxnumx
مقدار ویجت را شماره گذاری کنید idxnumx به idxnumx.

ChangeMaxValue idxnumx idxnumx
حداکثر مقدار ویجت را شماره گذاری کنید idxnumx به idxnumx.

ChangeMinValue idxnumx idxnumx
حداقل مقدار ویجت را شماره گذاری کنید idxnumx به idxnumx.

تغییر عنوان idxnumx idxnumx
عنوان ویجت را شماره گذاری کنید idxnumx به idxnumx.

ChangeWindowTitle رشته
عنوان پنجره را روی رشته.

ChangeWindowTitleFromArg numarg
عنوان پنجره را روی مقدار the قرار دهید numarg-ام آرگومان اسکریپت.

ChangeLocaleTitle idxnumx idxnumx
به عنوان ChangeTitle اما از کاتالوگ(های) محلی تعریف شده با UseGettext استفاده کنید.

تغییر آیکون idxnumx idxnumx
نماد ویجت را شماره گذاری کنید idxnumx به idxnumx.

تغییر ForeColor idxnumx {رنگ}
رنگ پیش زمینه ویجت را شماره گذاری کنید idxnumx به {رنگ}.

ChangeBackColor idxnumx {رنگ}
رنگ پس زمینه ویجت را شماره گذاری کنید idxnumx به {رنگ}.

ChangeColorSet idxnumx idxnumx
مجموعه رنگ های ویجت را شماره گذاری کنید idxnumx به idxnumx. تعیین ویجت 0 را تنظیم می کند
مجموعه رنگ پنجره اصلی

تغییر موقعیت idxnumx x y
ویجت شماره گذاری شده را جابه جا کنید idxnumx موقعیت (x,y).

تغییر اندازه idxnumx عرض ارتفاع
اندازه ویجت را شماره گذاری کنید idxnumx به (عرض,ارتفاع).

تغییر فونت idxnumx فونت جدید
فونت ویجت را شماره گذاری کنید idxnumx به فونت جدید.

WarpPointer id
نشانگر ماوس را در ویجت شماره گذاری شده بچرخانید id.

WriteToFile نام فایل {p1} {p2} و غیره
در فایل بنویسید نام فایل رشته ای که الحاق همه آرگومان ها است
p1, p2، و غیره

انجام دادن {فرمان قوس}
دستور fvwm را در داخل بلوک Do اجرا کنید. هر دستور fvwm همانطور که در
صفحه man fvwm2 قابل استفاده است. دستورات از این ماژول به fvwm main ارسال می شوند
برنامه برای پردازش طول فرمان و آرگومان ها نمی تواند از 988 تجاوز کند
کاراکتر باشد.

$ را تنظیم کنیدVAR={خ1} {p2} و غیره
همه آرگومان ها را به یک رشته متصل کنید و متغیر $ را تنظیم کنیدVAR به این رشته

Quit: از برنامه خارج شوید.

SendSignal idxnumx idxnumx
یک پیام با شماره ارسال کنید idxnumx به ویجت idxnumx.

SendToScript id_script {p11} {p2} و غیره
به اسکریپت مشخص شده توسط id_script پیام ارسال کنید. پیام این است
الحاق str1, str2 ...

کلید نام کلید تغییر id SIG p1 p2 و غیره
یک کلید صفحه کلید را به دستورالعمل متصل می کند

SendSignal id SIG

و "آخرین رشته" را به الحاق str1، str2 ... تنظیم می کند (رجوع کنید به
تابع LastString). در نام کلید و اصلاح کننده ها فیلدها مانند fvwm تعریف می شوند
دستور کلید.

ادله

اکثر دستورات از آرگومان استفاده می کنند. دو نوع آرگومان وجود دارد: اعداد و رشته ها. آ
آرگومان عددی مقداری بین -32000 و +32000 است. یک رشته همیشه است
با پرانتز احاطه شده است متغیرها همیشه با کاراکتر "$" شروع می شوند و می توانند هر دو را داشته باشند
اعداد و رشته ها

توابع

همه توابع از آرگومان استفاده می کنند. توابع می توانند هم رشته و هم عدد را برگردانند. نحو
است:
(تابع آرگومان 1 آرگومان 2 و غیره)
در اینجا لیست کامل آرگومان ها آمده است:

(GetTitle id)
عنوان ویجت را با شماره برگردانید id.

(GetValue id)
مقدار فعلی ویجت شماره گذاری شده را برگردانید id.

(GetMinValue id)
مقدار حداقل فعلی ویجت شماره گذاری شده را برگردانید id.

(GetMaxValue id)
حداکثر مقدار فعلی ویجت شماره گذاری شده را برگردانید id.

(GetFore id)
مقدار فعلی RGB پیش زمینه ویجت شماره گذاری شده را برگردانید id در قالب هگز
RRGGBB.

(برگرد id)
مقدار پس‌زمینه RGB فعلی ویجت را برگردانید id در قالب هگز
RRGGBB.

(GetHilight id)
مقدار بالای RGB فعلی ویجت شماره گذاری شده را برگردانید id در قالب هگز
RRGGBB.

(GetShadow id)
مقدار سایه RGB فعلی ویجت شماره گذاری شده را برگردانید id در قالب هگز
RRGGBB.

(GetOutput {خ} intxnumx intxnumx)
دستور را اجرا می کند خ، خروجی استاندارد را دریافت می کند و کلمه ای را که in است برمی گرداند
خط intxnumx و در موقعیت intxnumx. اگر intxnumx برابر است با -1، GetOutput برمی گرداند
خط کامل

(NumToHex INT)
مقدار هگزادسیمال را برگردانید INT.

(HexToNum {خ})
مقدار اعشاری را برگردانید خ, خ باید یک مقدار هگزادسیمال باشد.

(اضافه کردن intxnumx intxnumx)
نتیجه را برگردانید (intxnumx+intxnumx).

(چند intxnumx intxnumx)
نتیجه را برگردانید (intxnumx*intxnumx).

(بخش intxnumx intxnumx)
نتیجه را برگردانید (intxnumx/intxnumx).

(StrCopy {خ} intxnumx intxnumx)
رشته ای را که بین موقعیت int1 و int2 قرار دارد برگردانید. به عنوان مثال، (StrCopy
{Hello} 1 2) {He} را برمی‌گرداند

(LaunchScript {خ})
این تابع اسکریپت با نام str را راه اندازی می کند و یک شماره شناسایی برمی گرداند.
این شماره برای استفاده از توابع SendToScript و ReceiveFromScript ضروری است.
رشته str حاوی نام اسکریپت و برخی از آرگومان ها است.

(GetScriptArgument {INT})
این تابع اسکریپت آرگومان استفاده شده در تابع LaunchScript را برمی گرداند. اگر
int برابر با صفر است، GetScriptArgument نام اسکریپت را برمی گرداند.

(GetScriptFather)
این تابع شماره شناسایی پدر اسکریپت را برمی گرداند.

(ReceivFromScript {INT})
این تابع پیام ارسال شده توسط اسکریپت با شماره int را برمی گرداند.

(RemainderOfDiv {intxnumx intxnumx}): t
این تابع باقیمانده تقسیم (intxnumx/intxnumx).

(GetTime)
این تابع زمان را بر حسب ثانیه برمی گرداند.

(GetPid)
این تابع شناسه فرآیند اسکریپت را برمی گرداند.

(دریافت متن {خ})
این تابع ترجمه از خ با استفاده از کاتالوگ (های) محلی تعریف شده
با UseGettext.

(SendMsgAndGet {comId} {CMD} بول)
فرمان را ارسال می کند CMD با شناسه comId به یک برنامه خارجی آماده است
با استفاده از پروتکل مخصوص FvwmScript با اسکریپت ارتباط برقرار کنید. اگر بول 0 است
FvwmScript منتظر پاسخ برنامه خارجی نمی ماند. در این مورد
اگر پیام را بتوان به برنامه خارجی فرستاد، مقدار برگشتی 1 و اگر پیام را می توان 0 دانست
این مورد نیست. اگر بول 1 است، سپس FvwmScript منتظر پاسخ از طرف است
برنامه خارجی و مقدار برگشتی این پاسخ است (یک خط بیش از 32000
شخصیت ها). اگر ارتباط ناموفق باشد، مقدار برگشتی 0 است. به بخش مراجعه کنید
A ارتباط پروتکل برای توضیح پروتکل ارتباطی استفاده شده

(تجزیه {خ} INT)
جایی که خ باید یک رشته از فرم باشد:
X1S1X2S2X3S3...SnXn
که در آن Xn اعدادی حاوی چهار رقم اعشاری و جایی که Sn رشته‌هایی از آن هستند
طول دقیقا Xn. مقدار برگشتی رشته S استINT. اگر INT خارج از محدوده است
(مثلا >n) مقدار برگشتی رشته خالی است. اگر خ از موارد مشخص شده نیست
مقدار بازگشتی غیرقابل پیش بینی است (اما در میانگین خالی است). این تابع
برای مدیریت رشته های بازگردانده شده توسط تابع SendMsgAndGet مفید است.

(LastString)
این تابع "رشته کاری فعلی" را برای دستور Key و the برمی گرداند
دستور SendString (به دستورات بخش). در هنگام راه اندازی این رشته خالی است، اما
هنگامی که یک Key binding شناسایی می شود (به ترتیب، یک دستور SendString دریافت می شود)،
سپس این رشته به رشته مرتبط با دستورالعمل تنظیم می شود (به ترتیب،
به فرمان).

شرطی حلقه ها

سه نوع حلقه شرطی وجود دارد. دستورالعمل "If-Then-Else" دارای این است
نحو زیر:
اگر $ToDo=={xcalc را باز کنید سپس
# فهرست دستورالعمل‌ها را {Exec xcalc &} انجام دهید
دیگر
شروع
{Exec killall xcalc &} # List of دستورالعمل ها را انجام دهید
{Exec echo xcalc killed > /dev/console} را انجام دهید
پایان
قسمت دوم «دیگر-شروع-پایان» اختیاری است. اگر حلقه فقط شامل یک دستورالعمل باشد،
شروع و پایان را می توان حذف کرد. دستور "While-Do" دارای نحو زیر است:
در حالی که $i<5 انجام دهید
شروع
$i=(Add i 1) # فهرست دستورالعمل ها را تنظیم کنید
پایان
دو رشته را می توان با "==" و دو عدد را با "<"، "<="، مقایسه کرد.
"=="، ">="، ">". حلقه "For-Do-Begin-End" دارای نحو زیر است:
برای $i=1 تا 20 انجام دهید
شروع
# فهرست دستورالعمل‌ها را {Exec xcalc &} انجام دهید
پایان

دستورات

دستور fvwm زیر ممکن است در هر زمانی اجرا شود

SendToModule نام اسکریپت SendString id SIG خ

به هر ماژول با نام مستعار یا نامی که مطابقت دارد ارسال می کند نام اسکریپت رشته

SendString id SIG خ

هنگامی که یک FvwmScript چنین پیامی را دریافت می کند به ویجت ارسال می کند id سیگنال شماره گذاری شده
SIG و رشته خ می توان با تابع LastString به دست آورد. اجازه دهید ما یک
مثال. بگویید که یک اسکریپت MyScript با ویجت دارید:
ویجت 50
نوع ملک مورد نظر
PushButton را تایپ کنید
عنوان {ترک}
...
اصلی
پیام موردی از

SingleClic:
شروع
ترک
پایان

1:
شروع
تنظیم $str = (LastString)
اگر $str == {ترک} سپس
ترک
دیگر
ChangeTitle 33 $str
پایان

پایان
سپس دستور
SendToModule MyScript SendString 50 1 str
اگر str برابر با "Quit" باشد، MyScript را مجبور به خروج می کند و در غیر این صورت عنوان آن را تغییر می دهد
ویجت 33 به خ.

از این دستور می توان برای تغییر عنوان پنجره استفاده کرد

SendToModule نام اسکریپت ChangeWindowTitle عنوان جدید [عنوان قدیمی]

باعث می شود که هر ماژول با نام مستعار یا نام مطابقت داشته باشد نام اسکریپت آن را تغییر می دهد
عنوان پنجره مرتبط به عنوان جدید. آرگومان اختیاری عنوان قدیمی وقتی وجود دارد منطقی است
چندین نمونه از یک اسکریپت هستند. این به شخص اجازه می دهد از تغییر نام خودداری کند
همه این موارد با تعیین نام پنجره مرتبط با اسکریپت هدف
(نمونه زیر را ببینید).

+ I Module FvwmScript FvwmStorageSend "/dev/hda6"
+ من منتظر FvwmStorageSend هستم
+ I SendToModule FvwmStorageSend ChangeWindowTitle HDA6
+ I Module FvwmScript FvwmStorageSend "/dev/hda1"
+ من منتظر FvwmStorageSend هستم
+ I SendToModule FvwmStorageSend ChangeWindowTitle HDA1 FvwmStorageSend

بدون آرگومان FvwmStorageSend در آخرین مورد، دستور SendToModule خواهد داشت
نام هر دو نمونه FvwmStorageSend را به HDA1 تغییر داد.

مثال ها

نمونه هایی از اسکریپت ها را در دایرکتوری تنظیمات fvwm خواهید دید.

FvwmScript-BellSetup، FvwmScript-KeyboardSetup، FvwmScript-PointerSetup و FvwmScript-
ScreenSetup مجموعه ای از اسکریپت ها هستند که تنظیمات X را تغییر می دهند. این اسکریپت ها تنظیمات برگزیده را ذخیره می کنند
در فایلی به نام ~/.xinit-fvwmrc (اگر می خواهید از نام فایل دیگری استفاده کنید، آن را به عنوان
اولین آرگومان فیلمنامه). اگر می خواهید این تنظیمات برگزیده را در هر راه اندازی بارگیری کنید،
قبل از این باید خط ".xinit-fvwmrc" را در فایل .xinitrc (یا xsession.) خود وارد کنید.
شروع fvwm

FvwmScript-BaseConfig فوکوس fvwm و خط مشی صفحه بندی ماوس، قرار دادن پنجره را تغییر می دهد،
کدورت و سایر ویژگی های دستورات حرکت و تغییر اندازه، جذب سریع و سایه زدن
انیمیشن این اسکریپت تنظیمات برگزیده را در فایلی با نام .FvwmBaseConfig در کاربر ذخیره می کند.
دایرکتوری داده (یعنی $HOME/.fvwm یا $FVWM_USERDIR در صورت تنظیم). اگر می خواهید اینها را بارگذاری کنید
در هر راه اندازی باید خط "Read .FvwmBaseConfig" را در fvwm خود اضافه کنید.
فایل پیکربندی. اگر می خواهید از نام فایل دیگری استفاده کنید، آن را به عنوان اولین آرگومان قرار دهید
از فیلمنامه وقتی روی Ok یا Apply یک تابع fvwm کلیک می کنید که ممکن است نام آن را تعریف کنید
BaseConfigOkFunc یا BaseConfigApplyFunc نامیده می شود. این اجازه می دهد تا برای بارگذاری مجدد خاص
سبک های برنامه ای که اسکریپت از بین برده است (مثلاً AddToFunc BaseConfigOkFunc I Read
MyAppStyle).

FvwmScript-Buttons یک پانل دکمه است که می تواند جایگزین FvwmButtons شود (این اسکریپت پشتیبانی می کند
منوهای بازشو و به xload، xclock، FvwmPager، TkDesk نیاز دارد). FvwmScript-Colorset اجازه می دهد
شما می توانید مجموعه رنگ های خود را ویرایش کنید (به FvwmTheme مراجعه کنید). FvwmScript-Date به شما امکان می دهد تاریخ و
زمان. FvwmScript-FileBrowser یک مرورگر فایل است که توسط سایر اسکریپت ها استفاده می شود. FvwmScript-
Find یک مقدمه مقدماتی برای پیدا کردن است. FvwmScript-Quit به فرد اجازه می دهد تا از fvwm خارج شود، راه اندازی مجدد شود
fvwm یا یک مدیر ویندوز دیگر، یا کامپیوتر را خاموش و راه اندازی مجدد کنید. FvwmScript-
ScreenDump یک دامپر صفحه نمایش است. FvwmScript-WidgetDemo یک اسکریپت نمونه خالص است. را ببینید
بخش بعدی برای FvwmScript-ComExample.

A ارتباط پروتکل

FvwmScript یک زبان برنامه نویسی ضعیف (اما ساده) است. اگر شما نیاز به مقابله با بسیاری از
داده ها و/یا شما نیاز به استفاده از الگوریتم های پیچیده دارید، باید از یک برنامه خارجی (در پرل
به عنوان مثال) و اطلاعات مورد نظر را به اسکریپت FvwmScript خود "ارسال کنید". اولین
رویکرد استفاده از تابع GetOutput است. این ساده است اما شما باید خود را دوباره اجرا کنید
برنامه خارجی هر بار که به اطلاعاتی از آن نیاز دارید (و این ممکن است باعث عملکرد شود
چالش ها و مسائل). روش دوم استفاده از تابع SendMsgAndGet است که گسترش می یابد
FvwmScript با استفاده از هر زبان برنامه نویسی که می تواند با لوله های نامگذاری شده (fifos) مقابله کند. ما
این راه حل را در این بخش توضیح دهید. (رویکرد سوم استفاده از fvwm-themes-com از
بسته fvwm-themes، اما در واقع متد SendMsgAndGet پیاده سازی
fvwm-themes-com در داخل FvwmScript است و این عملکرد بهتری را ارائه می دهد).

اساسا، شما یک برنامه "خارجی" (برنامه به اختصار) را از FvwmScript خود شروع می کنید
اسکریپت (فیلمنامه به اختصار). این برنامه در پس زمینه اجرا می شود و شما از آن استفاده می کنید
تابع SendMsgAndGet در اسکریپت خود را برای پرسیدن سوال یا ارائه دستورالعمل به
برنامه برنامه باید به شدت به یک پروتکل ارتباطی خاص احترام بگذارد. اول از
همه وجود دارد یک شناسه comId برای ارتباط، باید شامل شناسه فرآیند باشد
از اسکریپت برای اجرای خوب پروتکل (از تابع GetPid و پاس استفاده کنید
la comId از طریق یک گزینه در برنامه). پروتکل از دو fifo در کاربر fvwm استفاده می کند
دایرکتوری با نام: .tmp-com-in-comId و tmp-com-out-comId. برنامه باید ایجاد کند و
گوش دادن به .tmp-com-in-comId فیفو سپس، هنگامی که FvwmScript تابعی از
فرم:

تنظیم $answer = (SendMsgAndGet {comId} {CMD} بول)

FvwmScript را می نویسد CMD روی این فیفو به این ترتیب برنامه می تواند آن را بخواند CMD و می تواند
عمل مناسب را اجرا کنید (برای پشتیبانی از چند
ارتباطات). اگر بول 0 است، FvwmScript منتظر پاسخ از برنامه نمی ماند و
در صورت موفقیت آمیز بودن اقدامات قبلی 1 و در صورت شکست 0 برگردانید (پس برنامه باید "برود
بازگشت" به in fifo). اگر بول 1 است، سپس FvwmScript (20 ثانیه) برای پاسخ از طرف منتظر می ماند
برنامه و به نوبه خود پاسخ را به اسکریپت برمی گرداند (توجه داشته باشید که بول به منتقل نمی شود
برنامه همانطور که باید بداند کدام دستورات نیاز به پاسخ دارند). برای پاسخ دادن، برنامه ایجاد می کند
tmp-com-out-comId fifo و جواب را روی آن می نویسد. برنامه باید صبر کند تا
FvwmScript پاسخ را می خواند و سپس باید outfifo را حذف کند و به داخل برگردد
فیفو پاسخ باید شامل یک خط با حداکثر 32000 کاراکتر باشد (نگاه کنید
در تابع Parse برای رسیدگی به چندین خط به عنوان یک خط).

یک راه ساده برای درک این پروتکل و نوشتن اسکریپت ها و برنامه هایی که از آن استفاده می کنند است
برای نگاهی به مثال (غیر مفید) FvwmScript-ComExample و fvwm-script-
ComExample.pl (که در فهرست اطلاعات fvwm یافت می شود). علاوه بر این، این پیاده سازی
از پروتکل سوالاتی را حل می کند: اگر اسکریپت به دلیل بدی خارج شد چه باید کرد؟
اگر برنامه به دلیل بدی خارج شود چه باید کرد؟ ...و غیره.

از FvwmScript به صورت آنلاین با استفاده از خدمات onworks.net استفاده کنید