FvwmScript - מקוון בענן

תָכְנִית:

שֵׁם

FvwmScript - מודול לבניית ממשק משתמש גרפי

תַקצִיר

FvwmScript חייב להיות מולידה על ידי Fvwm. זה לא יעבוד משורת הפקודה.

תיאור

FvwmScript הוא מודול המאפשר לך לבנות יישומים גרפיים רבים כגון
אביזרים לשולחן העבודה, לוח כפתורים עם תפריטים קופצים, דיאלוגים מודאליים... בעת ההפעלה,
FvwmScript קורא את הקובץ שצוין בשורת הפקודה. קובץ זה מכיל את
תַסרִיט. סקריפט זה אינו כלול בקובץ התצורה של Fvwm.

סקריפט FvwmScript ניתן לשליטה מלאה באמצעות המקלדת. (Shift)-טאב מסתובב
מסביב לווידג'טים, Return מדמה לחיצת עכבר, החצים מזיזים את הסמן או משנים
הערכים של הווידג'ט ו-Escape "מבטלים" עבור Menu ו-PopupMenu.

קְרִיאָה

ניתן להפעיל FvwmScript על ידי הוספת השורה `Module FvwmScript name_of_script' ב-
קובץ .fvwm2rc. הקובץ "name_of_script" יכול להתחיל עם קו נטוי, ובמקרה זה, הוא א
נתיב מוסמך במלואו, והקובץ נקרא. אם "name_of_script" לא מתחיל בא
סלאש, FvwmScript יראה בכמה מקומות שונים. אם ה-.fvwm2rc הכיל את
שורת הפקודה `*FvwmScript: Path path_of_the_script_directory', FvwmScript ינסה את זה
מַדרִיך. אם זה לא עובד, FvwmScript מנסה את ספריית תצורת המערכת ו
ספריית תצורת המשתמש כמתואר תחת הפקודה "קרא" ב-fvwm man
עמוד.

ניתן להציב את הפקודה להפעלת FvwmScript על שורה בפני עצמה, אם FvwmScript אמור להיות
נוצר במהלך האתחול של fvwm, או יכול להיות קשור לתפריט או לחצן עכבר או
הקשה על מנת להפעיל אותו מאוחר יותר.

תְצוּרָה אפשרויות

ניתן להשתמש בפקודות הבאות בקובץ התצורה (ראה fvwm(1), סעיף מודול
פקודות לפרטים). הם משמשים רק אם פקודות הסקריפט המתאימות אינן
בשימוש בתסריט.

*FvwmScript: DefaultFont גופן
מציין את גופן ברירת המחדל לשימוש. אם לא צוין בפקודה זו או ב-
סקריפט עם הפקודה גופן, יש להניח גופן קבוע.

*FvwmScript: DefaultFore צֶבַע
מציין את צבע החזית המשמש כברירת מחדל. אם לא צוין עם זה
הפקודה או בסקריפט עם הפקודה ForeColor, נעשה שימוש בשחור.

*FvwmScript: DefaultBack צֶבַע
מציין את צבע הרקע המשמש כברירת מחדל. אם לא צוין עם זה
הפקודה או בסקריפט עם הפקודה BackColor, נעשה שימוש ב-grey85.

*FvwmScript: DefaultHilight צֶבַע
מציין את צבע ההדגשה המוגדר כברירת מחדל לשימוש. אם לא צוין בפקודה זו
או בסקריפט עם הפקודה HilightColor, נעשה שימוש ב-grey100.

*FvwmScript: DefaultShadow צֶבַע
מציין את צבע הצללים המשמש כברירת מחדל. אם לא צוין בפקודה זו
או בסקריפט עם הפקודה ShadowColor, נעשה שימוש ב-grey55.

*FvwmScript: DefaultColorset ערכת צבעים
אומר למודול להשתמש בערכת צבעים ערכת צבעים בתור ערכת הצבעים המוגדרת כברירת מחדל. עיין ב
FvwmTheme דף אדם לפרטים על ערכות צבעים.

אֲנָטוֹמִיָה OF A SCRIPT

FvwmScript משתמש בשפת תכנות מסוימת. תסריט מורכב מחמישה חלקים.
כותרת מכילה מאפיינים כלליים של החלון ומאפייני ברירת המחדל עבור כולם
ווידג'טים. החלק השני מכיל הוראות שמבוצעות עם ההפעלה של ה-
תַסרִיט. החלק השלישי מכיל משימות תקופתיות אשר מבוצעות כל שנייה. ה
החלק הרביעי מכיל הוראות שמתבצעות ביציאה. והחלק האחרון מכיל
התיאור של ווידג'טים. יישומון מורכב מאחד עשר סוגי פריטים: תוויות טקסט,
קלט טקסט בשורה אחת, לחצני רדיו, תיבת סימון, לחצני לחיצה, אופקיים ואנכיים
פסי גלילה, מלבנים, תפריטים קופצים, swallowexecs ומיני גלילה.

