عناصر التحكم (مرجع واجهة برمجة تطبيقات العميل)

في التطبيقات المستندة إلى النموذج، يمثل عنصر التحكم عنصر HTML في النموذج. ترتبط بعض عناصر التحكم بعمود معين، بينما تمثل عناصر تحكم أخرى غير منضمة مثل IFRAME أو مورد ويب أو الشبكة الفرعية المضافة إلى النموذج.

يوفر عنصر التحكم أساليب لتغيير العرض التقديمي أو سلوك عنصر التحكم وتحديد العمود المقابل. عناصر التحكم بالوصول باستخدام إحدى المجموعات التالية:

  • formContext.ui.controls
  • formContext.ui Section.controls
  • formContext.data.entityAttribute.controls

formContext. أسلوب getControl هو أسلوب اختصار للوصول إلى formContext.ui.controls.get.

إشعار

عند تنفيذ إجراءات على عناصر التحكم المرتبطة بعمود، ضع في اعتبارك أن عنصر التحكم قد يظهر على الصفحة أكثر من مرة. بشكل عام، يجب تنفيذ نفس الإجراءات لكل عنصر تحكم للعمود. يمكنك تكرار مجموعة عناصر تحكم العمود وتنفيذ الإجراءات على كل عنصر تحكم.

يتم تصنيف عناصر التحكم حسب النوع. استخدم أسلوب getControlType لتحديد نوع عنصر التحكم. تتوفر بعض أساليب التحكم فقط للأنوع المحددة من عناصر التحكم.

توفر هذه المقالة معلومات حول الأساليب المتوفرة لكل نوع من أنواع عناصر التحكم.

نوع عنصر التحكم القياسي

تتوفر هذه الأساليب لعنصر تحكم قياسي.

الطريقة Description
إضافة تعليق عرض إشعار خطأ أو توصية بإجراءات اختيارية.
clearNotification إزالة إعلام من عنصر التحكم.
getAttribute إرجاع العمود الذي يرتبط به عنصر التحكم.
getControlType إرجاع نوع عنصر التحكم.
getDisabled إرجاع ما إذا كان عنصر التحكم معطلا.
getLabel إرجاع تسمية عنصر التحكم.
getName إرجاع اسم عنصر التحكم.
getOutputs إرجاع قاموس لخصائص إخراج عنصر التحكم.
getParent إرجاع المقطع الذي يحتوي على عنصر التحكم.
getVisible إرجاع ما إذا كان عنصر التحكم مرئيا أم لا.
setDisabled تمكين عنصر التحكم أو تعطيله.
setFocus نقل التركيز إلى عنصر التحكم.
setLabel تغيير تسمية عنصر التحكم.
setNotification يعرض رسالة خطأ للإشارة إلى أن البيانات غير صالحة.
setVisible إظهار عنصر التحكم أو إخفاؤه.

يتم إهمال الطرق التالية لعنصر التحكم القياسي: addOnKeyPressوfireOnKeyPress و removeOnKeyPress.

نوع عنصر تحكم IFRAME

تتوفر هذه الأساليب لعنصر تحكم IFRAME.

الطريقة Description
getContentWindow إرجاع نافذة المحتوى الخاصة ب IFRAME أو مورد الويب.
getControlType إرجاع نوع عنصر التحكم.
getDisabled إرجاع ما إذا كان عنصر التحكم معطلا.
getInitialUrl إرجاع عنوان URL الافتراضي الذي تم تكوينه ل IFRAME.
getLabel إرجاع تسمية عنصر التحكم.
getName إرجاع اسم عنصر التحكم.
getObject إرجاع كائن النموذج الذي يمثل IFRAME أو مورد الويب.
getParent إرجاع المقطع الذي يحتوي على عنصر التحكم.
getSrc إرجاع عنوان URL المعروض حاليا في IFRAME أو مورد الويب.
getVisible إرجاع ما إذا كان عنصر التحكم مرئيا أم لا.
setDisabled تمكين عنصر التحكم أو تعطيله.
setFocus نقل التركيز إلى عنصر التحكم.
setLabel تغيير تسمية عنصر التحكم.
setSrc تعيين عنوان URL لعرضه في IFRAME أو مورد الويب.
setVisible إظهار عنصر التحكم أو إخفاؤه.

