WPF第四章事件与命令.doc

一、键盘类和键盘事件
WPF提供了基础的键盘类（System.Input.Keyboard类），该类提供与键盘相关的事件、方法和属性，这些事件、方法和属性提供有关键盘状态的信息。Keyboard的事件也通过UIElement等XAML基元素类的事件向外提供。
对于键盘操作，其常用的事件有两组：
· KeyDown事件和PreviewKeyDown事件：处理键盘键按下
· KeyUp事件和PreviewKeyUp事件：处理键盘键抬起
其中KeyDown和KeyUp事件属于冒泡路由事件，而PreviewKeyDown和PreviewKeyup属于隧道路由事件。
为了使元素能够接收键盘输入，该元素必须可获得焦点。默认情况下，大多数 UIElement 派生对象都可获得焦点。如果不是这样，则要使元素可获得焦点，请将基元素上的 Focusable 属性设置为 true。像 StackPanel 和 Canvas 这样的 Panel 类将 Focusable 的默认值设置为 false。因此，对要获取键盘焦点的这些对象而言，必须将 Focusable 设置为 true。
例如：在笔者的Notebook中有“静音”、“增大音量”、“减小音量”这三个快捷键，在一个应用程序的窗体上处理这三个键的点击可以：
1: <Window x:Class="InputCommandAndFocus.Window1"
2: xmlns="
3: xmlns:x="
4: Title="Window1" Height="300" Width="480"
5: Focusable="True" PreviewKeyDown="Window_PreviewKeyDown">
6: <Canvas>
7: <!-- ... -->
8: </Canvas>
9: </Window>
1: private void Window_PreviewKeyDown(object sender, KeyEventArgs e)
2: {
3: if (e.Key == Key.VolumeMute)
4: {
5: // 按下“静音”键
6: txtMessage.Text = "Mute";
7: e.Handled = true;
8: }
9: else if (e.Key == Key.VolumeUp)
10: {
11: // 按下“增大音量”键
12: txtMessage.Text = "Up";
13: e.Handled = true;
14: }
15: else if (e.Key == Key.VolumeDown)
16: {
17: // 按下“减小音量”键
18: txtMessage.Text = "Down";
19: e.Handled = true;
20: }
21: }
二、鼠标类和鼠标事件
WPF提供的System.Input.Mouse类提供与鼠标相关的事件、方法和属性，这些事件、方法和属性提供有关鼠标状态的信息。与Keyboard类类似，其事件也通过UIElement等基元素向外提供。
其事件主要有以下几组（每个事件均包含XXX冒泡路由事件和PreviewXXX隧道路由事件）
· MouseDown、MouseUp事件：处理鼠标键的按下与抬起
· MouseEnter、MouseLeave、MouseMove：处理鼠标进入、离开控件及在控件上移动
· MouseWheel：处理鼠标滚轮滚动
另外，对于鼠标位置的捕获，使用Mouse类的GetPosition方法，其参数是一个UIElement，表示其鼠标位置基于哪一个控件的坐标系。
例如，对于一个矩形图形，设置其鼠标的各种事件：
1: <Rectangle Canvas.Left="246" Canvas.Top="46" Height="118"
2: Name="mainRectangle" Stroke="Black" Width="200" Fill="White"
3: MouseEnter="mainRectangle_MouseEnter" MouseLeave="mainRectangle_MouseLeave"
4: MouseMove="mainRectangle_MouseMove" MouseDown="mainRectangle_MouseDown"
5: MouseWheel="mainRectangle_MouseWheel"/>
1: private void mainRectangle_MouseEnter(object sender, MouseEventArgs e)
2: {
3: // 鼠标进入控件时，控件的颜色为红色
4: mainRectangle.Fill = new SolidColorBrush(Colors.Red);
5: }
6: 
7: private void mainRectangle_MouseLeave(object sender, MouseEventArgs e)
8: {
9: // 鼠标离开控件时，控件的颜色为红色
10: mainRectangle.Fill = new SolidColorBrush(Colors.White);
11: }
12: 
13: private void mainRectangle_MouseMove(object sender, MouseEventArgs e)
14: {
15: // 获取基于Rectangle的鼠标的坐标
16: Point pointBaseRectangle = Mouse.GetPosition(mainRectangle);
17: txtMessage.Text = string.Format(
18: "Mouse Position (Base the Rectangle) is ({0},{1})",
19: pointBaseRectangle.X, pointBaseRectangle.Y);
20: 
21: txtMessage.Text += "\r\n";
22: 
23: // 获取基于窗体的鼠标的坐标
24: Point pointBaseWindow = Mouse.GetPosition(this);
25: txtMessage.Text += string.Format(
26: "Mouse Position (Base the Window) is ({0},{1})",
27: pointBaseWindow.X, pointBaseWindow.Y);
28: }
29: 
30: private void mainRectangle_MouseDown(object sender, MouseButtonEventArgs e)
31: {
32: // 获取点出的鼠标的按钮
33: MouseButton button = e.ChangedButton;
34: 
35: txtMessage.Text += "\r\n";
36: txtMessage.Text += string.Format(
37: " Mouse Button is {0}", button.ToString());
38: }
39: 
40: private void mainRectangle_MouseWheel(object sender, MouseWheelEventArgs e)
41: {
42: if (e.Delta > 0)
43: {
44: // 如果向上推动滚轮，图形的宽度增加
45: rectangle1.Width++;
46: }
47: 
48: if (e.Delta < 0)
49: {
50: // 如果向下推动滚轮，图形的宽度减小
51: rectangle1.Width--;
52: }
53: }
三、焦点处理
在 WPF 中，有两个与焦点有关的主要概念：键盘焦点和逻辑焦点。 键盘焦点指接收键盘输入的元素，而逻辑焦点指焦点范围中具有焦点的元素。
1、键盘焦点：
键盘焦点指当前正在接收键盘输入的元素。 在整个桌面上，只能有一个具有键盘焦点的元素。 在 WPF 中，具有键盘焦点的元素会将 IsKeyboardFocused 设置为 true。 Keyboard 类的静态属性 FocusedElement 获取当前具有键盘焦点的元素。
为了使元素能够获取键盘焦点，基元素的 Focusable 和 IsVisible 属性必须设置为 true。 有些类（如 Panel 基类）默认情况下将 Focusable 设置为 false；因此，如果您希望此类元素能够获取键盘焦点，必须将 Focusable 设置为 true。
可以通过用户与 UI 交互（例如，按 Tab 键定位到某个元素或者在某些元素上单击鼠标）来获取键盘焦点。 还可以通过使用 Keyboard 类的 Focus 方法，以编程方式获取键盘焦点。 Focus 方法尝试将键盘焦点给予指定的元素。 返回的元素是具有键盘焦点的元素，如果有旧的或新的焦点对象阻止请求，则具有键盘焦点的元素可能不是所请求的元素。
2、逻辑焦点
逻辑焦点指焦点范围中的 FocusManager..::.FocusedElement。 焦点范围是一个跟踪其范围内的 FocusedElement 的元素。 当键盘焦点离开焦点范围时，焦点元素会失去键盘焦点，但保留逻辑焦点。 当键盘焦点返回到焦点范围时，焦点元素会再次获得键盘焦点。 这使得键盘焦点可以在多个焦点范围之间切换，但确保了在焦点返回到焦点范围时，焦点范围中的焦点元素再次获得键盘焦点。
一个应用程序中可以有多个具有逻辑焦点的元素，但在一个特定的焦点范围中只能有一个具有逻辑焦点的元素。
GetFocusScope 返回指定元素的焦点范围。
WPF 中默认情况下即为焦点范围的类有 Window、MenuItem、ToolBar 和 ContextMenu。
GetFocusedElement 获取指定焦点范围的焦点元素。SetFocusedElement 设置指定焦点范围中的焦点元素。SetFocusedElement 通常用于设置初始焦点元素。
3、键盘导航
当按下导航键之一时，KeyboardNavigation 类将负责实现默认键盘焦点导航。 导航键有：Tab、Shift+Tab、Ctrl+Tab、Ctrl+Shift+Tab、向上键、向下键、向左键和向右键。
可以通过设置附加的 KeyboardNavigation 属性 TabNavigation、ControlTabNavigation 和 DirectionalNavigation 来更改导航容器的导航行为。 这些属性是 KeyboardNavigationMode 类型，可能值有 Continue、Local、Contained、Cycle、Once 以及 None。 默认值是 Continue，这意味着元素不是导航容器。
4、焦点事件
与键盘焦点相关的事件有 PreviewGotKeyboardFocus、GotKeyboardFocus、PreviewLostKeyboardFocus 以及 LostKeyboardFocus。 这些事件定义为 Keyboard 类的附加事件，但更便于作为基元素类上的等效路由事件来访问。
当元素获取键盘焦点时，会引发 GotKeyboardFocus。当元素失去键盘焦点时，会引发 LostKeyboardFocus。 如果处理了 PreviewGotKeyboardFocus 事件或 PreviewLostKeyboardFocusEvent 事件，并且 Handled 设置为 true，则焦点将不会改变。
WPF中的命令路由与事件路由是两个很让初学者头痛的概念，对于命令路由可以理解为，系统（WPF）定义了一系列的操作，在应用程序中可以直接使用。例如，定义一系列菜单，执行对窗体中文本框的复制、剪切、粘贴操作，简单地可以这样做：
1: <Grid>
2: <Grid.RowDefinitions>
3: <RowDefinition Height="23" />
4: <RowDefinition />
5: </Grid.RowDefinitions>
6: <Menu Grid.Row="0" Grid.Column="0">
7: <MenuItem Header="Edit">
8: <MenuItem x:Name="menuCopy" Header="Copy"
9: Command="ApplicationCommands.Copy" />
10: <MenuItem x:Name="menuCut" Header="Cut"
11: Command="ApplicationCommands.Cut" />
12: <MenuItem x:Name="menuPaste" Header="Paste"
13: Command="ApplicationCommands.Paste" />
14: </MenuItem>
15: </Menu>
16: <TextBox Grid.Row="1" Grid.Column="0" x:Name="mainText"
17: TextWrapping="Wrap" AcceptsReturn="True" />
18: </Grid>
WPF 中的路由命令模型可以分为四个主要概念：命令、命令源、命令目标以及命令绑定：
· 命令是要执行的操作。在本例中命令为ApplicationCommands.Copy、Cut、Paste
· 命令源是调用命令的对象。 在本例中命令源为三个MenuItem控件
· 命令目标是在其上执行命令的对象。 在本例中命令目标是mainText这个TextBox文本框
· 命令绑定是将命令逻辑映射到命令的对象。 在本例中命令绑定到系统定义的对于文本框的“复制”、“剪切”、“粘贴”操作、
其四者的关系如下图所示：

