[מדריך] בניית דיאלוג

[Zen-]

נכתב על ידי shaharacli לאתר מירקס הישן

מהו בכלל דיאלוג?
דיאלוג הוא דו-שיח, במקרה שלנו, זה דו-שיח בין המחשב לבין הגולש.
המחשב מקפיץ מין דיאלוג (שאפשר להגיע לעיצובים מהממים) לשם נתינת מידע לגולש, והגולש יוכל להזין בתוך הדיאלוג דברים שבוני הסקריפטים רוצים לקבל, מה לקבל? זה יהיו השיקולים שלכם!.

אז ככה, מה יהיה במדריך?

במדריכנו נלמד כל פרט ופרט בדיאלוג - איך בונים אותו, ובמדריך השני איך להפעיל את הדיאלוג.

או קיי, קודם כל, שתדעו, את הדיאלוג שלנו אנחנו בונים בתוך הרימוט (alt+r)

כל דיאלוג נכתב כך-

קוד: בחר הכל

dialog NAME {
'אביזרים בדיאלוג'
}

אין כאן כלום, זה דיאלוג ריק, אפילו לא קבענו לו גודל, לכן אין טעם לפתוח אותו
אם אתם בכל זאת רוצים לנסות לפתוח, דיאלוג פותחים כך -

קוד: בחר הכל

/dialog -m NAME NAME


הסברים מורחבים על הפקודה dialog/ ייכתבו במדריך השני.

אז נתחיל, את פריטי הדיאלוג כותבים כמובן בין הסוגריים המסולסולת.

פרט מספר אחד, הכרחי בכל דיאלוג, גודל.
הגודל נכתב כך-

קוד: בחר הכל

size x y w h

במקום הX נכתוב מספר, בו אנו רוצים שהדיאלוג יתחיל מהפינה השמאלית העליונה של המסך לכיוון ימין - כמות הפיקסלים מהתחלת המסך
y הוא מספר הפיקסלים מהפינה השמאלית העליונה כלפי מטה.
כעת נדמיין במוחנו שני קוים היוצאים מהנקודות שקבענו ב- X ו- Y ואיפה שהם ייפגשו, שם יתחיל הדיאלוג שלנו.

אם אין לכם כח לזה, פשוט תעשו 1- ו- 1- ואז הדיאלוג יחל מהאמצע של המסך
w - הרוחב של הדיאלוג
h - הגובה של הדיאלוג.

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

קוד: בחר הכל

icon file


במקום ה- file כותבים את מיקומו של האיקון על המחשב.

פרט מספר 3, כותרת.
אם אתם רוצים לקבוע בעצמכם את הכותרת (הקו הכחול למעלה) יש לעשות

קוד: בחר הכל

title text


במקום ה- text פשוט כיתבו את הטקסט שיכיל הכותרת.

פרט מספר 4, טקסט.
להוספת טקסט בדיאלוג עושים-

קוד: בחר הכל

text "yourtext",id,x y w h,style(right,center,nowrap,tab)


במקום הyourtext אנו נכניס את הטקסט שלנו.
עכשיו יש את ה- ID.
מהו ה-ID (ניתקל בו בכל פריט בדיאלוג)
לכל פריט בדיאלוג ניתן מספר, המספר הזה יעזור לנו בכדי לקבל מידע מאותו פריט, מה יש בו או במקרה של כפתור רדיו אם הוא מסומן, או הרבה דברים אחרים.
x,y,w,h - גודלו של הטקסט, מאיפה הוא יתחיל, איפה הוא יגמר - אותם תכונות כמו הגודל של הדיאלוג.
סגנונות:
right - ישור הטקסט לימין ( עוזר לבעלי סקריפטים בעברית)
center - מרכוז הטקסט
nowrap - לא יימנע מהטקסט להחתך
tab - באיזה טאב ייכתב הטקסט, נרחיב על נושא הטאבים בהמשך.
הסיגנונות אינם הכרחיים.

פריט מספר 5, EDIT.
בעזרת פריט זה נוכל לקבל טקסט שמשתמש הסקריפט יכניס.

קוד: בחר הכל

edit "text",id,x y w h,style(right,center,multi,pass,read,return,hsbar,vsbar,autohs,autovs,limitN)