نوع عنصر التحكم Kbsearch (البحث في قاعدة المعارف)

تتوفر هذه الأساليب للتحكم في البحث في قاعدة المعارف.

الطريقة Description
addOnPostSearch إضافة معالج أحداث يتم تشغيله بعد اكتمال البحث.
addOnResultOpened إضافة معالج أحداث يتم تشغيله عند فتح نتيجة بحث.
إضافةOnSelection إضافة معالج أحداث يتم تشغيله عند تحديد نتيجة بحث.
getControlType إرجاع نوع عنصر التحكم.
getDisabled إرجاع ما إذا كان عنصر التحكم معطلا.
getLabel إرجاع تسمية عنصر التحكم.
getName إرجاع اسم عنصر التحكم.
getParent إرجاع المقطع الذي يحتوي على عنصر التحكم.
getSearchQuery إرجاع النص المستخدم كمعاي بحث.
getSelectedResults إرجاع نتيجة البحث المحددة حاليا.
getTotalResultCount إرجاع عدد نتائج البحث.
getVisible إرجاع ما إذا كان عنصر التحكم مرئيا أم لا.
openSearchResult فتح نتيجة بحث محددة.
إزالةOnPostSearch إزالة معالج أحداث لإكمال البحث.
removeOnResultOpened إزالة معالج أحداث لفتح نتيجة بحث.
removeOnSelection إزالة معالج أحداث لتحديد نتيجة بحث.
setFocus نقل التركيز إلى عنصر التحكم.
setLabel تغيير تسمية عنصر التحكم.
setSearchQuery تعيين النص المستخدم كمعاي بحث.
setVisible إظهار عنصر التحكم أو إخفاؤه.

إشعار

عند إضافة عنصر تحكم البحث في قاعدة المعارف إلى الجزء الاجتماعي، يكون اسم عنصر التحكم هو searchwidgetcontrol_notescontrol. لا يمكنك تغيير هذا الاسم.

نوع عنصر تحكم البحث

تتوفر هذه الأساليب لعنصر تحكم البحث.

الطريقة Description
addCustomFilter إضافة عامل تصفية إلى نتائج البحث، جنبا إلى جنب مع عوامل التصفية الموجودة باستخدام AND.
addCustomView إضافة طريقة عرض إلى مربع حوار البحث.
إضافة تعليق عرض إشعار خطأ أو توصية بإجراءات اختيارية.
addOnLookupTagClick إضافة معالج أحداث يتم تشغيله عند النقر فوق علامة بحث.
addPreSearch إضافة معالج أحداث يتم تشغيله قبل البحث.
clearNotification إزالة إعلام من عنصر التحكم.
getAttribute إرجاع العمود الذي يرتبط به عنصر التحكم.
getControlType إرجاع نوع عنصر التحكم.
getDefaultView إرجاع معرف طريقة عرض البحث الافتراضية.
getDisabled إرجاع ما إذا كان عنصر التحكم معطلا.
أنواع getEntity إرجاع أنواع الجداول المسموح بها في البحث.
getLabel إرجاع تسمية عنصر التحكم.
getName إرجاع اسم عنصر التحكم.
getParent إرجاع المقطع الذي يحتوي على عنصر التحكم.
getVisible إرجاع ما إذا كان عنصر التحكم مرئيا أم لا.
removeOnLookupTagClick إزالة معالج أحداث للنقر فوق علامة البحث.
إزالة البحث إزالة معالج أحداث يتم تشغيله قبل البحث.
setDefaultView تعيين طريقة العرض الافتراضية في مربع حوار البحث.
setDisabled تمكين عنصر التحكم أو تعطيله.
setEntityTypes تعيين أنواع الجداول المسموح بها في البحث.
setFocus نقل التركيز إلى عنصر التحكم.
setLabel تغيير تسمية عنصر التحكم.
setNotification يعرض رسالة خطأ للإشارة إلى أن البيانات غير صالحة.
setVisible إظهار عنصر التحكم أو إخفاؤه.

الاختيارات وأنواع عناصر التحكم في الاختيار

الاختيارات وعناصر التحكم في الاختيار لها نفس مجموعة الأساليب المتاحة.

