המאפיין ListIndex

חל על

באפשרותך להשתמש במאפיין ListIndex כדי לקבוע איזה פריט נבחר ב- תיבת רשימה או תיבה משולבת. קריאה/כתיבה Long.

ביטוי.ListIndex

ביטוי נדרש. ביטוי שמחזיר אחד מהאובייקטים ברשימה חל על.

הערות

המאפיין ListIndex הוא מספר שלם מ- 0 עד מספר הפריטים הכולל בתיבת רשימה או בתיבה משולבת פחות 1. Microsoft Office Access 2007 מגדיר את ערך המאפיין ListIndex כאשר פריט נבחר בתיבת רשימה או בחלק תיבת רשימה של תיבה משולבת. ערך המאפיין ListIndex של הפריט הראשון ברשימה הוא 0, ערך הפריט השני הוא 1 וכן הלאה.

מאפיין זה זמין רק על-ידי שימוש ב- מאקרו או בקוד Visual Basic for Applications‏ (VBA). באפשרותך לקרוא מאפיין זה רק ב- תצוגת טופס ו- תצוגת גליון נתונים. מאפיין זה מוגדר לקריאה בלבד ואינו זמין בתצוגות אחרות.

ערך המאפיין ListIndex זמין גם על-ידי הגדרת המאפיין BoundColumn ל- 0 עבור תיבה משולבת או תיבת רשימה. אם המאפיין BoundColumn מוגדר ל- 0, שדה הטבלה המשמשת כבסיס שאליה מאוגדת התיבה המשולבת או תיבת הרשימה יכלול את אותו ערך כשל הגדרת המאפיין ListIndex.

בתיבות רשימה קיים גם מאפיין MultiSelect המאפשר למשתמש לבחור פריטים מרובים מהפקד. כאשר מתבצעות בחירות מרובות בתיבת רשימה, באפשרותך לקבוע אילו פריטים נבחרים על-ידי שימוש במאפיין נבחר של הפקד. המאפיין נבחר הוא מערך של ערכים בין 0 לערך המאפיין ListCount פחות 1. עבור כל פריט בתיבת הרשימה, המאפיין נבחר יהיה True אם הפריט נבחר ו- False אם לא נבחר.

האוסף ItemsSelected מספק גם דרך לגשת לנתונים בשורות שנבחרו של תיבת רשימה או תיבה משולבת.

דוגמה

כדי להחזיר את הערך של המאפיין ListIndex, באפשרותך להשתמש באפשרויות הבאות:

Dim l As Long
l = Forms(formname).Controls(controlname).ListIndex

כדי להגדיר את ערך המאפיין ListIndex, באפשרותך לבצע את הפעולות הבאות:

Forms(formname).Controls(controlname).SetFocus
Forms(formname).Controls(controlname).ListIndex = index

כאשר formname ו- controlname הם השמות של הטופס ופקד תיבת רשימה ותיבה משולבת, בהתאמה, מבוטאים כערכי מחרוזת, ואינדקס הוא ערך האינדקס של הפריט.