textBox | شرح اداة التحكم TextBox

 

 textBox | شرح اداة التحكم TextBox

يمكن استخدام اداة التحكم TextBox ، لإدخال البيانات أو لعرض

النص أثناء وقت التشغيل. ربما تكون هذه هي اداة التحكم الأكثر استخدامًا لأنه يمكن أن تكون تستخدم لكل من المدخلات والمخرجات. مثل معظم الكائنات الأخرى من فئة التحكم ،

خاصية النص (text)

يتم استخدام الخاصية للحصول على أو تعيين قيمة السلسلة في اداة التحكم. عادة ، سطر واحد من النص يظهر في TextBox ؛ ومع ذلك ، عن طريق تغيير خاصية MultiLine إلى true ،

يمكن أن يظهر TextBox عدة أسطر.هناك أيضًا خاصية ScrollBars

يتم استخدام هذه الخاصية مع تعيين خاصية MultiLine إلى true ، يمكنك ذلك

عيّن ما إذا تمت إضافة أشرطة التمرير الرأسية أو الأفقية. يمكنك أيضًا تقييد عدد الأحرف التي يمكن أن يعرضها TextBox بكتابة قيمة لـ   خاصيةMaxLength

يتم استخدام خاصية PasswordChar مع TextBox وهي ممتعة للعمل معها. بواسطة

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

تعمل الخاصية فقط عند تعيين الخاصية MultiLine إلى false.

خاصية أخرى  يمكن تعيين الخاصية ، CharacterCasing ، بحيث يتم استرداد جميع الأحرف بواسطة الخاصية TextBox.Text يتم تحويل إلى أحرف كبيرة أو صغيرة.

خاصية CharacterCasing ، تقوم بتحديد قيمة تحدد حالة الاحرف التي يتم إدخالها حروف كبيرة او صغيرة او normal  

·        الخاصية AcceptsReturn

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

اذا كانت قيمة الخاصية تساوي true  فانهو سوف ينشئ سطرًا جديدًا

اذا كانت تساوي false  فإنهو يتم تنشيط الزر الافتراضي للفورم

بمعنى :

اذا كان لديك في الفورم الأدوات التالية

textbox

خصائصها :

multiline = true

AcceptsReturn = false

واداة Button  تقوم بطباعة رسالة في الحدث Click

و الخاصية AcceptButton  التابعة للفورم تساوي button1

فإنهو عندما يقوم المستخدم بالكتابة في مربع النص ويريد النزول الى سطر جديد ويضغط الزر Enter  لن يتم النزول الى سطر جديد وسوف يتم تنفيذ الرسالة الموجودة في دالة الحدث Click  الخاصة بالزر

ولحل هذه المشكلة قم بجعل الخاصية AcceptsReturn  = true

·     الخاصية AcceptsTab

تقوم بتعيين قيمة تشير إلى ما إذا كان الضغط على المفتاح TAB في اداة تحكم مربع نص متعدد الأسطر يؤدي إلى عمل مسافة بين النص في اداة التحكم او يتم نقل التركيز إلى عنصر التحكم التالي

توضيح :

يعني اذا كانت قيمة الخاصية تساوي true  فإنهو عند الضغط على مفتاح Tab  يتم عمل مسافة للنص في أداة مربع النص

واذا كانت تساوي false  فانهو يتم نقل التركيز الى أداة تحكم أخرى حسب ترتيب خاصية tab index

قيمتها الافتراضية false

·        الخاصية Modified

تقوم بتعيين قيمه تشير الى ان أداة مربع النص قد تم تعديل النص بداخلها من قبل المستخدم او تم إعادة تعيين محتوايته اخر مره

مثلاً اذا كان لديك برنامج يقوم بحفظ بيانات الطلاب مع امكانيه التعديل على هذه البيانات او حذفها

فمثلاً لو أراد المستخدم ان يقوم بتعديل اسم طالب

ففي حالة كان اسم الطالب مختلف عما كان عليه من قبل ففي هذه الحالة

يجب تنبيه المستخدم في ما اذا كان يريد حفظ البيانات بعد ان تم التعديل عليها

·        الخاصية HideSelection

تقوم بتعيين قيمة تشير إلى ما إذا كان النص المحدد في اداة تحكم مربع النص يظل محددًا عندما تفقد اداة التحكم التركيز.

عندما تكون قيمه الخاصية تساوي true  فإنه يتم إخفاء النص المحدد عندما تفقد أداة مربع النص التركيز

واذا كانت تساوي false  فإن النص المحدد يظل محدداً حتى عندما تفقد الأداة التركيز

قيمتها الافتراضيه تساوي true

المقصود ب فقدان التركيز أي انك تنتقل الى أداة أخرى تستخدم أداة أخرى في الفورم

·         الخاصية SelectionStart

تقوم بتعيين نقطة البداية لمؤشر الكتابة في النص

فمثلاً لو كان معك أداة مربع النص في الفورم

وكتب هذا السطرين في دالة الحدث Load

textBox1.Text = "hello";

            textBox1.SelectionStart = 2;

سوف يظهر مؤشر الكتابة بين حرف e  و l

·        الخاصية WordWrap

الإشارة إلى ما إذا كان اداة تحكم مربع نص متعدد الأسطر يلتف الكلمات تلقائيًا إلى بداية السطر التالي عند الضرورة.

هذه الخاصية تقوم بالانتقال الى السطر التالي عندما يصل المستخدم بالكتابة الى نهايه مربع النص يتم الانتقال الى سطر جديد في حاله كانت تساوي true  اما اذا كانت تساوي false  فإنه سوف يتم الكتابة في سطر واحد دون الانتقال الى السطر التالي

ملاحظة مهمة :

اذا تم تعيين قيمه الخاصية الى true  فإن الخاصية ScrollBar= Horizontal

لن تعمل أي ان شريط التمرير الافقي لن يظهر

·       الخاصية ScrollBar

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

مثلاً القيم التي تاخذها هذه الخاصية هي ثلاث قيم

شريط تمرير افقي Horizontal

شريط تمرير عمودي Vertical

او كلاهما Both

او لايظهر أي منهما none

تذكر !

لن يتم عرض أشرطة التمرير الأفقية إذا تم تعيين خاصية WordWrap إلى true ، بغض النظر عن قيمة الخاصية ScrollBars.

·        الخاصية multi line

تسمح لإداة مربع النص ان تكون متعددة الاسطر

في حالة كانت تساوي true  

قيمتها الافتراضية تساوي false

·        الخاصية SelectionLength

الحصول على عدد الاحرف المحددة في مربع النص

·      الخاصية ShortCutEnabled

تعيين قيمة تشير إلى ما إذا كانت الاختصارات المحددة ممكّنة.

الاختصارت مثل اختصار النسخ القص التحديد التراجع الخ....

·        الخاصية textLength

الحصول على طول النص في اداة التحكم textbox

·        الخاصية ReadOnly

تعيين قيمة تشير إلى ما إذا كان النص في مربع النص للقراءة فقط.