כּוֹתֶרֶת OF A SCRIPT

התחביר הוא כדלקמן:

WindowTitle מחרוזת
אפשרות זו מגדירה את כותרת החלון.

גודל חלון רוחב גובה
אפשרות זו מגדירה את גודל החלון. רוחב ו גובה הם ערכים מספריים.

מיקום חלון x y
אפשרות זו מגדירה את מיקום החלון. x ו y הם ערכים מספריים.

ForeColor {צֶבַע}
אפשרות זו מגדירה את צבע החזית המוגדר כברירת מחדל עבור כל הווידג'טים.

צבע אחורי {צֶבַע}
אפשרות זו מגדירה את צבע הרקע המוגדר כברירת מחדל עבור כל הווידג'טים.

HilightColor {צֶבַע}
אפשרות זו מגדירה את צבע ההבהרה המוגדר כברירת מחדל עבור כל הווידג'טים.

ShadowColor {צֶבַע}
אפשרות זו מגדירה את צבע הצללים המוגדר כברירת מחדל עבור כל הווידג'טים.

ערכת צבעים {n}
אפשרות זו מגדירה את ערכת הצבעים המוגדרת כברירת מחדל עבור כל הווידג'טים.

גופן {גופן}
אפשרות זו מגדירה את גופן ברירת המחדל עבור כל הווידג'טים.

UseGettext [locale_path]
אפשר את השימוש במנגנון gettext המשמש את WindowLocaleTitle,
הוראות LocaleTitle, ChangeLocaleTitle והפונקציה Gettext. אם לא
ניתן ארגומנט, נעשה שימוש בקטלוג המקומי של FvwmScript המוגדר כברירת מחדל. הקטלוג הזה הוא
תחת ספריית ההתקנה של locale 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=הפעל מחדש
סוֹף
הוראות אלה משמשות להשמעת צליל, להזיז את המצביע ל-widget 1 ואל
אתחול $ToDo ל"הפעל מחדש" בכל הפעלה.

תְקוּפָתִי משימות

חלק זה של הסקריפט מכיל הוראות שמתבצעות כל שנייה. ל
דוּגמָה:
משימות תקופתיות
להתחיל
אם (RemainderOfDiv (GetTime) 10)==0 אז
בצע {Exec xcalc}
סוֹף
דוגמה זו מראה כיצד להפעיל את xcalc כל 10 שניות.

LA תיכנע פונקציה

חלק זה של הסקריפט מכיל הוראות שמתבצעות כאשר הסקריפט יוצא
(לאחר הוראת היציאה או אם תסגור את החלון עם הלחצנים סגור, מחק או הרס
פקודת fvwm). לדוגמה
QuitFunc
להתחיל
עשה {הד ביי, ביי}
סוֹף
שים לב שאם השתמשת בפקודה KillModule fvwm כדי לסגור את הסקריפט, חלק
הוראות או פונקציות המסתמכות על קיומו של קישור תקשורת בין
script ו-fvwm לא יבוצעו (לדוגמה הפקודה Do). להרוג בצורה חלקה א
סקריפט עם פקודת fvwm ראה את פקודות סָעִיף.

רָאשִׁי OF A SCRIPT

החלק השני של הסקריפט מכיל את התיאור עבור כל ווידג'ט בסקריפט.
לכל תיאור יישומון שני חלקים. החלק הראשון מתאר מאפיינים ראשוניים, ה
החלק השני מכיל הוראות שמתבצעות כאשר הווידג'ט מקבל הודעות.
כל הווידג'טים יכולים לשלוח ולקבל הודעות. כל ההודעות מזוהות באמצעות מספר. ה
ההודעה "UserAction" נשלחת ל-widget כאשר המשתמש מפעיל את ה-widget. התחביר
עבור החלק הראשון הוא:
מזהה יישומון מספר בין 1 ל-999 כולל
נכס
הקלד מחרוזת
גודל רוחב גובה
מיקום xy
כותרת { מחרוזת }
ערך int
MaxValue int
MinValue int
מחרוזת גופנים
ForeColor { צבע }
BackColor { color }
HilightColor { צבע }
ShadowColor { צבע }
ערכת צבעים int
דגלים דגליםOpt
האפשרות flagsOpt to Flags היא רשימה מופרדת מרווחים המכילה אחד או יותר מה-
מילות מפתח מוּסתָר, NoReliefString, NoFocus, שמאל / מרכז / ימין. מוּסתָר משמש ל
ציין אם הווידג'ט מוסתר בעת ההפעלה. NoReliefString מציין אם מחרוזות מצוירות
עם הקלה או לא. NoFocus מציין אם הווידג'ט יכול לקבל את מיקוד המקלדת או לא.
כברירת מחדל, כל הווידג'טים לוקחים מיקוד, למעט מלבן, HDipstick ו-VDipstick שאינם יכולים.
יתר על כן, הווידג'טים של NoFocus מדלגים כאשר אתה מסתובב סביב הווידג'טים עם
(Shift-)קיצור טאב. שמאל / מרכז / ימין מציין את מיקום הטקסט. אלה חלים
רק ל-ItemDraw, List, Menu, PopupMenu ו-PushButton. ברירת המחדל היא מרכז עבור ItemDraw
ו-PushButton ו שמאל עבור שאר הווידג'טים.

