WPF and Silverlight 学习笔记(十四):键盘输入、鼠标输入、焦点处理
一、键盘类和键盘事件
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="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
3: xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
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,则焦点将不会改变。