عناصر WebpageControlOptions

يمكنك عرض محتوى المعرّف من أجل صفحة ويب أو داخل علامة ال CDATA على نموذج عنصر عمل باستخدام العنصرWebpageControlOptions.

هيكل المخطط

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

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

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

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

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

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

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

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

<xs:element name="WebpageControlOptions" type="WebpageControlOptionsType" minOccurs="0" maxOccurs="1" />
<xs:element name="Link" type="HyperLinkType" minOccurs="0" maxOccurs="1" />
<xs:element name="Param" type="HyperLinkParamType" minOccurs="0" maxOccurs="unbounded"/>

<WebpageControlOptions AllowScript="true | false" ReloadOnParamChange="true | false" >
   <Link URLRoot="URL root" URLPath ="URL path with parameters">
      <Param index="index value " value="Param Value " type ="Original | Current"/>
   </Link>
   <Content>
      <![CDATA[Contents of HTML]]>
   </Content>
</WebpageControlOptions>

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

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

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

العنصر	السمة	الوصف
WebpageControlOptions		عنصر اختياريControl عند type="WebpageControl". حاوية عنصر لتعريف URL سيتم تقديم محتوياتها في نموذج عنصر العمل. العنصر Linkالإختيارى. مطلوبة عند تحديد URLPath. تحدد قيمة لاستخدامها لتحديد URL للارتباط التشعبي عند تحديد URLPath. نوع العنصر هو النوع المعقد : WebpageControlOptionsType.
	AllowScript	سمة WebpageControlOptions اختيارية. تحدد ما إذا كان مسموحاً تشغيل JavaScript داخل صفحة ويب ( true) أو لا ( false). نوع السمة هو xs:boolean. كافة الإعدادات الأخرى مثل ActiveX تستند على إعدادات Internet Explorer المعرّفة من أجل العميل.
	ReloadOnParamChange	سمة WebpageControlOptions اختيارية. تحدد ما إذا كان إعادة تحميل المحتويات ( true) لصفحة ويب عند تغيير معلمة في نموذج عنصر العمل ( true) أو لا ( false). نوع السمة هو xs:boolean. القيمة الافتراضية هي true.
Link		العنصر WebpageControlOptionsالإختيارى. هذا العنصر بشكل خاص تبادلي مع العنصر Content. تحدد ال URL لصفحة ويب ليتم عرضها في نموذج عنصر العمل. لمزيد من المعلومات، راجع Link and Param Elements.
Content		العنصر WebpageControlOptionsالإختيارى. هذا العنصر بشكل خاص تبادلي مع العنصر Link. تحدد محتوى ال HTML وهو الذي سيتم عرضه في عنصر تحكم صفحة ويب. المحتوى محدد داخل علامة CDATA. فعلى سبيل المثال: <![CDATA[Click here for detailed <b><a href="http://www.microsoft.com">Process Guidance</a></b>]]> نوع العنصر هو xs:string. ملاحظة محتوى HTML لا يتم التدقيق من صحته لتقديمه في نموذج عنصر العمل.

العناصر الأصل

العنصر	الوصف
عنصر تحكم (مخطط تعريف نوع عنصر عمل)	العنصر المطلوب. يعرّف حقل النص أو الارتباط التشعبي أو عنصر تحكم آخر لتظهر على نموذج عنصر العمل.
Text	العنصر LabelTextالإختيارى. حاوية العنصر للحصول على المعلومات أو التسمية لتظهر على نموذج عنصر العمل. لمزيد من المعلومات، راجع LABELTEXT وعناصر نص.

ملاحظات

العناصر Link و Content تكون متعارضة.

السماتAllowScript و ReloadOnParamChange غير مسموح بها عند استخدام العنصر Content.

عند تكوين تحكم صفحة ويب لعرض HTML خام ، يتم تعطيل كافة البرامج النصية. الارتباطات التشعبية الموجودة في المحتوى التي يتم النقر فوقها في المستعرض Visual Studio يتم فتحها إذا كان يتم عرض نموذج عنصر العمل في Visual Studio أو في Internet Explorer.

يتم إضافة أزرار شريط الأدوات متعددة إلى نموذج عنصر العمل للحصول على علامة تبويب التي تحتوي على WebpageControl. تتضمن هذه الخيارات الدالات التالية:

• التنقل الخلفي و الأمامي

• إيقاف تحميل محتوى و تحديث محتوى

• إرجاع الى محتوى الصفحة الرئيسية

• فتح المحتوى في إطار جديد أو في مستعرض خارجي

بالإضافة إلى ذلك، إذا كانت صفحة الويب التي يتم تحميلها تحتوي على محتوى غير موثوق به، اذا يتم حظر الأيقونة وتظهر أيقونة المحظورة.

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

مثال

يظهر المثال التالي كيفية تحميل عنصر عمل نموذج مع HTML المعرف في علامة CDATA.

<Control Type="WebpageControl">
   <WebpageControlOptions>
      <Content>
         <![CDATA[Click here for detailed <b><a href="https://www.microsoft.com">Process Guidance</a></b>]]>
      </Content>
   </WebpageControlOptions>
</Control>

تعريفات المخطط

WebpageControlOptionsType.

<xs:complexType name="WebpageControlOptionsType">
   <xs:choice minOccurs="1" maxOccurs="1">
      <xs:element name="Link" type="HyperLinkType"/>
      <xs:element name="Content" type="xs:string"/>
   </xs:choice>
      <xs:attribute name="AllowScript" type="xs:boolean" use="optional" />
      <xs:attribute name="ReloadOnParamChange" type="xs:boolean" use="optional" />
</xs:complexType>

NonBlankString

<xs:simpleType name="NonBlankString">
   <xs:restriction  base="xs:string">
   <xs:pattern value=".*\S+.*"/>
   </xs:restriction>
</xs:simpleType>

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

مساحة الاسم	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
اسم المخطط	تعريف نوع عنصر العمل
ملف الـتحقق من الصحة	WorkItemTypeDefinition.xsd
نوع العنصر	WebpageControlOptionsType
يمكن أن يكون فارغاً	غير قابلة للتطبيق

راجع أيضًا:

المبادئ

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

تصميم و تخصيص نموذج عنصر العمل

موارد أخرى

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