// Делать что-нибудь, когда на кнопке произведен щелчок.
MessageBox.Show("Clicked the button");
}
После запуска приложения окно сообщения будет отображаться независимо от того, на какой части содержимого кнопки был выполнен щелчок (зеленый элемент
Ellipse
, желтый элемент
Ellipse
, элемент
Label
или поверхность элемента
Button
). В принципе это хорошо. Только представьте, насколько громоздким оказалась бы обработка событий WPF, если бы пришлось обрабатывать событие
Click
для каждого из упомянутых подэлементов. Дело не
только в том, что создание отдельных обработчиков событий для каждого аспекта
Button
— трудоемкая задача, а еще и в том, что в результате получился бы сложный в сопровождении код.
К счастью, маршрутизируемые события WPF позаботятся об автоматическом вызове единственного обработчика события
Click
вне зависимости от того, на какой части кнопки был совершен щелчок. Выражаясь просто, модель маршрутизируемых событий автоматически распространяет событие вверх (или вниз) по дереву объектов в поисках подходящего обработчика.
Точнее говоря, маршрутизируемое событие может использовать три стратегии маршрутизации. Если событие перемещается от точки возникновения вверх к другим областям определений внутри дерева объектов, то его называют пузырьковым событием. И наоборот, если событие перемещается от самого внешнего элемента (например,
Window
) вниз к точке возникновения, то его называют туннельным событием. Наконец, если событие инициируется и обрабатывается только элементом, внутри которого оно возникло (что можно было бы описать как нормальное событие CLR), то его называют прямым событием.
Роль пузырьковых маршрутизируемых событий
В текущем примере, когда пользователь щелкает на внутреннем овале желтого цвета, событие
Click
поднимается на следующий уровень области определения (
Canvas
), затем на
StackPanel
и в итоге на уровень
Button
, где обрабатывается. Подобным же образом, если пользователь щелкает на
Label
, то событие всплывает на уровень
StackPanel
и, в конце концов, попадает в элемент
Button
.
Благодаря такому шаблону пузырьковых маршрутизируемых событий не придется беспокоиться о регистрации специфичных обработчиков события
Click
для всех членов составного элемента управления. Однако если необходимо выполнить специальную логику обработки щелчков для нескольких элементов внутри того же самого дерева объектов, то это вполне можно делать.
В целях иллюстрации предположим, что щелчок на элементе управления
outerEllipse
должен быть обработан в уникальной манере. Сначала обработайте событие
MouseDown
для этого подэлемента (графически визуализируемые типы вроде
Ellipse
не поддерживают событие
Click
, но могут отслеживать действия кнопки мыши через события
<Ellipse Name = "innerEllipse" Fill ="Yellow" Height = "15" Width ="36"
Canvas.Top="17" Canvas.Left="32"/>
</Canvas>
</StackPanel>
</Button>
Затем реализуйте подходящий обработчик событий, который
в демонстрационных целях будет просто изменять свойство
Title
главного окна:
public void outerEllipse_MouseDown(object sender, MouseButtonEventArgs e)
{
// Изменить заголовок окна.
this.Title = "You clicked the outer ellipse!";
}
Далее можно выполнять разные действия в зависимости от того, на чем конкретно щелкнул конечный пользователь (на внешнем эллипсе или в любом другом месте внутри области кнопки).
На заметку! Пузырьковые маршрутизируемые события всегда перемещаются из точки возникновения до следующей определяющей области. Таким образом, в рассмотренном примере щелчок на элементе
innerEllipse
привел бы к попаданию события в контейнер
Canvas
, а не в элемент
outerEllipse
, потому что оба элемента являются типами
Ellipse
внутри области определения
Canvas
.
Продолжение или прекращение пузырькового распространения
В текущий момент, когда пользователь щелкает на объекте
outerEllipse
, запускается зарегистрированный обработчик события
MouseDown
для данного объекта
Ellipse
, после чего событие всплывет до события
Click
кнопки. Чтобы информировать WPF о необходимости останова пузырькового распространения по дереву объектов, свойство
Handled
параметра
MouseButtonEventArgs
понадобится установить в
true
:
public void outerEllipse_MouseDown(object sender, MouseButtonEventArgs e)
{
// Изменить заголовок окна.
this.Title = "You clicked the outer ellipse!";
// Остановить пузырьковое распространение.
e.Handled = true;
}
В таком случае обнаружится, что заголовок окна изменился, но окно
MessageBox
, отображаемое обработчиком события
Click
элемента
Button
, не появляется. По существу пузырьковые маршрутизируемые события позволяют сложной группе содержимого действовать либо как единый логический элемент (например,
Button
), либо как отдельные элементы (скажем,
Ellipse
внутри
Button
).
Роль туннельных маршрутизируемых событий
Строго говоря, маршрутизируемые события по своей природе могут быть пузырьковыми (как было описано только что) или туннельными. Туннельные события (имена которых начинаются с префикса
Preview
— наподобие
PreviewMouseDown
) спускаются от самого верхнего элемента до внутренних областей определения дерева объектов. В общем и целом для каждого пузырькового события в библиотеках базовых классов WPF предусмотрено связанное туннельное событие, которое возникает перед его пузырьковым аналогом. Например, перед возникновением пузырькового события
MouseDown
сначала инициируется туннельное событие
PreviewMouseDown
.
Обработка туннельных событий выглядит очень похожей на обработку любых других событий: нужно просто указать имя обработчика события в разметке XAML (или при необходимости применить соответствующий синтаксис обработки событий C# в файле кода) и реализовать такой обработчик в коде. Для демонстрации взаимодействия туннельных и пузырьковых событий начните с организации обработки события
PreviewMouseDown
для объекта
outerEllipse
:
<Ellipse Name = "outerEllipse" Fill ="Green" Height ="25"