ניתן להשתמש ב-LocaleTitle במקום Title, לשימוש בקטלוג/ים המקומיים שהוגדרו עם
השתמש ב-Gettext.

יש לציין את המיקום של כל ווידג'ט.

התחביר של החלק השני הוא:
ראשי
הודעת מקרה של
SingleClic:
להתחיל
# רשימה של הוראות שיהיו
# מבוצע כאשר הווידג'ט מקבל
# הודעה "SingleClic". ההודעה הזו היא
# שנוצר על ידי המשתמש.
סוֹף
1:
להתחיל
# רשימה של הוראות שיהיו
# מבוצע כאשר הווידג'ט מקבל
# הודעה 1
סוֹף
סוֹף

רשימה OF ווידג'טים

ישנם חמישה עשר סוגים של ווידג'טים.

תיבת סימון: הצג תיבת סימון עם מחרוזת.

כותרת: כותרת תיבת הסימון.

ערך: אם הערך שווה ל-1, התיבה מסומנת אחרת היא לא.

אל האני מידה מתעלמים מהרכוש.

HDipstick: הצג מקל אופקי.
ניתן להשתמש בווידג'ט זה כדי להציג את השימוש בדיסק.

ערך: ציין את הערך הנוכחי של המדידה.

MinValue: ציין את הערך המינימלי של המדידה.

ערך מקסימלי: ציין את הערך המרבי של המדיד.

גודל מינימלי של 30x11 מוטל.

HScrollBar: הצג פס גלילה אופקי.

ערך: מיקום האגודל.

ערך מקסימלי: גבול עליון של ערך.

MinValue: גבול תחתון של ערך.

מתעלמים ממאפיין הגובה ומוטל רוחב מינימלי. הרוחב צריך להיות
לפחות הטווח פלוס 37 אם כל הערכים יהיו ניתנים לבחירה, למשל דקה של 0 ו
ל-max of 10 יש טווח של 11 ולכן צריך להיות רוחב מינימלי של 48.

ItemDraw: הצג סמל ו/או מחרוזת.

כותרת: מחרוזת להצגה.

סמל: סמל להצגה.

ערך מקסימלי: קואורדינטת x של הסמן.

MinValue: קואורדינטת y של הסמן.

הגודל נעשה מספיק גדול כדי להכיל את הכותרת ו/או את הסמל.

רשימה: הצג רשימה.
רשימה מאפשרת למשתמש לבחור בין אפשרויות שונות.

ערך: ציין איזו אפשרות נבחרה.

MinValue: אפשרות גלויה ראשונה.

כותרת: הכותרת מכילה אפשרויות המוצגות ברשימה. התחביר הוא הבא:
{אפשרות 1|אפשרות 2|...|אפשרות N}. כל התפריטים מוצגים בחלק העליון של החלון.

מוטל גובה מינימלי של שלושה פריטים והרוחב עשוי להיות לפחות
108.

תפריט: הצג תפריט המאפשר למשתמש לבחור אפשרות.
פריטים מסוג תפריט פרוסים משמאל לימין לאורך החלק העליון של החלון.
מתעלמים ממאפייני הגודל והמיקום.

ערך: ציין איזו אפשרות נבחרה.

כותרת: הכותרת מכילה אפשרויות המוצגות בתפריט. התחביר הוא הבא:
{אפשרות 1|אפשרות 2|...|אפשרות N}.

MiniScroll: הצג פס גלילה אנכי קטן מאוד.

ערך: מיקום האגודל.

ערך מקסימלי: גבול עליון של ערך.

MinValue: גבול תחתון של ערך.

הגודל מוגדר ל-19x34.

חלונות קופצים: הצג תפריט מוקפץ.

ערך: ציין איזו אפשרות נבחרה.

