Элемент управления TextBox

Элемент управления TextBox (Поле) позволяет вводить информацию, которую затем можно использовать в программе. Кроме того, с помощью элемента TextBox имеется возможность выводить данные на форму.

Перетащим на форму элемент управления Поле. На форме появится прямоугольная ячейка для ввода данных. По умолчанию этот элемент получает имя textBox1 и наследует свойства, установленные по умолчанию. Многие свойства поля совпадают со свойствами формы, например, такие как: BackColor, Font, ForeColor, Size и Text. Свойства поля можно настраивать в окне свойств. Вид формы с полем приведен на рисунке 3.13.

Рисунок 3.17. – Форма с полем

Значения, вводимые в поле, хранятся в свойстве Text. Значение, хранимое в поле, принимает тип String. Если введенное значение – это число, то при записи его в числовую переменную, необходимо использовать методы преобразования типа класса System::Convert .

Например:

int number = System::Convert::ToDouble(textBox1->Text);

В элемент TextBox можно вводить только одну строку текста, потому что свойство Multiline по умолчанию имеет значение False. Если установить в свойство Multiline значение true, это позволит создавать многострочный текст. Для просмотра многострочного текста в поле необходимо установить линейки прокрутки изменив значение свойства ScrollBars. Оно имеет четыре состояния: None (без линеек прокрутки), Vertical (вертикальная прокрутка), Horizontal (горизонтальная прокрутка) и Both (обе). Приведем пример текстового поля с вертикальной линейкой прокрутки (свойство ScrollBars имеет значение Vertical) на рисунке 3.18.

Рисунок 3.18. – Поле с линейкой прокрутки

Текст в элемент TextBox может быть записан несколькими способами:

1) С клавиатуры на этапе выполнения программы.

2) С использованием окна свойств при настройке параметров поля:

· в свойство Text вводится однострочный текст;

· в свойство Lines вводится коллекция строк.

3) Программно, используя оператор присваивания.

Свойство ReadOnly можно установить true, чтобы запретить пользователю изменять текст. Это бывает полезно, если поле используется, например, как справочник.

Текстовое поле часто используется для ввода пароля. Для этого в свойство PasswordChar необходимо записать какой-либо символ, обычно это символ "*". Для примера поместим на форму элементы TextBox и Button. В заголовок формы введем текст "Введите пароль". В свойство PasswordChar элемента TextBox запишим символ "*". Для кнопки разработаем обработчик события Click(), в котором введенный текст будет сравниваться со словом "пароль". Если введено именно это слово то форма закроется, если нет, то в окно сообщений выведется информация о неверном вводе пароля. Код обработчика события Click() приведен ниже:

private: System::Void button1_Click(System::Object^ sender, System::EventArgs^ e)

{

if(textBox1->Text=="пароль")

this->Close();

else

MessageBox::Show("Пароль введен неверно!");

}

После запуска приложения откроется форма, в которой необходимо вводить пароль. Вид формы и пример неверного ввода пароля приведен на рисунке 3.19.

Рисунок 3.19. – Форма для ввода пароля