مشاركة عبر

عنصر تحكم (مخطط تعريف نوع عنصر عمل)

  • مقالة

تقوم باستخدام عنصر CONTROL لتعريف حقل أو نص أو ارتباط تشعبي أو عنصر تحكم آخر لعنصر عمل ليعرض في نموذج عنصر العمل.

هيكل المخطط

عنصر WITD (مخطط تعريف نوع عنصر العمل)

    عنصر WORKITEMTYPE (مخطط تعريف نوع عنصر العمل)

        عنصر FORM (مخطط تعريف نوع عنصر العمل)

            عنصر التخطيط (مخطط تعريف نوع عنصر العمل)

               عنصر مجموعة (مخطط تعريف نوع عنصر عمل)

               عمود REASON (مخطط تعريف نوع عنصر العمل)

               عنصر TAB (مخطط تعريف نوع عنصر العمل)

<xs:element name="Control" type="ControlType" minOccurs="0"/>

<Control FieldName="field name" Type="AttachmentsControl | DateTimeControl | FieldControl | 
HtmlFieldControl | LabelControl | LinksControl | WebpageControl | WorkItemClassificationControl | 
WorkItemLogControl" Label="label text" LabelPosition="Top | Bottom | Left | Right" 
Dock="Fill | Top | Bottom | Left | Right" Padding="(left, top, right, bottom)" 
Margin="(left, top, right, bottom)" ReadOnly="True | False" MinimumSize="(width,height)" 
Name="instance name" />

السمات والعناصر

تصف المقاطع التالية سمات، عناصر تابعة وعناصر الأصل.

السمات

السمة

الوصف

FieldName

سمة ControlType اختيارية.

تحديد حقل عنصر التحكم المقترن بالتحكم. نوع السمة هو typelib:ReferenceFieldName. الحد الأدنى للطول: 1; أقصى طول: 70.

نموذج القيمة: ^ [a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+) + $

مثال نموذج القيمة: Company.Division.IssueType

Type

سمة ControlType مطلوبة.

تحدد نوع البيانات الخاصة بعنصر التحكم. نوع السمة هو نوع بسيط ValidControlsType. تحدد سلسلة من أحد الأنواع المضمنة التالية:

  • AttachmentControl: تستخدم لعرض مرفقات عنصر العمل. عنصر التحكم هذا لا يحتوي على الحقل أو نوع الحقل المقترنين.

  • DateTimeControl: تستخدم لعرض حقول التاريخ المنسقة مع نوع حقل DateTime.

  • FieldControl: تستخدم لعرض حقول نصية أو رقمية عادية و قوائم من قيم الحقول مع نوع حقل String و Identity و Integer و Double و PlainText.

  • HtmlFieldControl:تستخدم لعرض تنسيق حقول غني متعدد الأسطر مع نوع حقل HTML.

  • LabelControl: تستخدم لعرض نص غير مقترن بحقل. يمكن أن يكون النص عادياً أو ارتباطاً تشعبياً.

  • LinksControl: تستخدم لعرض ارتباطات عنصر العمل. عنصر التحكم هذا لا يحتوي على الحقل أو نوع الحقل المقترنين.

  • WebpageControl: تستخدم لعرض محتوى يستند إلى HTML معرّفة من قِبل URI أو تضمينه داخل العلامة CDATA. عنصر التحكم هذا لا يحتوي على الحقل أو نوع الحقل المقترنين.

  • WorkItemClassificationControl تستخدم لعرض حقول المسار الهرمية مع نوع حقل TreePath.

    ملاحظةملاحظة
    System.AreaPath و System.IterationPath الحقول هى الحقول فقط التي تستخدم نوع البيانات.لا يمكن تعريف حقل مخصص باستخدام نوع البيانات.

  • WorkItemLogControl: تستخدم لعرض معلومات محفوظات عنصر العمل والحقول مع نوع حقل History.

    ملاحظةملاحظة
    System.History الحقل هو الحقل الوحيد الذي يستخدم نوع البيانات.لا يمكن تعريف حقل مخصص باستخدام نوع البيانات.

لمزيد من المعلومات، راجع عناصر تحكم النموذج عنصر العمل.

ملاحظةملاحظة
يمكنك استخدام عنصر تحكم مخصص بواسطة تعيين السمة Type لقيمة مخصصة.أي عنصر تحكم له قيمة Type لا تتطابق مع اسم نوع مضمن يعتبر عنصر تحكم مخصص.لمزيد من المعلومات، راجع موقع الويب Microsoft: تتبع عنصر العمل لعناصر تحكم مخصصة.

Label

سمة ControlType اختيارية.

تحديد النص المرئي على النموذج الذي يعرّف عنصر التحكم. تحديد سلسلة من عدد لا يتجاوز 80 حرف.

