תיבת הרשימה היא פקד המכיל רשימה של פריטים. בפקד תיבת הרשימה משתמשים כאשר רוצים להציג רשימה של פריטים למשתמש, למשל רשימת פירות אפשריים להכנת סלט פירות, ולעשות על פריטים אלו פעולות שונות. המשתמש יכול ללחוץ על תיבת הרשימה ולבחור פריט אחד או יותר. על הפריטים הנבחרים ניתן לבצע פעולות וחישובים שונים, למשל את עלותו של סלט הפירות שבחרנו.
לפקד מספר מאפיינים, שיטות ואירועים אופיניים:
שם | ערכים | תיאור |
List(integer) | מיוחד | מאפיין זה מחזיר את רשימת הערכים. זהו מערך או רשימה של מחרוזות |
ListCount | מספר שלם | מחזיר את כמות הערכים ברשימה |
ListIndex | מספר שלם | מחזיר את מספרו של הערך אשר סומן אחרון ברשימה |
NewIndex | מספר שלם | מחזיר את מספרו של הערך האחרון שנוסף לרשימה |
MultiSelect | 0,1,2 | קובע עם המשתמש יכול לבחור
מהרשימה פריט אחד או יותר: |
SelCount | מספר שלם | מחזיר את כמות הפריטים שסומנו |
Selected(integer) | אמת או שקר |
מגדיר אם פריט מסוים (אשר נמצא במקום integer) מסומן (True) או אינו מסומן (False). |
Sorted | אמת או שקר |
מגדיר אם הרשימה ממוינת (True) או לא. |
Style | 0,1 | מגדיר את סגנון תיבת הרשימה. |
שיטות:
שם | תיאור |
AddItem(string,integer) |
מוסיף לרשימה את המחרוזת String במיקום .integer |
Clear | מרוקן את הרשימה מערכים שהוכנסו אליה. |
RemoveItem (integer) |
מסיר מהרשימה את הפריט שבמיקום .integer |
אירועים:
שם | תיאור |
Click |
קורה בעת הקלקה על העכבר. האירוע יתרחש רק אחרי שהמשתמש בחר ערך מהרשימה. |
ItemCheck |
קורה אם מוגדרת רשימה בסגנון ,CheckBox ונלחצת אחת מתיבות הסימון. |
Scroll |
קורה כאשר התיבה הרשימה נגללת כלפי אחד הכיוונים. |