כותרת: לכותרת יש את התחביר הבא: {אפשרות 1|אפשרות 2|...|אפשרות N}." אפשרות
1|אפשרות 2|...|אפשרות N" הוא התפריט המוקפץ שמוצג בעת לחיצה על העכבר
לַחְצָן.

מתעלמים ממאפיין הגודל.

לחץ על הכפתור: הצג כפתור לחיצה עם סמל ו/או מחרוזת.

כותרת: למחרוזת הזו יש את התחביר הבא {כותרת הכפתור|אפשרות 1|אפשרות
2|אפשרות3|...|אפשרות N}. "אפשרות 1|אפשרות 2|...|אפשרות N" הוא התפריט המוקפץ שבו
מוצג בעת לחיצה על הכפתור הימני.

סמל: סמל להצגה.

הכפתור עשוי להיות גדול מספיק כדי להתאים לסמל או לתווית.

רדיוטון: הצג כפתור בחירה עם מחרוזת.

כותרת: כותרת לחצן הבחירה.

ערך: אם הערך שווה ל-1, התיבה מסומנת אחרת היא לא.

מתעלמים ממאפיין הגודל

מלבן: הצג מלבן.
ניתן להשתמש בסוג זה של יישומון לקישוט חלון.

SwallowExec
סוג זה של יישומון גורם ל-FvwmScript להוליד תהליך וללכוד את הראשון
חלון ששמו או המשאב שלו שווים לכותרת, והצג אותו בסקריפט
חלון.

כותרת: ציין את שם החלון שיילכד ויוצג בסקריפט
חלון.

SwallowExec: ציין את שורת הפקודה לביצוע כדי להריץ את התהליך. מודולים יכולים
גם להיבלע.

ערך: ציין את מראה הגבול. ערך אפשרי: -1, 0, 1.

הגודל עשוי להיות לפחות 30x30

שדה טקסט: הצג שדה קלט טקסט.
ניתן להשתמש בשדה קלט הטקסט כדי לערוך מחרוזת בשורה אחת.

כותרת: תוכן שדה הטקסט.

ערך: מיקום נקודת ההכנסה.

MinValue: מיקום סוף הבחירה.

ערך מקסימלי: התו הגלוי הראשון של הכותרת

מתעלמים ממאפיין הגובה, הרוחב עשוי להיות רחב יותר ב-40 פיקסלים לפחות
מאשר התוכן הראשוני.

VDipstick: הצג סטיק אנכי.

ערך: ציין את הערך הנוכחי של המדידה.

MinValue: ציין את הערך המינימלי של המדידה.

ערך מקסימלי: ציין את הערך המרבי של המדיד.

הגודל עשוי להיות לפחות 11x30.

VScrollBar: הצג פס גלילה אנכי.

ערך: מיקום האגודל.

ערך מקסימלי: גבול עליון של ערך.

MinValue: גבול תחתון של ערך.

מתעלמים ממאפיין הרוחב ומוטל גובה מינימלי. הגובה צריך
תהיה לפחות הטווח פלוס 37 אם כל הערכים יהיו ניתנים לבחירה, למשל דקה של 0
ולמקסימום של 10 יש טווח של 11 ולכן צריך להיות בגובה מינימלי של 48.

הוראות

הנה התיאור של כל ההוראות.

HideWidget id : הסתר את הווידג'ט הממוספר id.

ShowWidget id: הצג את הווידג'ט ממוספר id.

ChangeValue id1 id2
הגדר את הערך של הווידג'ט הממוספר id1 ל id2.

ChangeMaxValue id1 id2
הגדר את הערך המקסימלי של הווידג'ט הממוספר id1 ל id2.

ChangeMinValue id1 id2
הגדר את הערך המינימלי של הווידג'ט הממוספר id1 ל id2.

ChangeTitle id1 id2
הגדר את כותרת הווידג'ט הממוספרת id1 ל id2.

ChangeWindowTitle מחרוזת
הגדר את כותרת החלון ל מחרוזת.

ChangeWindowTitleFromArg מספר
הגדר את כותרת החלון לערך של מספרארגומנט התסריט -ה.

ChangeLocaleTitle id1 id2
בתור ChangeTitle, אך השתמש בקטלוג/ים המקומיים המוגדרים עם UseGettext.

ChangeIcon id1 id2
הגדר את הסמל של הווידג'ט הממוספר id1 ל id2.

ChangeForeColor id1 {צֶבַע}
הגדר את צבע החזית של הווידג'ט הממוספר id1 ל {צֶבַע}.

ChangeBackColor id1 {צֶבַע}
הגדר את צבע הרקע של הווידג'ט הממוספר id1 ל {צֶבַע}.

