تعديل صناديق الأدوات

يمكن للتطبيق تغيير الكتل المتاحة في صندوق الأدوات في أي وقت باستخدام طلب دالة واحدة:

workspace.updateToolbox(newTree);

كما هو الحال أثناء الإعداد الأولي، يمكن أن يكون newTree إما شجرة من العقد أو تمثيلًا لسلاسل أو عنصر JSON. التقييد الوحيد هو أنّه لا يمكن تغيير الوضع، أي إذا كانت هناك فئات في صندوق الأدوات الذي تم تحديده في البداية، يجب أن يحتوي صندوق الأدوات الجديد أيضًا على فئات (على الرغم من أنّ الفئات قد تتغيّر). وبالمثل، إذا لم تتضمّن مجموعة الأدوات المحدّدة في البداية أي فئات، قد لا تتضمّن مجموعة الأدوات الجديدة أي فئات.

يمكن تعديل محتوى فئة واحدة من خلال:

var category = workspace.getToolbox().getToolboxItems()[0];
category.updateFlyoutContents(flyoutContents);

حيث يمكن أن يكون flyoutContents قائمة بالكتل المحدّدة باستخدام تنسيق JSON أو شجرة للعقد أو تمثيل سلسلة.

يُرجى العِلم أنّ تحديث صندوق الأدوات يؤدي في الوقت الحالي إلى إعادة ضبط بعض الإعدادات البسيطة في واجهة المستخدم:

• في صندوق أدوات بدون فئات، سيتمّ الرجوع إلى الإعدادات التلقائية لأيّ حقول يغيّرها المستخدم (مثل قائمة منسدلة).

في ما يلي عرض توضيحي مباشر لشجرة تتضمّن فئات ومجموعات مجموعات.