LabelPosition

سمة ControlType اختيارية.

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

  • Top: يضع التسمية فوق بيانات عنصر التحكم.

  • Bottom: يضع التسمية أسفل بيانات عنصر التحكم.

  • Left: يضع التسمية إلى يسار بيانات عنصر التحكم.

  • Right: يضع التسمية إلى يمين بيانات عنصر التحكم.

Dock

سمة ControlType اختيارية.

يحاذى الحقل إلى الجانب المحدد من الحاوية, أو يمدد الحقل لتعبئة الحاوية. نوع السمة هو DockType. حدد سلسلة من إحدى القيم التالية:

  • Fill: يقوم بمحاذاة الحقل بحيث يملأ الحاوية. هذه القيمة ليست اتجاهاً معتمداً للعنصر Splitter.

  • Top: يقوم بمحاذاة الحقل مع أعلى الحاوية. هذه القيمة ليست اتجاهاً معتمداً للعنصر Splitter.

  • Bottom: يقوم بمحاذاة الحقل مع أسفل الحاوية. هذه القيمة ليست اتجاهاً معتمداً للعنصر Splitter.

  • Left: يقوم بمحاذاة الحقل مع الجانب الأيسر من الحاوية.

  • Right: يقوم بمحاذاة الحقل مع الجانب الأيمن من الحاوية. هذه القيمة ليست اتجاهاً معتمداً للعنصر Splitter.

Padding

سمة ControlType اختيارية.

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

نموذج القيمة: ^\(\d+\,\d+\,\d+\,\d+\)$

مثال نموذج القيمة: (2,0,2,0)

Margin

سمة ControlType اختيارية.

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

نموذج القيمة: ^\(\d+\,\d+\,\d+\,\d+\)$

مثال نموذج القيمة: (2,0,2,0)

ReadOnly

سمة ControlType اختيارية.

يحدد أن الحقل للقراءة فقط. نوع السمة هو ReadOnlyType. حدد سلسلة من إحدى القيم التالية:

  • True: تحدد أن بيانات التحكم للقراءة فقط.

  • False: تحدد أن بيانات التحكم ليست للقراءة فقط.

MinimumSize

سمة ControlType اختيارية.

تحدد أدنى حجم بـالبكسل يجب أن يشغله عنصر التحكم في النموذج. بناء الجملة محدد في ( width,height). نوع السمة هو SizeType.

نموذج القيمة: ^\(\d+\,\d+\)$

مثال نموذج القيمة: (100,100)

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

Name

سمة ControlType اختيارية.

يعرّف عنصر التحكم بشكل فريد. Name مهم إذا كان هناك أكثر من عنصر تحكم مقترن مع نفس حقل عنصر العمل. نوع السمة هو xs:string.

ملاحظةملاحظة
تستخدم السمة Name عندما تريد أن يكون لديك نفس الحقل المعروض في موقع واحد أو أكثر في النموذج.تقوم بتحديد قيمة فريدة للسمة Name لكلٍ من مدخلات عنصري تحكم بحيث يعرّف النظام كل عنصر تحكم بشكل فريد.من المفيد إظهار نفس عنصر التحكم في مواقع مختلفة استناداً إلى سياق علامات التبويب.

NumberFormat

السمة ControlType الاختيارية الصالحة فقط عند استخدامها مع FieldControl.

تعين الأحرف التي يمكنك إدخالها في عنصر تحكم الحقل . القيم الصالحة التي يمكنك استخدامها هى كالآتي.

  • WholeNumbers: تحدد أن الأرقام الكاملة مسموح بها.

  • SignedWholeNumbers: تحدد أن الأرقام الكاملة الموقعة مسموح بها.

  • DecimalNumbers: تحدد الأرقام العشرية مسموح بها.

  • SignedDecimalNumbers: تحدد أن الأرقام العشرية الموقعة مسموح بها.

MaxLength

السمة ControlType الاختيارية الصالحة فقط عند استخدامها مع FieldControl.

تعيّن الحد الأقصى لطول الأحرف المسموح به لعنصر تحكم الحقل. نوع السمة هو xs:integer.

Format

السمة ControlType الاختيارية الصالحة فقط عند استخدامها مع DateTimeControl.

