المحتوى الرئيسي

مفهوم صندوق الكتابة TextBox

صندوق الكتابة (TextBox) هو أداة تحكم تسمح للمستخدم بإدخال بيانات نصية أو رقمية أثناء تشغيل البرنامج، مثل إدخال الاسم أو كلمة المرور أو قيمة رقمية. يُعَدّ الوسيلة الأساسية لإدخال البيانات من المستخدم في تطبيقات VB.NET.

الخاصية Text — القراءة والكتابة

تحمل الخاصية Text القيمة النصية المكتوبة داخل الصندوق، وهي أهم خاصية فيه لأنها تُستخدَم في الاتجاهين:

الكتابة في TextBox من الكود (وضع قيمة ابتدائية أو نتيجة):

TextBox1.Text = "أدخل اسمك هنا"

قراءة القيمة التي كتبها المستخدم:

Dim studentName As String
studentName = TextBox1.Text

ولأن خاصية Text دائمًا من نوع نص (String)، فإذا أراد المبرمج التعامل مع القيمة كرقم لإجراء عمليات حسابية، يجب تحويلها أولًا باستخدام دالة مثل Val() أو CInt():

Dim age As Integer
age = Val(TextBox1.Text)

الخاصية MaxLength

تحدد الحد الأقصى لعدد الأحرف التي يمكن للمستخدم كتابتها داخل الصندوق. فإذا كانت قيمتها 10 مثلًا، لا يستطيع المستخدم كتابة أكثر من عشرة أحرف:

TextBox1.MaxLength = 10

الخاصية PasswordChar

تُستخدَم لإخفاء النص المكتوب (مثل كلمات المرور) واستبداله برمز معين يظهر بدلًا من كل حرف حقيقي، مع بقاء القيمة الفعلية محفوظة في Text:

TextBox2.PasswordChar = "*"c

الخاصية Multiline

خاصية منطقية (Boolean)؛ فإذا كانت True يمكن للصندوق عرض أكثر من سطر نصي واحد (مفيدة لكتابة فقرات)، وإذا كانت False (القيمة الافتراضية) يُقتصر الصندوق على سطر واحد فقط. غالبًا ما تُستخدَم مع خاصية ScrollBars لإضافة أشرطة تمرير عند الحاجة.

خصائص أخرى مهمة

• ReadOnly: إذا كانت True، يمكن للمستخدم رؤية النص لكن لا يستطيع تعديله.
• Enabled: تفعيل الصندوق أو تعطيله.
• ScrollBars: إضافة أشرطة تمرير رأسية/أفقية عند تفعيل Multiline (None، Horizontal، Vertical، Both).
• Name: الاسم البرمجي، مثل txtName أو txtPassword.

حدث TextChanged

ينفَّذ هذا الحدث تلقائيًّا في كل مرة يتغيّر فيها محتوى الصندوق (أثناء كتابة المستخدم):

Private Sub TextBox1_TextChanged(sender As Object, e As EventArgs) Handles TextBox1.TextChanged
    Label1.Text = "عدد الأحرف: " & TextBox1.Text.Length
End Sub

أسئلة للمراجعة

1. اكتب سطر كود يقرأ القيمة المكتوبة في TextBox1 ويخزنها في متغير نصي باسم city.
2. ما وظيفة الخاصية PasswordChar؟ ومتى يُستخدَم؟
3. اكتب سطر كود يجعل صندوق النص TextBox3 لا يقبل أكثر من 6 أحرف.
4. ما الفرق بين خاصيتي ReadOnly وEnabled في TextBox؟
5. اكتب كودًا يقرأ رقمًا من TextBox1 (باستخدام Val)، يضربه في 2، ويعرض الناتج في Label1.