אוקי, במקום ה- "text" נכתוב שם את הטקסט שאנחנו רוצים שיהיה מראש התוך התיבה. אם אתם לא רוצים טקסט, פשוט עישו ""
ID - כמו מקודם, ביחרו מספר.
X Y W H הגודל של הפריט.
סגנונות (כפי ששמתם לב די הרבה)
right - הטקסט יהיה מימין.
CENTER - הטקסט יהיה ממורכז.
multi - בתיבה שלנו יהיה לנו אפשרות לרדת שורה, זה במקרה ויש לנו תיבה די גדולה מבחינת הגובה.
pass - יגרום לטקסט להופיע כסיסמא (בכוכביות). למנוע מהסובבים אותנו לצפות בטקסט (במידה ונבקש סיסמא כלשהי).
read - ייצור תיבה שיהיה אפשר רק לקרוא ממנה.
hsbar - מוסיף פס גלילה מאונך ומתחת התיבה.
vsbar - מוסיף פס גלילה מאוזן לתיבה.
autohs - במידה והשורת ה-EDIT קטנה מידי ויש לגולש הרבה טקסט להכניס אז תהיה לו אפשרות להמשיך לכתוב גם אם הגודל קטן.
autovs - יהיה אפשר להמשיך ולכתוב במאוזן.
ההבדל מ-multi הוא שבמולטי אפשר לרדת שורות.

פריט מספר 6, כפתור.
בדיאלוגים נצטרך כפתורים, אם זה להוסיף לרשימות דברים או סתם כפתורים ליופי.
הכפתור נכתב כך -

קוד: בחר הכל

button "text",id,x y w h,style(default,ok,cancel,flat,multi)


במקום ה- "text" נכתוב את הטקסט שאנו רוצים שיהיה כתוב על הכפתור.
id - המספר של הפריט
x y w h - גודל הפריט
סגנונות
ok - יהיה כפתור האישור וגם יסגור את הדיאלוג.
cancel - יהיה כפתור הביטול וגם יסגור את הדיאלוג.
flat - הכפתור יהיה שטוח.
default - יהיה הכפתור ה'ראשי', בלחיצה על מקש ה-ENTER יהיה כאילו נלחץ הכפתור שבו כתבנו בסגנון את ה- default.

פריט מספר 7, צ'אקבוקס.
בעזרת הצ'אקבוקס נוכל לתת למשתמש אפשרויות בחירה.
נכתוב כך

קוד: בחר הכל

check "text",id, x y w h,style(left,push,3state)


"text" - הטקסט שייכתב ליד התיבת סימון
id - המספר של הפריט
x y w h - הגודל
left - יגרום לתיבה להיות בצד ימין והטקסט יהיה בצד שמאל.
push - יהיה כמעין כפתור אבל לא המאפיינים של הכפתור.
3state - יהיו לה שלוש מצבים - נעולה, מסומנת ולא מסומנת.
tab - באיזה טאב התיבה תהיה

פריט מספר 8, כפתור רדיו.
נוכל לעשות בדיאלוג שלנו מספר כפתורי רדיו, שיהיה למשתמש בחירה בין כמה דברים.
הרדיו נכתב כך -
radio "text",id,x y w h, style(left,push,tab,group)
"text" - הטקסט שיהיה ליד הכפתור
push - הכפתור רדיו יהיה כמעין כפתור רגיל.
tab -יהיה בטאב שסומן.
group - עושה את כל הכפתורי רדיו שמתחת לאותו כפתור רדיו (בכתיבת הסקריפט) מסויים כקבוצה אחת - יהיה אפשר לבחור רק באחד מכל הקבוצה הזו.
אם אנחנו רוצים ליצור שתי קבוצות נעשה בכפתור רדיו אחר group (שממנו כמובן מתחילה הקבוצה השניה)

פריט מספר 9, קופסה.
הקופסה היא רק בשביל היופי של הדיאלוג, היא לא תיתן לנו אפשרות לקבל מידע מהמשתמש או משהו כזה.
זה בסך הכל מעין קו מקיף את השטח שסימנו לו

קוד: בחר הכל

box "text",id,x y w h


"text" - הטקסט שיופיע לצד ה-box
id - מספר הפריט
x y w h - הגודל

פריט מספר 10, פס גלילה.
נוכל להוסיף פס גלילה משלנו לדיאלוג.

קוד: בחר הכל

scroll "text",id,x y w h, style(top left bottom right range N N)


"text" - הטקסט שיופיע ליד הפס.
id - מיספור הפריט
x y w h - גודל הפריט
סגנונות
top - יהיה בחלק העליון של השטח שהגדרנו לו
left - יהיה משמאל לחלק שהגדרנו לו
bottom - יהיה בחלק התחתון לשטח שהגדרנו לו
right - יהיה מימין לשטח שהגדרנו לו
range N N - מכמה עד כמה יוכל המשתמש לגלול.

פריט מספר 11, רשימה.
לרשימה נוכל להוסיף ולמחוק פרטים.

