نظرة عامة حول مربع نص

فئة TextBox يمكنك من عرض أو تحرير نص غير منسق. استخدام شائع ل TextBox هو تحرير نص غير منسق في النموذج. على سبيل المثال، نموذج يطلب اسم المستخدم ,رقم الهاتف, الخ يستخدم عناصر تحكم TextBox لإدخال النص. يُقدم هذا الموضوع فئة TextBox و يوفر أمثلة عن كيفية استخدامه في Extensible Application Markup Language (XAML) و #C.

يشتمل هذا الموضوع على الأقسام التالية.

• TextBox أو RichTextBox؟
• إنشاء مربعات النص
• الكشف عند حدوث تغييرات
• موضوعات ذات صلة

TextBox أو RichTextBox؟

كلا من TextBox و RichTextBox يسمح للمستخدمين بإدخال نص لكن عنصري تحكم يتم استخدامهم من أجل سيناريوهات مختلفة. TextBox يتطلب موارد أقل موارد من RichTextBox بحيث يكون مثالياً عند احتياج النص العادي فقط إلي التحرير (على سبيل المثال, الاستخدام في نموذج). RichTextBox هو خيار أفضل عندما يكون ذلك ضرورياً للمستخدم لتحرير نص منسق أو الصور أو الجداول أو المحتوى المدعم الأخر. على سبيل المثال، تحرير المستند أو المقالة أو المدوّنة الذي يتطلب تنسيق أو صور أو غيرها يُنجز أفضل باستخدام RichTextBox. يلخص الجدول التالي الميزات الأساسية ل TextBox و TextBox.

عنصر التحكم	‏‫التدقيق الإملائي في وقت التشغيل	قائمة السياق	تنسيق الأوامر مثل ToggleBold (Ctr + B)	محتوي FlowDocument مثل الصور، الفقرات، جداول، ألخ.
TextBox	نعم	نعم	لا	لا
RichTextBox	نعم	نعم	نعم (راجع نظرة عامة على RichTextBox)	نعم (راجع نظرة عامة على RichTextBox)

ملاحظة
على الرغم من أن TextBox لا يدعم تنسيق أوامر التحرير ذات الصلة مثل ToggleBold (Ctr + B) ، العديد من الأوامر الأساسية يدعمها كلا من عنصري التحكم مثل MoveToLineEnd.لمزيد من المعلومات، راجع EditingCommands.

الميزات المدعمة من قبل TextBox يتم تغطيتها في المقاطع أدناه. لمزيد من المعلومات حول RichTextBox، راجع نظرة عامة على RichTextBox.

‏‫التدقيق الإملائي في وقت التشغيل

يمكنك تمكين ‏‫التدقيق الإملائي في الوقت الحقيقي في TextBox أو RichTextBox. عند تشغيل ‏‫التدقيق الإملائي يظهر خط أحمر تحت الكلمات التي بها أخطاء إملائية (راجع الصورة التالية).

راجع كيفية القيام بما يلي: تمكين تدقيق الإملاء في عنصر التحكم بتحرير النص للتعرف على كيفية تمكين ‏‫التدقيق الإملائي.

قائمة السياق

افتراضياً، كل من TextBox و RichTextBox يحتوي على قائمة سياق التي تظهر عندما يقوم المستخدم بالنقر بزر الماوس الأيمن داخل عنصر التحكم. قائمة السياق تسمح للمستخدم بالقص، نسخ أو لصق (راجع الصورة التالية).

يمكنك إنشاء قائمة السياق المخصصة الخاصة بك لتجاوز السلوك الافتراضي. لمزيد من المعلومات، راجع كيفية القيام بما يلي: استخدم قائمة سياق مخصصة بمربع نص.

إنشاء مربعات النص

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

<Page  xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml">
  <StackPanel>
    <TextBox Width="200" MaxLength="100" />
  </StackPanel>
</Page>

يمكنك أيضاً إنشاء TextBox الذي يسمح للمستخدم بإدخال أسطر متعددة من النص. على سبيل المثال، إذا كان النموذج الخاص بك يطلب رسم توضيحي لسيرة المستخدم ، ستريد استخدام TextBox الذي يدعم الأسطر المتعددة من النص. يوضح المثال التالي كيفية استخدام Extensible Application Markup Language (XAML) لتعريف عنصر تحكم TextBox الذي يقوم بالتوسيع بشكل تلقائي ليتوافق مع أسطر متعددة من النص.

<TextBox
  Name="tbMultiLine"
  TextWrapping="Wrap"
  AcceptsReturn="True"
  VerticalScrollBarVisibility="Visible"
>
  This TextBox will allow the user to enter multiple lines of text.  When the RETURN key is pressed, 
  or when typed text reaches the edge of the text box, a new line is automatically inserted.
</TextBox>

إعداد سمة TextWrapping إلى Wrap سيتسبب للنص بالتفاف إلى سطر جديد عندما يتم بلوغ حافة عنصر تحكم TextBox, تلقائياً توسيع عنصر تحكم TextBox لتضمين مساحة للخط الجديد إذا كان ضروري.

تعيين سمة AcceptsReturn إلى true يؤدي إلى إدراج سطر جديد عند ضغط مفتاح RETURN, مرة أخرى تلقائياً يتم توسيع TextBox لتضمين مساحة للخط الجديد إذا كان ضروري.

سمة VerticalScrollBarVisibility تضيف شريط تمرير إلى TextBox ، بحيث يمكن للمحتويات TextBox أن يتم التمرير خلالها إذا توسّع TextBox اكثر من حجم الإطار أو النافذة التي تحيط به.

للحصول على مزيد من المعلومات حول المهام المختلفة المقترنة باستخدام TextBox راجع المواضيع الإجرائية الخاصة بمربع النص.

الكشف عند حدوث تغييرات

عادةً حدث TextChanged يجب أن يتم استخدامه للكشف كلما النص في TextBox أو RichTextBox تغيير بدلاً من KeyDown كما قد تتوقع. راجع كيفية القيام بما يلي: الكشف عن تغيير النص في مربع نص لمثال.

راجع أيضًا:

المبادئ

نظرة عامة على RichTextBox

موارد أخرى

المواضيع الإجرائية الخاصة بمربع النص