تحدد تنسيق حقل "التاريخ-الوقت" الذي يتوافق مع إحدى قيم التعداد DateTimePickerFormat. القيم الصالحة التي يمكنك استخدامها هى كالآتي.

  • Custom: يعرض قيمة التاريخ / الوقت في تنسيق مخصص. يمكن تعيين التنسيق المخصص عن طريق تحديد 'مخصص' كقيمة لسمة التنسيق و تعيين سمة أخرى مسماة CustomFormat كسلسلة تنسيق مخصص. فعلى سبيل المثال:

    التنسيق = "مخصص"

    MMM dd = "CustomFormat ‘من السنة‘ yyyy"

    لمزيد من المعلومات، راجع موقع الويب Microsoft: خاصية DateTimePicker.CustomFormat.

  • Long: يعرض قيمة التاريخ / الوقت في إعداد تنسيق التاريخ الطويل بواسطة نظام التشغيل الخاص بالمستخدم.

  • Short: يعرض قيمة التاريخ / الوقت في إعداد تنسيق التاريخ القصير بواسطة نظام التشغيل الخاص بالمستخدم.

  • Time: يعرض قيمة التاريخ / الوقت في إعداد تنسيق الوقت بواسطة نظام التشغيل الخاص بالمستخدم.

لمزيد من المعلومات، راجع موقع الويب Microsoft: قائمة تعداد DateTimePickerFormat.

CustomFormat

السمة ControlType الاختيارية الصالحة فقط عند استخدامها مع DateTimeControl و السمة Format.

تحدد التنسيق المخصص الخاص بحقل التاريخ - الوقت الذي يتوافق مع تعريف بناء جملة للخاصية DateTimePicker.CustomFormat. لمزيد من المعلومات، راجع موقع الويب Microsoft: خاصية DateTimePicker.CustomFormat.

العناصر التابعة

العنصر

الوصف

LabelText

عنصر اختياري. يمكنك تحديد هذا العنصر عند تحديد ControlType على أنه FieldControl أو LabelControl.

عنصر الحاوية لتحديد النص و الارتباط التشعبي والموضع لحقل أو تسمية نصها مقترن جزئياً بالارتباط التشعبي.

لمزيد من المعلومات، راجع تعيين ارتباط تشعبي من أجل الحقول أو نص صفحة ويب: عناصر معلمة والارتباط.

Link

عنصر اختياري. يمكنك تحديد هذا العنصر عند تحديد ControlType على أنه FieldControl أو LabelControl.

يعرّف الارتباط التشعبي لحقل أو تسمية.

لمزيد من المعلومات، راجع تعيين ارتباط تشعبي من أجل الحقول أو نص صفحة ويب: عناصر معلمة والارتباط.

LinksControlOptions

عنصر اختياري. يمكنك تحديد هذا العنصر عند تحديد ControlType على أنه LinksControl.

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

لمزيد من المعلومات، راجع عرض ارتباط التحكم: عناصر LinksControlOptions.

WebpageControlOptions

عنصر اختياري. يمكنك تحديد هذا العنصر عندما يكون ControlType هو WebpageControl.

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

لمزيد من المعلومات، راجع عرض محتويات ويب داخل نموذج عنصر عمل: عناصر WebpageControlOptions.

anyAttribute

عنصر اختياري.

ControlType موسعة من خلال استخدام العنصر anyAttribute. ProcessContents: skip

العناصر الأصلية

العنصر

الوصف

عنصر التخطيط (مخطط تعريف نوع عنصر العمل)

العنصر المطلوب.

يحدد كيفية عرض العناصر فى نموذج عنصر العمل.

عمود REASON (مخطط تعريف نوع عنصر العمل)

العنصر المطلوب.

يعرّف الأعمدة في النموذج.

عنصر TAB (مخطط تعريف نوع عنصر العمل)

العنصر المطلوب.

يعرّف تبويب للنموذج.

ملاحظات

Control هو عنصر اختياري تابع لـ Layout, Column و Tab.

مؤشرات Layout و Column:

"minOccurs = "0

maxOccurs) = "1"

مؤشرات Tab:

"minOccurs = "0

(بلا حد) "maxOccurs = "unbounded (الحد الأقصى للحدوث)

لتطبيق عنصر تحكم مخصص، يجب تحديد اسم عنصر التحكم للسمة Type . لمزيد من المعلومات، راجع موقع الويب Microsoft: تتبع عنصر العمل لعناصر تحكم مخصصة.

للحصول على مثال لكل نوع عنصر تحكم، راجع عناصر تحكم النموذج عنصر العمل.

مثال

<Control Type=" WorkItemClassificationControl " FieldName="System.AreaPath"
  Label="Area" LabelPosition="Left" />

معلومات العنصر

مساحة الاسم

https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef

اسم المخطط

تعريف نوع عنصر العمل

ملف الـتحقق من الصحة

WorkItemTypeDefinition.xsd

نوع العنصر

النوع المعقد ControlType (مخطط تعريف نوع عنصر العمل)

يمكن أن يكون فارغاً

غير قابلة للتطبيق

راجع أيضًا:

المبادئ

كافة عناصر FORM عنصر العمل

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