معلومات

نظرة عامة على مربع التحرير والسرد

نظرة عامة على مربع التحرير والسرد

تقوم فئة ComboBox بإنشاء عنصر تحكم يتيح للمستخدم تحديد خيار من قائمة الخيارات المنسدلة. تظهر القائمة المنسدلة عندما ينقر المستخدم على عنصر التحكم مربع تحرير وسرد. عندما يتجاوز عدد الخيارات حجم النافذة المنسدلة ، يمكن للمستخدم الانتقال لأسفل إلى خيارات أخرى. هذا يختلف عن ChoiceBox الذي يستخدم بشكل أساسي عندما يكون عدد الخيارات عبارة عن مجموعة صغيرة نسبيًا.

بيان الاستيراد

javafx.scene.control.ComboBox

الصانعين

تحتوي فئة ComboBox على مُنشئين بناءً على ما إذا كنت ترغب في إنشاء كائن ComboBox فارغ أو واحد ممتلئ بالعناصر.

لإنشاء مربع تحرير وسرد فارغ

ComboBox الفاكهة = ComboBox () جديدة ؛

لإنشاء كائن ComboBox ونشره بعناصر سلسلة من قائمة ObservableList

الفواكه التي يمكن ملاحظتها = FXCollections.observableArrayList (
"Apple" ، "Banana" ، "Pear" ، "Strawberry" ، "Peach" ، "Orange" ، "Plum") ؛
فاكهة السرد (ComboBox) = فاكهة السرد (ComboBox)

طرق مفيدة

إذا قمت بإنشاء كائن ComboBox فارغ ، يمكنك استخدام طريقة setItems. سيؤدي تمرير ObservableList للكائنات إلى تعيين العناصر الموجودة في Combobox.

الفواكه التي يمكن ملاحظتها = FXCollections.observableArrayList (
"Apple" ، "Banana" ، "Pear" ، "Strawberry" ، "Peach" ، "Orange" ، "Plum") ؛
fruit.setItems (ثمار)؛

إذا كنت ترغب في إضافة عناصر إلى قائمة ComboBox لاحقًا ، يمكنك استخدام طريقة addAll للأسلوب getItems. سيؤدي ذلك إلى إلحاق العناصر بنهاية قائمة الخيارات:

fruit.getItems (). addAll ("Melon"، "Cherry"، "Blackberry")؛

لإضافة خيار إلى مكان معين في قائمة خيارات ComboBox ، استخدم طريقة الإضافة لأسلوب getItems. تأخذ هذه الطريقة قيمة الفهرس والقيمة التي ترغب في إضافتها:

fruit.getItems (). add (1، "Lemon")؛

ملحوظة: تبدأ قيم فهرس ComboBox في 0. على سبيل المثال ، سيتم إدراج القيمة أعلاه "Lemon" أعلاه في قائمة خيار ComboBox في الموضع 2 حيث أن المؤشر الذي تم تمريره هو 1.

لتحديد خيار مسبق في قائمة خيارات ComboBox ، استخدم طريقة setValue:

fruit.setValue ( "الكرز")؛

إذا لم تكن القيمة التي تم تمريرها إلى طريقة setValue في القائمة ، فستظل القيمة محددة. ومع ذلك ، هذا لا يعني أنه تمت إضافة هذه القيمة إلى القائمة. إذا اختار المستخدم لاحقًا قيمة أخرى ، فلن تكون القيمة الأولية في القائمة التي سيتم تحديدها.

للحصول على قيمة العنصر المحدد حاليًا في مربع التحرير والسرد ، استخدم طريقة getItems:

السلسلة المحددة = fruit.getValue (). toString ()؛

نصائح الاستخدام

عدد الخيارات التي يتم تقديمها عادةً من خلال القائمة المنسدلة ComboBox هو عشرة (ما لم يكن هناك أقل من عشرة عناصر في هذه الحالة ، يتم تعيين عدد العناصر في هذه الحالة افتراضيًا). يمكن تغيير هذا الرقم باستخدام طريقة setVisibleRowCount:

fruit.setVisibleRowCount (25)؛

مرة أخرى ، إذا كان عدد العناصر في القائمة أقل من القيمة المعينة في طريقة setVisibleRowCount ، فسيقوم مربع التحرير والسرد افتراضيًا بعرض عدد العناصر في القائمة المنسدلة ComboBox.

التعامل مع الأحداث

لتتبع تحديد العناصر الموجودة على كائن ComboBox ، يمكنك استخدام أسلوب addListener للأسلوب المحددإيتيمبروبيرتي في SelectionModel لإنشاء ChangeListener وسوف يلتقط أحداث التغيير لـ ComboBox:

final Label selectLabel = new Label ()؛
fruit.getSelectionModel (). selectedItemProperty (). addListener (
ChangeListener () {
تم تغيير الفراغ العام (ObservableValue ov ،
سلسلة old_val ، سلسلة new_val) {
selectionLabel.setText (new_val)؛
}
});


شاهد الفيديو: أداة مربع التحرير و السرد (أغسطس 2021).