קוד: בחר הכל

list id,x y w h,style(sort,extsel,vsbar,hsbar)


id - מספר הפריט
x y w h - גודל הפריט
סגנונות
sort - מסדר את הפריטים ברשימה לפי סדר אלפביתי.
extsel - יהיה לנו אפשרות לבחור יותר פריטים
vsbar - יצור לנו פס גלילה מאוזן לרשימה.
hsbar - יצור לנו פס גלילה מאונך לרשימה.

פריט מספר 12, קומבו.
תיבת הקומבו היא מעין שיתוף של האדיט ושל הרשימה.

קוד: בחר הכל

combo id,x y w h,style (sort,drop,vsbar,hsbar)


id - מספור הפריט.
x y w h - גודל הפריט
סגנונות
sort - יהיה סידור בפרטים.
drop - בלחיצה ייפתח תפריט ובו כל הפריטים.
vsbar - פס גלילה מאוזן
hsbar - פס גלילה מאונך

פריט מספר 13, תמונה.
ניתן להציב תמונה בדיאלוג.

קוד: בחר הכל

icon id,x y w h,filename, style(noborder top left bottom right)


שימו לב, זה לא כמו האיקון של הדיאלוג שכן כאן אנו צריכים להוסיף ID

filename - המיקום של הקובץ במחשב שלנו.
noborder - לאיקון לא יהיה בורדר (קו מפריד) מסביב
top - האיקון יהיה למעלה.
left - האיקון יהיה בצדשמאל.
bottom - האיקון יהיה למטה.
right - האיקון יהיה מצד ימין.

פריט מספר 14, לינק.
בעזרת פריט זה נוכל לתת קישור שאליו יובל המשתמש בלחיצה על הלינק.
link "text",id,x y w h
"text" - הטקסט (הכתובת)
id - מספור הפריט
x y w h - הגודל.

פריט מספר 14, תפריט.
הסתכלו בדפדפן שלכם מצד שמאל למעלה (אם אתם בעברית אז ימין למעלה)
אתם רואים כזה תפריט.
כדי לעשות תפריט ממש כזה צריך לעשות קודם כל לפתוח תפריט ככה-

קוד: בחר הכל

menu "text",menuid


במקום ה"TEXT" לכתוב את הטקסט ובמקום ה menuid לכתוב את המספור הפריט (כאן זה ממש חשוב המספור)
כעת, כדי ליצור תת תפריט אנחנו צריכים לעשות

קוד: בחר הכל

item "text",id,menuid


במקום ה- "text" כותבים את הטקסט שיהיה רשום.
במקום ה- id את האי די של הפריט.
ובמקום ה- menuid אנו צריכים לכתוב את הid של התפריט אליו אנו רוצים להשתייך.
דוגמא לתפריט

קוד: בחר הכל

  menu "Item1", 1
  item "Item2", 2, 1
  item "Item3", 3, 1
  menu "Item4", 4
  item "Item5", 5, 4

סגנונות לכל הפריטים
בנוסף לסגנונות שקיימים כבר בפריטים שכתבנו, לכל פריט אנו יכולים להוסיף עוד סגנונות
disable - יגרום לפריט להיות בלתי עריך, נראה כזה יותר אפור-לבן.
hide - הפריט יהיה מוחבא מפני המשתמש
ניתן גם להוסיף אחרי הפריט שלנו משתנה מסויים - רצוי תיבת אדיט, מה שיהיה כתוב בתוך התיבה בעת סגירת הדיאלוג יישמר בתוך המשתנה
דוגמא

קוד: בחר הכל

edit "",2 10 10 100 20,auths %shaharvar


tab - נכתוב את מספר הטאב שבו אנו רוצים להראות את הפריט
מה זה טאב?
זה מוביל אותנו לפריט מספר 15
הטאב הוא דבר נפוץ מאוד בווינדוס.
זה מעין כרטסות, שבכל כרטיסיה יש מידע אחר.
זהו הניצול המקסימלי של גודל הדיאלוג, כאילו יש לנו כמה דיאלוגים.

את הטאב הראשון נעשה כך

קוד: בחר הכל

tab "text",id, x y w h


את הטאבים שבעים אחריו נעשה

קוד: בחר הכל

tab "text",id


מכיוון שהגודל כבר מוגדר לנו.
ה-id הוא למעשה מספר הטאב

אם אנחנו רוצים לשייך פריט מסויים לטאב אז נעשה למשל

קוד: בחר הכל

text "shahartext",2,10 10 50 60,tab 4


ישייך את הטקסט "שחרטקסט" אל טאב מספר 4