ChangeColorSet id1 id2
הגדר את ערכת הצבעים של הווידג'ט הממוספר id1 ל id2. ציון יישומון 0 מגדיר את
ערכת צבעי החלון הראשי.

שינוי מיקום id1 x y
הזז את הווידג'ט הממוספר id1 לעמדה (x,y).

שינוי גודל id1 רוחב גובה
הגדר את גודל הווידג'ט הממוספר id1 ל (רוחב,גובה).

ChangeFont id1 newfont
הגדר את הגופן של הווידג'ט הממוספר id1 ל newfont.

WarpPointer id
עקם את מצביע העכבר לתוך הווידג'ט הממוספר id.

כתוב שם הקובץ {עמ' 1} {עמ' 2} וכו
כתוב לקובץ שם הקובץ המחרוזת שהיא השרשור של כל הארגומנטים
עמ' 1, עמ' 2, וכו '

עשה {הפקודה טוען}
בצע את הפקודה fvwm בתוך בלוק Do. כל פקודת fvwm כמתואר ב-
ניתן להשתמש בדף אדם של fvwm2. פקודות נשלחות מהמודול הזה ל-fvwm main
תוכנית לעיבוד. אורך הפקודה והארגומנטים לא יכול לעלות על 988
תווים.

הגדר $היה={str1} {עמ' 2} וכו
שרשור את כל הארגומנטים למחרוזת והגדר את המשתנה $היה למחרוזת הזו.

צא: צא מהתוכנית.

שלח אות id1 id2
שלח הודעה ממוספרת id2 ליישומון id1.

SendToScript id_script {עמ' 11} {עמ' 2} וכו
שלח הודעה לסקריפט המזוהה על ידי id_script. המסר הוא ה
שרשור של str1, str2...

מפתח שם מפתח לשנות id sig עמ' 1 עמ' 2 וכו '
מקשר מקש מקלדת להוראה

שלח אות id sig

ומגדיר את "המחרוזת האחרונה" לשרשור של str1, str2... (ראה את
פונקציית LastString). ה שם מפתח ו משנים שדות מוגדרים כמו ב-fvwm
פקודת מפתח.

טיעונים

רוב הפקודות משתמשות בארגומנטים. ישנם שני סוגים של ארגומנטים: מספרים ומחרוזות. א
ארגומנט מספרי הוא ערך שהוא בין -32000 ל-+32000. מחרוזת היא תמיד
מוקף בפלטה. משתנים מתחילים תמיד עם התו "$" ויכולים להכיל את שניהם
מספרים ומחרוזות.

פונקציות

כל הפונקציות משתמשות בארגומנטים. פונקציות יכולות להחזיר גם מחרוזת וגם מספר. התחביר
היא:
(פונקציה argument1 argument2 וכו')
להלן רשימת הטיעונים המלאה:

(GetTitle id)
החזר את הכותרת של הווידג'ט הממוספר id.

(GetValue id)
החזר את הערך הנוכחי של הווידג'ט הממוספר id.

(GetMinValue id)
החזר את הערך המינימלי הנוכחי של הווידג'ט הממוספר id.

(GetMaxValue id)
החזר את הערך המקסימלי הנוכחי של הווידג'ט הממוספר id.

(GetFore id)
החזר את ערך החזית הנוכחי של RGB של הווידג'ט הממוספר id בפורמט hex
RRGGBB.

(חזור id)
החזר את ערך הרקע הנוכחי של ה-RGB של הווידג'ט הממוספר id בפורמט hex
RRGGBB.

(GetHilight id)
החזר את ערך ההדגשה הנוכחי של ה-RGB של הווידג'ט הממוספר id בפורמט hex
RRGGBB.

(GetShadow id)
החזר את ערך הצל RGB הנוכחי של הווידג'ט הממוספר id בפורמט hex
RRGGBB.

(GetOutput {str} int1 int2)
מבצע את הפקודה str, מקבל את הפלט הסטנדרטי ומחזיר את המילה שנמצאת ב
הקו int1 ובתפקיד int2. אם int2 שווה ל-1, GetOutput מחזירה
את הקו המלא.

(NumToHex int)
החזר את הערך ההקסדצימלי של int.

(HexToNum {str})
החזר את הערך העשרוני של str, str חייב להיות ערך הקסדצימלי.

(לְהוֹסִיף int1 int2)
החזר את התוצאה של (int1+int2).

(רב int1 int2)
החזר את התוצאה של (int1*int2).

(div int1 int2)
החזר את התוצאה של (int1/int2).

(StrCopy {str} int1 int2)
החזר את המחרוזת שנמצאת בין מיקום int1 ל-int2. לדוגמה, (StrCopy
{Hello} 1 2) מחזיר {He}

(LaunchScript {str})
פונקציה זו מפעילה את הסקריפט בשם str ומחזירה מספר זיהוי.
מספר זה נחוץ כדי להשתמש בפונקציות SendToScript ו-ReceiveFromScript.
המחרוזת str מכילה את שם הסקריפט וכמה ארגומנטים.

(GetScriptArgument {int})
פונקציה זו מחזירה את סקריפט הארגומנט המשמש בפונקציה LaunchScript. אם
int שווה לאפס, GetScriptArgument מחזירה את שם הסקריפט.

(GetScriptFather)
פונקציה זו מחזירה את מספר הזיהוי של אבי הסקריפט.

(ReceivFromScript {int})
פונקציה זו מחזירה את ההודעה שנשלחה על ידי הסקריפט הממוספר int.

(RemainderOfDiv {int1 int2}): ט
פונקציה זו מחזירה את שאר החלוקה (int1/int2).

(GetTime)
פונקציה זו מחזירה את הזמן בשניות.

(GetPid)
פונקציה זו מחזירה את מזהה התהליך של הסקריפט.

(Gettext {str})
פונקציה זו מחזירה את התרגום של str על-ידי שימוש בקטלוג/ים המקומיים שהוגדרו
עם UseGettext.

(SendMsgAndGet {comId} {cmd} bool)
שולח את הפקודה cmd עם מזהה comId לתוכנית חיצונית מוכנה
לתקשר עם הסקריפט באמצעות פרוטוקול ספציפי ל-FvwmScript. אם bool הוא 0
FvwmScript לא ממתין לתשובה מהתוכנית החיצונית. במקרה זה ה
הערך המוחזר הוא 1 אם ניתן לשלוח את ההודעה לתוכנית החיצונית ו-0 אם
זה לא המקרה. אם bool הוא 1, ואז FvwmScript ממתין לתשובה מה-
תוכנית חיצונית וערך ההחזר הוא התשובה הזו (שורה של לא יותר מ-32000
דמויות). אם התקשורת נכשלת, הערך המוחזר הוא 0. עיין בסעיף
A תקשורת נוהל לתיאור של פרוטוקול התקשורת בשימוש.

(נתח {str} int)
איפה str חייבת להיות מחרוזת של הטופס:
X1S1X2S2X3S3...SnXn
כאשר ה-Xn הם מספרים המכילים ארבע ספרות עשרוניות והיכן Sn הם מחרוזות של
אורך Xn בדיוק. הערך המוחזר הוא המחרוזת Sint. אם int הוא מחוץ לטווח
(למשל, >n) הערך המוחזר הוא המחרוזת הריקה. אם str אינו מהמצוין
טופס, ערך ההחזר אינו ניתן לחיזוי (אך ריק בממוצע). הפונקציה הזו
שימושי לטיפול במחרוזות המוחזרות על ידי הפונקציה SendMsgAndGet.

(מחרוזת אחרונה)
פונקציה זו מחזירה את "מחרוזת העבודה הנוכחית" עבור הוראת המפתח וה-
פקודת SendString (ראה את פקודות סָעִיף). בעת ההפעלה המחרוזת הזו ריקה, אבל
כאשר מזוהה קשירת מפתח (בהתאמה, מתקבלת פקודת SendString),
אז מחרוזת זו מוגדרת למחרוזת הקשורה להוראה (בהתאמה,
לפקודה).

מותנה לולאות

ישנם שלושה סוגים של לולאות מותנות. ההוראה "אם-אז-אחר" כוללת את
התחביר הבא:
אם $ToDo=={פתח את xcalc} אז
בצע {Exec xcalc &} # רשימת הוראות
אחר
להתחיל
בצע {Exec killall xcalc &} # רשימת הוראות
בצע {Exec echo xcalc killed > /dev/console}
סוֹף
החלק השני "אחר-התחלה-סוף" הוא אופציונלי. אם הלולאה מכילה רק הוראה אחת,
אפשר לוותר על התחלה וסוף. להוראה "While-Do" יש את התחביר הבא:
בעוד $i<5 Do
להתחיל
הגדר $i=(Add i 1) # רשימת הוראות
סוֹף
ניתן להשוות שתי מחרוזות עם "==" וניתן להשוות שני מספרים עם "<", "<=",
"==", ">=", ">". ללולאה "For-Do-Begin-End" יש את התחביר הבא:
עבור $i=1 עד 20 עשה
להתחיל
בצע {Exec xcalc &} # רשימת הוראות
סוֹף

פקודות

ניתן לבצע את הפקודה fvwm הבאה בכל עת

SendToModule שם סקריפט SendString id sig str

הוא שולח לכל מודול עם כינוי או שם שתואמים שם סקריפט המיתר

SendString id sig str

כאשר FvwmScript מקבל הודעה כזו הוא שולח ל-Widget id האות ממוספר
sig והמחרוזת str ניתן להשיג עם הפונקציה LastString. תנו לנו לתת
דוגמא. אמור שיש לך סקריפט MyScript עם הווידג'ט:
יישומון 50
נכס
הקלד PushButton
כותרת {צא}
...
ראשי
הודעת מקרה של

SingleClic:
להתחיל
להפסיק
סוֹף

1:
להתחיל
הגדר $str = (LastString)
אם $str == {צא} אז
להפסיק
אחר
ChangeTitle 33 $str
סוֹף

סוֹף
ואז הפקודה
SendToModule MyScript SendString 50 1 str
מאלץ את MyScript לצאת אם str שווה ל-"Quit" ואם לא זה משנה את הכותרת של
יישומון 33 ל-str.

ניתן להשתמש בפקודה זו כדי לשנות את כותרת החלון

SendToModule שם סקריפט ChangeWindowTitle newTitle [oldTitle]

זה גורם לכך שכל מודול עם כינוי או שם תואם שם סקריפט משנה את שלו
כותרת החלון המשויכת ל newTitle. הטיעון האופציונלי oldTitle הגיוני כשיש
הם מספר מופעים של אותו סקריפט. זה מאפשר להימנע משינוי השם של
כל המופעים הללו על ידי ציון שם החלון המשויך לסקריפט היעד
(ראה את הדוגמה למטה).

+ I Module FvwmScript FvwmStorageSend "/dev/hda6"
+ I Wait FvwmStorageSend
+ I SendToModule FvwmStorageSend ChangeWindowTitle HDA6
+ I Module FvwmScript FvwmStorageSend "/dev/hda1"
+ I Wait FvwmStorageSend
+ I SendToModule FvwmStorageSend ChangeWindowTitle HDA1 FvwmStorageSend

ללא הארגומנט FvwmStorageSend במקרה האחרון, הפקודה SendToModule תהיה
שינה ל-HDA1 את השם של שני המופעים של FvwmStorageSend.

דוגמאות

תמצא דוגמאות של סקריפטים בספריית התצורה של fvwm.

FvwmScript-BellSetup, FvwmScript-KeyboardSetup, FvwmScript-PointerSetup ו-FvwmScript-
הגדרות מסך הם קבוצה של סקריפטים שמשנים את הגדרות X. סקריפטים אלו שומרים העדפות
לתוך קובץ בשם ~/.xinit-fvwmrc (אם אתה רוצה להשתמש בשם קובץ אחר, תן אותו בתור
הטיעון הראשון של התסריט). אם אתה רוצה לטעון את ההעדפות האלה בכל הפעלה,
עליך לכלול את השורה ".xinit-fvwmrc" בקובץ .xinitrc (או .xsession) שלך לפני
מתחיל fvwm.

FvwmScript-BaseConfig משנה את מדיניות המיקוד של fvwm ועכבר ההחלפה, מיקום החלונות,
אטימות ותכונות אחרות של פקודות מהלך ושינוי גודל, משיכה והצללה
אנימציה. סקריפט זה שומר העדפות בקובץ בשם .FvwmBaseConfig בקובץ של המשתמש
ספריית הנתונים (כלומר, $HOME/.fvwm או $FVWM_USERDIR אם מוגדר). אם אתה רוצה לטעון את אלה
העדפות בכל הפעלה עליך להוסיף את השורה "Read .FvwmBaseConfig" ב-fvwm שלך
קובץ תצורה. אם ברצונך להשתמש בשם קובץ אחר, תן אותו כארגומנט הראשון
של התסריט. כאשר אתה לוחץ על אישור או החל פונקציה fvwm שאתה עשוי להגדיר בשם
BaseConfigOkFunc או BaseConfigApplyFunc נקראים. זה מאפשר טעינה מחדש ספציפית
סגנונות יישום שהסקריפט הרס (למשל, AddToFunc BaseConfigOkFunc I Read
MyAppStyle).

FvwmScript-Buttons הוא חלונית לחצנים שיכול להחליף את FvwmButtons (סקריפט זה תומך
תפריטים קופצים ודורש xload, xclock, FvwmPager, TkDesk). FvwmScript-Colorset מאפשר
לך לערוך את ערכת הצבעים שלך (ראה FvwmTheme). FvwmScript-Date מאפשר לך להגדיר תאריך ו
זְמַן. FvwmScript-FileBrowser הוא דפדפן קבצים המשמש את הסקריפטים האחרים. FvwmScript-
מצא הוא קצה קדמי בסיסי לחיפוש. FvwmScript-Quit מאפשר לאדם לצאת מ-fvwm, להפעיל מחדש
fvwm או מנהל חלונות אחר, או כבה והפעל מחדש את המחשב. FvwmScript-
ScreenDump הוא דומפר מסך. FvwmScript-WidgetDemo הוא סקריפט דוגמה טהור. ראה את
הסעיף הבא עבור FvwmScript-ComExample.

A תקשורת נוהל

FvwmScript היא שפת תכנות חלשה (אך פשוטה). אם אתה צריך להתמודד עם הרבה
נתונים ו/או שאתה צריך להשתמש באלגוריתמים מורכבים עליך להשתמש בתוכנית חיצונית (ב-perl
למשל) ו"שלח" את המידע הרצוי לסקריפט FvwmScript שלך. הראשון
הגישה היא להשתמש בפונקציה GetOutput. זה פשוט אבל אתה צריך להפעיל מחדש את שלך
תוכנית חיצונית בכל פעם שאתה צריך מידע ממנה (וזה עלול לגרום לביצועים
בעיות). הגישה השנייה היא להשתמש בפונקציה SendMsgAndGet שמתרחבת
FvwmScript באמצעות כל שפת תכנות שיכולה להתמודד עם צינורות בעלי שם (fifos). אָנוּ
תאר פתרון זה בסעיף זה. (גישה שלישית היא להשתמש ב-fvwm-themes-com מ
חבילת fvwm-themes, אך למעשה שיטת SendMsgAndGet היא יישום של
fvwm-themes-com בתוך FvwmScript וזה נותן ביצועים טובים יותר).

בעצם, אתה מתחיל תוכנית "חיצונית" (התוכנית בקיצור) מה-FvwmScript שלך
תסריט (התסריט בקיצור). תוכנית זו פועלת ברקע ואתה משתמש ב-
הפונקציה SendMsgAndGet בסקריפט שלך כדי לשאול שאלות או לתת הוראות ל-
תכנית. על התוכנית לכבד בקפדנות פרוטוקול תקשורת מסוים. ראשון מ
כל מה שיש מזהה comId עבור התקשורת, הוא צריך להכיל את מזהה התהליך
של הסקריפט ליישום טוב של הפרוטוקול (השתמש בפונקציה GetPid ועבור
מה היא comId דרך אפשרות לתוכנית). הפרוטוקול משתמש בשני fifos, במשתמש fvwm
ספרייה, בשם: .tmp-com-in-comId ו-.tmp-com-out-comId. התוכנית צריכה ליצור ו
האזינו ב-.tmp-com-in-comId fifo. לאחר מכן, כאשר FvwmScript מבצע פונקציה של
טופס:

הגדר $answer = (SendMsgAndGet {comId} {cmd} bool)

FvwmScript כותב את cmd על הפיפו הזה. בדרך זו התוכנית יכולה לקרוא את cmd ויכול
בצע את הפעולה המתאימה (זה צריך להסיר את ה- in fifo כדי לתמוך בריבוי
תקשורת). אם bool הוא 0, FvwmScript לא ממתין לתשובה מהתוכנית ו
החזר 1 אם הפעולות הקודמות יצליחו ו-0 אם הן נכשלו (אז התוכנית צריכה ללכת
חזרה" ל- in fifo). אם bool הוא 1, ואז FvwmScript ממתין (20 שניות) לתשובה מ
התוכנית ומחזירה בתורה את התשובה לתסריט (שים לב bool לא מועבר ל
התוכנית כפי שהיא חייבת לדעת אילו פקודות זקוקות לתשובה). כדי לענות, התוכנית יוצרת
ה-.tmp-com-out-comId fifo וכותב עליו את התשובה. התוכנית צריכה לחכות עד
FvwmScript קורא את התשובה ואז הוא אמור להסיר את ה-out fifo ולחזור ל-in
fifo. התשובה צריכה להיות מורכבת משורה אחת של לא יותר מ-32000 תווים (תסתכל
בפונקציה Parse לטיפול במספר שורות כשורה אחת).

דרך פשוטה להבין את הפרוטוקול הזה ולכתוב סקריפטים ותוכניות המשתמשות בו היא
כדי להסתכל על הדוגמה (הלא שימושית) FvwmScript-ComExample ו-fvwm-script-
ComExample.pl (שניתן למצוא בספריית הנתונים fvwm). יתר על כן, יישום זה
של הפרוטוקול פותר שאלות כמו: מה לעשות אם הסקריפט יוצא מסיבה לא טובה?
מה לעשות אם התוכנית יוצאת מסיבה לא טובה? ...וכו.

השתמש ב-FvwmScript באופן מקוון באמצעות שירותי onworks.net