События управления (Windows Forms .NET)

Статья
10/13/2023

Элементы управления предоставляют события, возникающие при взаимодействии пользователя с элементом управления или при изменении состояния элемента управления. В этой статье описываются распространенные события, используемые большинством элементов управления, события, создаваемые взаимодействием с пользователем, и события, уникальные для определенных элементов управления. Дополнительные сведения о событиях в Windows Forms см. в разделе Общие сведения о событиях и Обработка и вызов событий.

Важно!

Документация по рабочему столу для .NET 7 и .NET 6 находится в стадии разработки.

Дополнительные сведения о добавлении или удалении обработчика событий элемента управления см. в разделе Обработка события.

Наиболее распространенные события

Элементы управления предоставляют более 60 событий через базовый класс Control. К ним относятся событие Paint, вызывающее отрисовку элемента управления, связанные с отображением окна события, такие как Resize и Layout, а также низкоуровневые события мыши и клавиатуры. Некоторые низкоуровневые события с помощью Control синтезируются в семантические события, такие как Click и DoubleClick. Большинство общих событий относятся к следующим категориям:

События мыши
События клавиатуры
События изменения свойств
Другие события

События мыши

Учитывая, что Windows Forms является технологией пользовательского интерфейса, действия мыши являются основным способом взаимодействия пользователей с приложением Windows Forms. Все элементы управления предоставляют основные события, связанные с мышью:

Дополнительные сведения см. в статье Использование событий мыши.

События клавиатуры

Если элемент управления реагирует на данные, введенные пользователем, например, элемент управления TextBox или Button, для элемента управления возникает соответствующее событие ввода. Элемент управления должен быть настроен для получения событий клавиатуры. Некоторые элементы управления, такие как элемент управления Label, не могут быть настроены и не могут получать события клавиатуры. Ниже приведен список событий клавиатуры:

Дополнительные сведения см. в разделе об использовании событий клавиатуры.

События изменения свойств

Windows Forms использует шаблон PropertyNameChanged для свойств, имеющих события изменения. Обработчик привязки данных, предоставляемый Windows Forms, распознает этот шаблон и эффективно интегрируется с ним. При создании собственных элементов управления реализуйте этот шаблон.

Этот шаблон реализует следующие правила, используя свойство FirstName в качестве примера:

Присвойте свойству имя: FirstName.
Создайте событие для свойства с помощью шаблона PropertyNameChanged: FirstNameChanged.
Создайте частный или защищенный метод с помощью шаблона OnPropertyNameChanged: OnFirstNameChanged.

Если набор свойств FirstName изменяет базовое значение, вызывается метод OnFirstNameChanged. Метод OnFirstNameChanged вызывает событие FirstNameChanged.

Ниже приведены некоторые распространенные события изменения свойств для элемента управления:

Мероприятие	Description
BackColorChanged	Происходит при изменении значения свойства BackColor.
BackgroundImageChanged	Происходит при изменении значения свойства BackgroundImage.
BindingContextChanged	Происходит при изменении значения свойства BindingContext.
DockChanged	Происходит при изменении значения свойства Dock.
EnabledChanged	Происходит, если значение свойства Enabled было изменено.
FontChanged	Происходит при изменении значения свойства Font.
ForeColorChanged	Происходит при изменении значения свойства ForeColor.
LocationChanged	Происходит, если значение свойства Location было изменено.
SizeChanged	Происходит при изменении значения свойства Size.
VisibleChanged	Происходит при изменении значения свойства Visible.

Полный список событий см. в разделе СобытияКласса элементов управления.

Другие события

Элементы управления также вызывают события на основе состояния элемента управления или других взаимодействий с элементом управления. Например, событие HelpRequested вызывается, если элемент управления сфокусирован, и пользователь нажимает клавишу F1. Это событие также вызывается, если пользователь нажимает контекстную кнопку Справка в форме, а затем нажимает курсор справки в элементе управления.

Другой пример, когда при изменении, перемещении или изменении размера элемента управления Paint вызывается событие. Это событие предоставляет разработчику возможность рисовать на элементе управления и менять его внешний вид.