一、命令：
WPF 中的命令是通过实现 ICommand 接口来创建的。ICommand 公开两个方法（Execute 和 CanExecute）和一个事件 (CanExecuteChanged)。Execute 执行与命令关联的操作。CanExecute 确定是否可以在当前命令目标上执行命令。如果集中管理命令操作的命令管理器检测到命令源中发生了更改，此更改可能使得已引发但尚未由命令绑定执行的命令无效，则将引发 CanExecuteChanged。ICommand 的 WPF 实现是 RoutedCommand 类。
RoutedCommand 上的 Execute 方法在命令目标上引发 PreviewExecuted 和 Executed 事件。RoutedCommand 上的 CanExecute 方法在命令目标上引发 CanExecute 和 PreviewCanExecute 事件。这些事件沿元素树以隧道和冒泡形式传递，直到遇到具有该特定命令的 CommandBinding 的对象。
WPF 提供了一组常用的路由命令，这组命令分布在几个类中：MediaCommands、ApplicationCommands、NavigationCommands、ComponentCommands 和 EditingCommands。这些类仅包含 RoutedCommand 对象，而不包含命令的实现逻辑。实现逻辑由在其上执行命令的对象负责。
WPF已封装的命令类有：
命令类
示例命令
ApplicationCommands
Close、Cut、Copy、Paste、Save、Print
NavigationCommands
BrowseForward、BrowseBack、Zoom、Search
EditingCommands
AlignXXX、MoveXXX、SelectXXX
MediaCommands
Play、Pause、NextTrack、IncreaseVolume、Record、Stop
ComponentCommands
MoveXXX、SelectXXX、ScrollXXX、ExtendSelectionXXX
XXX 代表操作的集合，例如 MoveNext 和 MovePrevious。其中ApplicationCommands为默认的命令类，引用其中的命令时可以省略ApplicationCommands。
二、命令源
命令源是调用命令的对象。例如，MenuItem、Button 和 KeyGesture 就是命令源。
WPF 中的命令源通常实现 ICommandSource 接口。
ICommandSource 公开三个属性：Command、CommandTarget 和 CommandParameter：
· Command 是在调用命令源时执行的命令。
· CommandTarget 是要在其上执行命令的对象。值得注意的是，在 WPF 中，ICommandSource 上的 CommandTarget 属性只有在 ICommand 是 RoutedCommand 时才适用。如果在 ICommandSource 上设置了 CommandTarget，而对应的命令不是 RoutedCommand，将会忽略命令目标。如果未设置 CommandTarget，则具有键盘焦点的元素将是命令目标。
· CommandParameter 是用户定义的数据类型，用于将信息传递到实现命令的处理程序。
实现 ICommandSource 的 WPF 类包括：ButtonBase、MenuItem、Hyperlink 以及 InputBinding。ButtonBase、MenuItem 和 Hyperlink 在被单击时调用命令，InputBinding 在与之关联的 InputGesture 执行时调用命令。
ButtonBase等直接使用控件的Command属性绑定命令：
1: <Button Command="ApplicationCommands.Copy" />
而InputBinding使用KeyBinding或MouseBinding绑定特定的输入手势到某一命令上：
例如在Window上注册Ctrl+F2快捷键到ApplicationCommands.Open上：
1: <KeyBinding Command="ApplicationCommands.Open"
2: Key="F2" Modifiers="Control" />
三、命令目标