الطريقة Description
إضافة تعليق عرض إشعار خطأ أو توصية بإجراءات اختيارية.
إضافة خيارات إضافة خيار إلى عنصر التحكم.
clearNotification إزالة إعلام من عنصر التحكم.
clearOptions إزالة كافة الخيارات من عنصر التحكم.
getAttribute إرجاع العمود الذي يرتبط به عنصر التحكم.
getControlType إرجاع نوع عنصر التحكم.
getDisabled إرجاع ما إذا كان عنصر التحكم معطلا.
getLabel إرجاع تسمية عنصر التحكم.
getName إرجاع اسم عنصر التحكم.
getOptions إرجاع الخيارات المتوفرة، بما في ذلك الخيار الفارغ واستبعاد الخيارات التي تمت إزالتها.
getParent إرجاع المقطع الذي يحتوي على عنصر التحكم.
getVisible إرجاع ما إذا كان عنصر التحكم مرئيا أم لا.
إزالة الاكتظاظ إزالة خيار من عنصر التحكم.
setDisabled تمكين عنصر التحكم أو تعطيله.
setFocus نقل التركيز إلى عنصر التحكم.
setLabel تغيير تسمية عنصر التحكم.
setNotification يعرض رسالة خطأ للإشارة إلى أن البيانات غير صالحة.
setVisible إظهار عنصر التحكم أو إخفاؤه.

نوع عنصر تحكم النموذج السريع

راجع formContext.ui.quickForms للحصول على معلومات حول الأساليب المعتمدة لنوع عنصر التحكم هذا.

نوع عنصر تحكم الشبكة الفرعية

راجع الشبكات والشبكة الفرعية للحصول على معلومات حول الأساليب المعتمدة لنوع عنصر التحكم هذا.

نوع التحكم في جدار المخطط الزمني

يعرض عنصر تحكم المخطط الزمني المنشورات والأنشطة والملاحظات في طريقة عرض موحدة. تتوفر هذه الأساليب لنوع عنصر التحكم هذا.

الطريقة Description
getControlType إرجاع نوع عنصر التحكم.
getDisabled إرجاع ما إذا كان عنصر التحكم معطلا.
getLabel إرجاع تسمية عنصر التحكم.
getName إرجاع اسم عنصر التحكم.
getParent إرجاع المقطع الذي يحتوي على عنصر التحكم.
getVisible إرجاع ما إذا كان عنصر التحكم مرئيا أم لا.
تحديث تحديث البيانات المعروضة في المخطط الزمني.
setDisabled تمكين عنصر التحكم أو تعطيله.
setFocus نقل التركيز إلى عنصر التحكم.
setLabel تغيير تسمية عنصر التحكم.
setVisible إظهار عنصر التحكم أو إخفاؤه.

نوع عنصر تحكم المؤقت

تتوفر هذه الأساليب لعنصر تحكم المؤقت.

الطريقة Description
getControlType إرجاع نوع عنصر التحكم.
getDisabled إرجاع ما إذا كان عنصر التحكم معطلا.
getLabel إرجاع تسمية عنصر التحكم.
getName إرجاع اسم عنصر التحكم.
getParent إرجاع المقطع الذي يحتوي على عنصر التحكم.
getState إرجاع الحالة الحالية للموقت.
getVisible إرجاع ما إذا كان عنصر التحكم مرئيا أم لا.
تحديث تحديث البيانات المعروضة في المؤقت.
setDisabled تمكين عنصر التحكم أو تعطيله.
setFocus نقل التركيز إلى عنصر التحكم.
setLabel تغيير تسمية عنصر التحكم.
setVisible إظهار عنصر التحكم أو إخفاؤه.

نوع التحكم في موارد الويب

يحتوي عنصر تحكم مورد الويب على نفس مجموعة الأساليب المتوفرة كعنصر تحكم iframe. راجع نوع عنصر التحكم iframe.

نوع عنصر تحكم مكون النموذج

يحتوي نوع عنصر تحكم مكون النموذج على نفس مجموعة الأساليب المتوفرة مثل formContext في نموذج رئيسي. راجع واجهة برمجة تطبيقات العميل لسلوك > مكون النموذج.

الاعمده