يوفر عنصر تحكم خادم لوحة الويب عنصر تحكم في الحاوية داخل صفحة ويب ASP.NET التي يمكنك استخدامها كأصل للنص الثابت وعناصر التحكم الأخرى.
1. الخلفية
يمكنك استخدام عنصر تحكم اللوحة كحاوية لعناصر التحكم الأخرى. تعتبر هذه الطريقة مفيدة بشكل خاص عندما تقوم بإنشاء محتوى برمجيًا وتحتاج إلى طريقة لإدراج المحتوى في الصفحة. تصف الأقسام التالية الطرق الأخرى التي يمكنك من خلالها استخدام عنصر تحكم اللوحة.
1. حاوية عناصر التحكم التي تم إنشاؤها ديناميكيًا
توفر لوحة التحكم حاوية ملائمة لعناصر التحكم التي تم إنشاؤها أثناء وقت التشغيل.
2. ضوابط المجموعة وعلاماتها
يمكن إدارة مجموعة من عناصر التحكم والعلامات ذات الصلة كوحدة واحدة عن طريق وضعها في عنصر تحكم اللوحة ثم التعامل مع عنصر تحكم اللوحة. على سبيل المثال، يمكنك إخفاء أو إظهار مجموعة من عناصر التحكم في لوحة عن طريق تعيين خاصية Visible للوحة.
3. نموذج بالأزرار الافتراضية
يمكنك وضع عنصر التحكم TextBox وعنصر التحكم Button في عنصر تحكم اللوحة، ثم تحديد زر افتراضي عن طريق تعيين خاصية DefaultButton لعنصر تحكم اللوحة على معرف زر في اللوحة. إذا قام المستخدم بالضغط على Enter أثناء الكتابة في مربع نص داخل اللوحة، فسيكون لذلك نفس التأثير كما لو قام المستخدم بالنقر فوق زر افتراضي محدد. وهذا يساعد المستخدمين على العمل مع نماذج المشروع بشكل أكثر كفاءة.
4. أضف أشرطة التمرير إلى عناصر التحكم الأخرى
لا تحتوي بعض عناصر التحكم (مثل عنصر التحكم TreeView) على أشرطة تمرير مضمنة. يمكنك إضافة سلوك التمرير عن طريق وضع عنصر تحكم شريط التمرير ضمن عنصر تحكم اللوحة. لإضافة أشرطة التمرير إلى عنصر تحكم اللوحة، قم بتعيين خصائص الارتفاع والعرض، وتقييد عنصر تحكم اللوحة بحجم معين، ثم قم بتعيين خاصية ScrollBars.
4. المناطق المخصصة على الصفحة
يمكنك استخدام عنصر تحكم اللوحة لإنشاء مناطق على الصفحة بمظهر وسلوك مخصصين، كما يلي:
· إنشاء مربع مجموعة بعنوان: يمكنك تعيين خاصية GroupingText لعرض العنوان. عندما يتم عرض الصفحة، يظهر مربع يحتوي على عنوان حول لوحة التحكم، ويكون العنوان هو النص الذي تحدده.
ملاحظة: لا يمكنك تحديد أشرطة التمرير والنص المجمع في نفس الوقت في لوحة التحكم. إذا تم تعيين نص مجمّع، فستكون أولويته أعلى من شريط التمرير.
·إنشاء مناطق على الصفحة بألوان مخصصة أو مظاهر أخرى: يدعم عنصر تحكم اللوحة خصائص المظهر (مثل BackColor وBorderWidth)، والتي يمكن تعيينها لإنشاء مظهر فريد لمنطقة ما على الصفحة.
الوصف: سيؤدي تعيين خاصية GroupingText إلى عرض حد حول عنصر تحكم اللوحة تلقائيًا.
2. كيفية: إضافة عنصر تحكم اللوحة إلى صفحة نماذج الويب
1. في عرض "التصميم"، من علامة التبويب "قياسي" في صندوق الأدوات، اسحب عنصر تحكم اللوحة إلى الصفحة.
2. لإنشاء نص ثابت، انقر فوق عنصر التحكم ثم اكتب النص. لإضافة عناصر تحكم، اسحبها من Toolbox إلى لوحة التحكم.
ملاحظة: لإضافة نص ثابت إلى عنصر تحكم اللوحة في وقت التشغيل، تحتاج إلى إنشاء عنصر تحكم حرفي وتعيين خاصية النص الخاصة به. ويمكن بعد ذلك إضافة الكائنات الحرفية إلى اللوحة برمجيًا بنفس طريقة إضافة أي عنصر تحكم. لمزيد من المعلومات حول إضافة عناصر التحكم، راجع كيفية: إضافة عناصر التحكم برمجياً إلى صفحة ويب ASP.NET.
3. يمكنك أيضًا اختيار سحب حدود اللوحة لتغيير حجم عنصر التحكم.
الوصف: يقوم عنصر التحكم هذا بتغيير حجم نفسه تلقائيًا لعرض كافة عناصر التحكم التابعة له (حتى لو تجاوزت الارتفاع المحدد).
4. يمكنك أيضًا اختيار تعيين خصائص عنصر تحكم اللوحة (كما هو موضح في الجدول التالي) لتحديد كيفية تفاعل الجزء مع عناصر التحكم التابعة له.
وصف العقار
محاذاة أفقية
يحدد محاذاة عناصر التحكم الفرعية داخل اللوحة (يسار، أو يمين، أو وسط، أو مضبوط).
طَوّق
يحدد ما إذا كان المحتوى الواسع جدًا داخل اللوحة سيتم التفافه إلى السطر التالي، أو سيتم اقتطاعه عند حافة اللوحة.
اتجاه
يحدد ما إذا كان سيتم عرض محتوى عنصر التحكم من اليسار إلى اليمين أو من اليمين إلى اليسار. تكون هذه الخاصية مفيدة عند إنشاء مناطق على الصفحة يتم توجيهها بشكل مختلف عن الصفحة بأكملها.
أشرطة التمرير
إذا قمت بتعيين خصائص الارتفاع والعرض لتقييد التحكم في اللوحة بحجم معين، فيمكنك إضافة أشرطة التمرير عن طريق تعيين خاصية ScrollBars.
نص التجميع
يعرض الحدود والعنوان حول لوحة التحكم.
يوضح:
يؤدي تعيين خاصية GroupingText إلى عدم ظهور أشرطة التمرير (إذا قمت بتحديد أشرطة التمرير).
3. فئة اللوحة
عناصر التحكم في اللوحة عبارة عن حاويات لعناصر التحكم الأخرى. يعد عنصر التحكم هذا مفيدًا بشكل خاص عندما تريد إنشاء عناصر تحكم برمجيًا، أو إخفاء/إظهار مجموعة من عناصر التحكم، أو ترجمة مجموعة من عناصر التحكم.
تعد خاصية الاتجاه مفيدة لتوطين محتويات عنصر تحكم اللوحة لعرض النص باللغات المكتوبة من اليمين إلى اليسار، مثل العربية أو العبرية.
يوفر عنصر تحكم اللوحة العديد من الخصائص التي تسمح لك بتخصيص سلوك وعرض محتويات عنصر التحكم. استخدم خاصية BackImageUrl لعرض صورة مخصصة لعنصر تحكم اللوحة. استخدم خاصية ScrollBars لتحديد أشرطة التمرير لعنصر التحكم.
مثال
1. يوضح المثال التالي كيفية استخدام عنصر تحكم اللوحة لإنشاء عناصر تحكم وإخفاء/إظهار مجموعة من عناصر التحكم برمجيًا.
ملاحظة: يستخدم مثال التعليمات البرمجية التالي نموذج تعليمات برمجية لملف واحد وقد لا يعمل بشكل صحيح عند نسخه مباشرة إلى ملف التعليمات البرمجية الخلفية. يجب أن يتم نسخ نموذج التعليمات البرمجية هذا إلى ملف نصي فارغ بملحق .aspx.
<%@ لغة الصفحة = "C#" AutoEventWireup = "True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
" http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd ">
<أتش تي أم أل>
<الرأس>
<title>مثال على اللوحة</title>
<script runat="server">
باطلة Page_Load(مرسل الكائن، EventArgs e) {
// إظهار أو إخفاء محتويات اللوحة.
إذا (Check1.Checked) {
Panel1.Visible=false;
}
آخر {
Panel1.Visible=true;
}
// إنشاء عناصر التحكم في التسمية.
int numlabels = Int32.Parse(DropDown1.SelectedItem.Value);
for (int i=1; i<=numlabels; i++) {
التسمية l = تسمية جديدة () ؛
l.Text = "التسمية" + (i).ToString();
l.ID = "التسمية" + (i).ToString();
Panel1.Controls.Add(l);
Panel1.Controls.Add(new LiteralControl("<br />"));
}
// إنشاء عناصر التحكم في مربع النص.
int numtexts = Int32.Parse(DropDown2.SelectedItem.Value);
for (int i=1; i<=numtexts; i++) {
TextBox t = new TextBox();
t.Text = "TextBox" + (i).ToString();
t.ID = "TextBox" + (i).ToString();
Panel1.Controls.Add(t);
Panel1.Controls.Add(new LiteralControl("<br />"));
}
}
</script>
</الرأس>
<الجسم>
<h3>مثال على اللوحة</h3>
<معرف النموذج = "form1" runat = "الخادم">
<asp: معرف اللوحة = "Panel1" runat = "الخادم"
لون الرجوع = "جينسبورو"
الارتفاع = "200 بكسل"
العرض = "300 بكسل">
اللوحة 1: إليك بعض المحتوى الثابت...
<br />
</asp:لوحة>
<br />
إنشاء التسميات:
<asp:DropDownList id = "DropDown1" runat = "الخادم">
<asp:ListItem Value="0">0</asp:ListItem>
<asp:ListItem Value="1">1</asp:ListItem>
<asp:ListItem Value="2">2</asp:ListItem>
<asp:ListItem Value="3">3</asp:ListItem>
<asp:ListItem Value="4">4</asp:ListItem>
</asp:DropDownList>
<br />
إنشاء مربعات نصية:
<asp:DropDownList id = "DropDown2" runat = "الخادم">
<asp:ListItem Value="0">0</asp:ListItem>
<asp:ListItem Value="1">1</asp:ListItem>
<asp:ListItem Value="2">2</asp:ListItem>
<asp:ListItem Value="3">3</asp:ListItem>
<asp:ListItem Value="4">4</asp:ListItem>
</asp:DropDownList>
<br />
<asp:CheckBox id = "Check1" Text = "إخفاء اللوحة" runat = "الخادم"/>
<br />
<asp:Button Text="لوحة التحديث" runat="server"/>
</النموذج>
</الجسم>