7. Модификация приложения Windows Forms: динамическое связывание параметров двух форм и передача параметра через класс делегата
По аналогии с пунктом под номер 6 данной лабораторной работы создаём третью форму. Элементы расставляем также.
Создаём новую форму LWP04ChildrenDelegate1 со следующими элементами:
Рис. 7. 1. Расстановка элементов на добавленной форме LWP04ChildrenDelegate1
Параметры формы LWP04ChildrenDelegate1 таковы:
(Name): |
LWP04ChildrenDelegate1 |
Text: |
Работа с окнами (C#) :: Подчинённая форма для делегата № 2 |
Size: |
500; 100 |
FormBorderStyle: |
Fixed Dialog |
MaximizeBox: |
False |
MinimizeBox: |
False |
ShowInTaskbar: |
False |
Параметры добавленного текстового поля редактирования таковы:
(Name): |
TextBoxChildrenDelegate2 |
Событие TextChanged текстового поля редактирования TextBoxChildrenDelegate2:
private void TextBoxChildrenDelegate2_TextChanged(object sender, EventArgs e)
{
Text2 = TextBoxChildrenDelegate1.Text; // Присваиваем переменной обратной передачи значение текстового поля
}
Параметры добавленной кнопки Закрыть:
(Name): |
ButtonClose |
Text: |
Закрыть |
Size: |
75; 23 |
Событие Click кнопки ButtonClose:
private void ButtonClose_Click(object sender, EventArgs e)
{
Close();
}
Также, добавим ещё одну кнопку для формы LWP04Main:
Рис. 7. 2. Расстановка элементов на добавленной форме LWP04Main: кнопка Для делегата № 2
Параметры добавленной кнопки таковы:
(Name): |
ButtonShowChildrenDelegate2 |
Text: |
Для делегата № 2 |
Size: |
150; 23 |
ToolTip на Hint: |
Передача параметра через класс делегата |
Событие Click кнопки ButtonShowChildrenDelegate2:
/* Создаём экземпляр класса формы LWP04ChildrenDelegate2, вызываем конструктор
* Вместе с формой создаём экземпляр делегата с вызовом метода TextBoxNewDelegate2() */
LWP04ChildrenDelegate2 D2 = new LWP04ChildrenDelegate2(new NewDelegate2In(TextBoxNewDelegate2));
D2.ShowDialog(); // Вызываем модальный диалог нашей формы
Это событие на кнопке аналогично тому, что уже было использовано. Мы совместим возможности показанные в пункте № 6 с новой функциональностью.
В этом же файле (LWP04Main.cs) добавляем следующее (новая функция void, и копия метода и пункта №6):
void TextBoxNewDelegate2Out(String Text)
{
/* Основной обработчик передачи параметра, вызывается всякий раз когда происходит событий обновления текста поле дочерней формы
* Вызывает MessageBox.Show с главной формы, что важно, сообщая параметр с дочерней формы */
MessageBox.Show("Текст который был введён в форме:\n\n" + Text, D2.Text + " :: Результат выполнения");
TextBoxMain.Text = Text; // Отправляем полученную переменную в поле TextBoxMan (выполняется динамически)
}
string TextBoxNewDelegate2()
{
// Метод возвращает значение TextBoxMain, нужен для работы делегата
return TextBoxMain.Text;
}
Основной метод главной формы отредактируем так (ВАЖНО, чтобы весь код находился после строчки (InitializeComponent();), так как здесь должен сработать сначала конструктор, а затем всё остальное.
public LWP04Main()
{
InitializeComponent();
NewDelegate2Out.EventHandler = new NewDelegate2Out.NewEventOut(TextBoxNewDelegate2Out);
}
Ключевым же является метод дочерней формы для текстового поля редактирования. Событие TextChanged текстового поля редактирования TextBoxChildrenDelegate2:
// Метод отлавливающий изменения текстового поля является здесь основным
private void TextBoxChildrenDelegate2_TextChanged(object sender, EventArgs e)
{
/* Срабатывает делегат NewDelegate2Out при получения события изменений текста этого поля
* и в метод (на главную форму) отправляется значение этого поля
* То есть изменение текста приводит к ВЫЗОВУ события EventHandler и отправку через делегат данных текстового поля */
NewDelegate2Out.EventHandler(TextBoxChildrenDelegate2.Text);
}
Сам класс делегата в файле Program.cs реализован так:
/* Создаём делегата № 2 */
public static class NewDelegate2Out
{
public delegate void NewEventOut(String Data);
public static NewEventOut EventHandler;
}
// Делаем по аналогии
public delegate string NewDelegate2In();
Последний способ достаточно сложен для понимания. В основе лежит инициализация EventHandler. Он представляет метод, который будет обрабатывать событие, не имеющее данных. Поэтому, он «ловит» событие изменение текса, узнаёт кто (какой элемент) проинициализировал это событие и вытаскивает текст в текстовом поле редактирования дочерней формы. Итак, что же такое делегаты?
В платформе .NET Framework в основе модели события лежит существование делегата события, связывающего событие с его обработчиком. Для вызова события требуются два элемента:
делегат, который идентифицирует метод, вызываемый в ответ на событие (делегат был создан);
класс, в котором хранятся данные события (мы организовывали в как раз таки класс).
Делегат — это тип, который определяет сигнатуру, иными словами тип возвращаемого значения, и тип списка параметров метода. Тип делегата можно использовать для объявления переменной, которая может ссылаться на любой метод с той же сигнатурой, что и у делегата.
В стандартной сигнатуре делегата обработчика событий определяется не возвращающий значение метод, первый параметр которого относится к типу Object и ссылается на экземпляр, который инициировал событие, а второй параметр является производным от типа EventArgs и содержит данные события. Если событие не создает данных, второй параметр просто является экземпляром класса EventArgs. В противном случае, второй параметр является пользовательским типом, производным от EventArgs, и предоставляет всевозможные поля и свойства, необходимые для хранения данных события (что мы и получили, считав текст с поля).
EventHandler является предопределённым делегатом, представляющим метод обработчика событий для события, не генерирующего данные. Если событие не генерирует данные, необходимо предоставить собственный пользовательский тип данных события и либо создать делегат, в котором типом второго параметра является этот пользовательский тип, либо использовать универсальный класс делегата EventHandler(Of TEventArgs) и подставлять свой пользовательский тип в параметр универсального типа. Чтобы связать событие с методом, который будет обрабатывать событие, и добавить в событие экземпляр делегата. Обработчик событий вызывается при каждом происхождении этого события, пока делегат не будет удален.
Именно событийная модель делает делегаты мощным инструментом (что можно было увидеть при выполнении данной лабораторной работы).
Немного об объявлении делегата в общем виде: объявление создания делегата происходит так:
delegate void MyDelegate();
Сначала идёт ключевое слово, затем возвращаем тип метода (void), и потом имя делегата. В нашем случае, делегат не возвращает зачения и не получает параметров, то есть это относится к любому методу этого делегата.
Используя конструктор, создаём новый объект нашего типа-делегата:
MyDelegate NewDelegate = new MyDelegate(MyMethod);
Мы видим, что в конструктор передалось имя целевого метода. Тип этого метода должен быть обязательно void (раз мы решили так сделать в самом начале). И конструктором создаётся экземпляр под именем NewDelegate.
Целевой метод:
static void MyMethod()
{
/* Тут может быть какой-либо код */
}
Для запуска делегата вызываем объект нашего делегата (будет выполнен метод MyMethod()):
NewDelegate();
Компилируем приложение, проверяем работу текстовых полей третьей добавленной формы и главной формы. При изменении текста в главной форме меняется значение в поле вызываемой формы (по нажатию кнопки Для делегата № 2). Изменение значения поля в вызванной форме приводит к обратному эффекту, а также вызову MessageBox.
Рис. 7. 3. Динамическое изменение значений текстового полей главной формы (во время ввода данных в текстовом поле дочерней формы)