命令目标是在其上执行命令的元素。对于 RoutedCommand 而言，命令目标是 Executed 和 CanExecute 的路由的起始元素。前面已提到，在 WPF 中，ICommandSource 上的 CommandTarget 属性只有在 ICommand 是一个 RoutedCommand 时才适用。如果在 ICommandSource 上设置了 CommandTarget，而对应的命令不是 RoutedCommand，将会忽略命令目标。
命令源可以显式设置命令目标。如果未定义命令目标，则具有键盘焦点的元素将用作命令目标。将具有键盘焦点的元素用作命令目标的一个好处是，应用程序开发人员可以使用同一个命令源在多个目标上调用命令，而不必跟踪命令目标。例如，如果 MenuItem 在具有一个 TextBox 控件和一个 PasswordBox 控件的应用程序中调用“粘贴”命令，则目标既可以是 TextBox，也可以是 PasswordBox，具体取决于哪个控件具有键盘焦点。
如将Paste命令设置到mainText控件上：
1: <MenuItem x:Name="menuPaste" Header="Paste"
2: Command="ApplicationCommands.Paste"
3: CommandTarget="{Binding ElementName=txtMain}"/>
四、命令绑定
CommandBinding 将一个命令与实现该命令的事件处理程序关联。
CommandBinding 类包含一个 Command 属性以及 PreviewExecuted、Executed、PreviewCanExecute 和 CanExecute 事件。
Command 是 CommandBinding 要与之关联的命令。附加到 PreviewExecuted 和 Executed 事件的事件处理程序实现命令逻辑。附加到 PreviewCanExecute 和 CanExecute 事件的事件处理程序确定命令是否可以在当前命令目标上执行。
· CanExecute事件和PreviewCanExecute事件，通过其EventArgs参数中的CanExecute属性，设置其命令是否可以执行，并且系统会自动的和命令目标的某些特定属性进行绑定，例如Button、MenuItem等在CanExecute属性的值设为False时，会“灰化”，不可用
· Executed事件和PreviewExecuted事件的代码，是执行命令的真正代码。
例如，将ApplicationCommans.Save绑定到菜单栏的Save菜单项中，并在文本框中没有任何文本时不可用：
1: <Window x:Class="InputCommandAndFocus.WinCommandDemo"
2: xmlns="
3: xmlns:x="
4: Title="WinCommandDemo" Height="300" Width="300" Focusable="True">
5: <Window.InputBindings>
6: <KeyBinding Command="ApplicationCommands.Save"
7: Key="F3" Modifiers="Control" />
8: </Window.InputBindings>
9: <Window.CommandBindings>
10: <CommandBinding Command="ApplicationCommands.Save"
11: CanExecute="CommandBinding_Save_CanExecute"
12: Executed="CommandBinding_Save_Executed" />
13: </Window.CommandBindings>
14: <Grid>
15: <Grid.RowDefinitions>
16: <RowDefinition Height="23" />
17: <RowDefinition />
18: </Grid.RowDefinitions>
19: <Menu Grid.Row="0" Grid.Column="0">
20: <MenuItem Header="File">
21: <MenuItem x:Name="menuSave" Header="Save"
22: Command="ApplicationCommands.Save" />
23: </MenuItem>
24: </Menu>
25: <TextBox Grid.Row="1" Grid.Column="0" x:Name="mainText"
26: TextWrapping="Wrap" AcceptsReturn="True" />
27: </Grid>
28: </Window>
1: private void CommandBinding_Save_CanExecute(object sender, CanExecuteRoutedEventArgs e)
2: {
3: if (mainText.Text == string.Empty)
4: {
5: // 如果文本框中没有任何文本，则不可以保存
6: e.CanExecute = false;
7: }
8: else
9: {
10: e.CanExecute = true;
11: }
12: }
13: 
14: private void CommandBinding_Save_Executed(object sender, ExecutedRoutedEventArgs e)
15: {
16: // 保存文件对话框
17: SaveFileDialog save = new SaveFileDialog();
18: save.Filter = "文本文件|*.txt|所有文件|*.*";
19: 
20: bool? result = save.ShowDialog();
21: if (result.Value)
22: {
23: // 执行保存文件操作
24: }
25: }