c# UWP 控件 Button （十）
（返回目录）
⚫按钮事件 （52）
| 事件 | 描述 | 返回值 | 继承自 |
| AccessKeyDisplay Dismissed |
在不应再显示访问键时发生。此事件通知元素隐藏访问键视觉效果。 | 1 | UIElement |
| AccessKeyDisplay Requested |
当用户请求显示访问key时发生。
此事件通知元素显示访问键视觉效果。 如果元素位于可见性属性设置为“折叠”的元素下，则不会引发此事件。 |
2 | UIElement |
| AccessKey Invoked |
当用户完成访问key序列时发生。
此事件表示应调用与访问key序列关联的操作。 访问键可以有一个或多个字符。只有当用户键入访问键的所有字符时，才会发生此事件。例如，如果AccessKey值为“BC”，则当用户按“B”时不会发生该事件。当用户按“B”，然后按“C”时，会发生此事件。此事件在按下键时发生，而不是在释放键时发生。 |
3 | UIElement |
| ActualTheme Changed |
在ActualTheme属性值更改时发生。 | 4 | Framework Element |
| BringInto ViewRequested |
在此元素或其子元素之一上调用StartBringIntoView时发生。
框架还可以通过键盘或游戏板响应元素接收焦点，或者当辅助技术在元素的自动化对等机上执行IScrollItemProvider的ScrollIntoView方法时引发事件。 |
5 | UIElement |
| Character Received |
在输入队列接收到单个组合字符时发生。
CharacterReceived是路由事件。有 启用输入法编辑器（IME）时，应用程序不会收到此事件。 对于文本输入方案（如增量搜索、增量查找或实时建议））非常有用，在这种情况下，当用户键入时，控件将根据输入队列中的字符逐步搜索和筛选文本 CharacterReceived事件可以在不同的时间发生，具体取决于输入的字符，因为在组合字符注册到输入队列中之前，不会触发该事件。 |
6 | UIElement |
| Click | 在单击 Button 时发生。
用户可以通过AccessText使用或Click在控件具有焦点时按 enter 键或空格键来引发事件。 |
7 | ButtonBase |
| Context Canceled |
当上下文输入姿态继续变为操纵姿态时发生，以通知元素不应打开上下文弹出按钮。路由事件。
当引发ContextRequired事件时引发此事件，但元素在操作开始之前未收到基于PointerReleased的事件。这表示用户打算调用操作而不是上下文弹出按钮，因此不应打开上下文弹出按钮。 |
8 | UIElement |
| Context Requested |
当用户完成上下文输入手势（如右键单击）时发生。路由事件。
如果ContextFlyout属性为空，则此事件标记为已处理。 |
9 | UIElement |
| DataContext Changed |
在此元素的数据上下文更改时发生。 | 10 | Framework Element |
| DoubleTapped | 在此元素的命中测试区域上发生未经处理的DoubleTap交互时发生。一个路由事件。
DoubleTapped事件表示一个手势，而PointerPressed事件是一个较低级别的输入事件。 |
11 | UIElement |
| DragEnter | 在输入系统报告出现以此元素为拖动目标的基础拖动事件时发生。 | 12 | UIElement |
| DragLeave | 在输入系统报告出现以此元素为拖动起点的基础拖动事件时发生。 | 13 | UIElement |
| DragOver | 在输入系统报告出现以此元素为可能放置目标的基础拖动事件时发生。 | 14 | UIElement |
| DragStarting | 在启动拖动操作时发生。路由事件。 | 15 | UIElement |
| Drop | 在输入系统报告出现将此元素作为放置目标的基础放置事件时发生。 | 16 | UIElement |
| DropCompleted | 此元素作为源的拖放操作结束时发生。
DragStarting之后，当拖动的元素被删除时，DropCompleted将在拖动源元素上升起。您可以处理此事件并基于事件参数中的DropResult采取适当的操作。例如，如果DropResult为Move，则应删除原始拖动源。 DragStarting和DropCompleted只有在CanDrag为true时才会引发。 |
17 | UIElement |
| Effective ViewportChanged |
在FrameworkElement的有效视区更改时发生。
滚动控件允许用户在比UI中可用空间更大的内容中进行平移/滚动。用户看到的内容部分称为视区。 EffectiveViewportChanged事件提供多条信息： --实际有效视区 --MaxViewport的计算 --BringIntoViewDistanceX和BringIntoViewDistanceY的标量值 要使框架知道滚动控件的视区，该控件以前必须使用UIElement.registerascrollport方法注册它。框架在确定有效的视区时使用注册元素的剪辑。 当滚动控件的视区更改时，它必须调用其InvalidateViewport方法来通知框架其视区已更改，并且需要将更改通知其侦听有效视区的任何子元素。 |
18 | Framework Element |
| FocusDisengaged | 当焦点从控制边界释放（用于游戏板/远程交互）时发生。
Focus engagement使使用游戏板或遥控器与应用程序交互变得更容易。 |
19 | Control |
| FocusEngaged | 当焦点限制在控制边界内（用于游戏板/远程交互）时发生。 | 20 | Control |
| GettingFocus | 在UIElement接收焦点之前发生。此事件是同步引发的，以确保在事件冒泡时焦点不会移动。
建议尽可能使用UIElement焦点路由事件，而不是FocusManager事件。 一次只能有一个UI元素有焦点。 当另一个控件失去焦点、应用程序视图更改、用户切换应用程序或用户与系统交互使应用程序不再位于前台时，控件可以获得焦点。 |
21 | UIElement |
| GotFocus | 在UIElement收到焦点时发生。此事件是异步引发的，因此可以在冒泡完成之前再次移动焦点。路由事件。
GotFocus没有任何专门的事件数据。在处理GotFocus的地方，可能需要确定是用户还是应用程序代码导致元素获得焦点。若要在处理程序中确定这一点，请将事件的发送者强制转换为控件对象，并检查FocusState。 |
22 | UIElement |
| Holding | 在此元素的命中测试区域上发生未处理的保持交互时发生。 Focus engagement使使用游戏板或遥控器与应用程序交互变得更容易。 | 23 | UIElement |
| IsEnabledChanged | 在此元素的 IsEnabled 属性值更改时发生。此成员是 CLR 事件，而不是路由事件。 | 24 | UIElement |
| KeyDown | 当焦点在该元素上时按下某个键后发生。
KeyDown 事件是较低级别的文本输入事件，可能不会在某些控件上按预期方式工作。 这是因为某些控件具有控件组合或类处理，可提供较高级别的文本输入处理和相关事件。 |
25 | UIElement |
| KeyUp | 当焦点在该元素上时松开某个键后发生。 | 26 | UIElement |
| LayoutUpdated | 在与当前 Dispatcher 关联的各种可视元素的布局更改时发生.此成员是 CLR 事件，而不是路由事件。 | 27 | UIElement |
| Loaded | 当对元素进行布局、呈现，且可将其用于交互时发生。
Loaded 通常是在元素初始化序列中引发的最后一个事件。 它将始终在 Initialized后引发。 |
28 | Framework Element |
| Loading | 开始加载FrameworkElement时发生。 | 29 | Framework Element |
| LosingFocus | 在UIElement失去焦点之前发生。此事件是同步引发的，以确保在事件冒泡时焦点不会移动。 | 30 | UIElement |
| LostFocus | 在UIElement失去焦点时发生。此事件是异步引发的，因此可以在冒泡完成之前再次移动焦点。 | 31 | UIElement |
| Manipulation Completed |
对于 UIElement 对象的操作和延时完毕时发生.您可以使用此事件来获取有关操作完成时的操作的信息 | 32 | UIElement |
| Manipulation Delta |
当输入设备在操作期间更改位置时发生。
当用户在操作过程中将手指拖动到屏幕上，并且发生惯性时，ManipulationDelta 事件发生多次。 您可以使用 IsInertial 属性检查是否在惯性期间发生事件。 |
33 | UIElement |
| Manipulation InertiaStarting |
当输入设备在操作期间与 UIElement 对象失去联系且延时开始时发生
当用户在操作过程中将所有手指从屏幕上提起时，将发生 ManipulationInertiaStarting 事件。 例如，如果用户在表面上 "抛出" UIElement，则用户将触摸 UIElement 以开始操作，在屏幕上将手指移动一小段，然后释放 UIElement。 当用户释放元素时，惯性将开始，并且 ManipulationInertiaStarting 事件发生 |
34 | UIElement |
| Manipulation Started |
当输入设备对 UIElement 对象开始操作时发生。
ManipulationStarted 事件发生在 ManipulationStarting 事件之后。 |
35 | UIElement |
| Manipulation Starting |
在首次创建操作处理器时发生。
当用户将手指放在 IsManipulationEnabled 属性设置为 true 时，将在该元素上发生 ManipulationStarting 事件。 |
36 | UIElement |
| NoFocus CandidateFound |
当用户尝试移动焦点（通过Tab或方向箭头）但由于在移动方向上找不到焦点候选对象而焦点不移动时发生。路由事件。 | 37 | UIElement |
| Pointer Canceled |
当异常失去指针时发生。
如果PointerCanceled激发，则释放该指针捕获的任何指针。 引发PointerCanceled事件的一些原因是： 更改显示区域关系的用户操作，例如更改分辨率或监视器设置； 输入交互，例如触笔与上一个触摸操作接触同一表面； 用户注销或类似的非特定于应用程序的中断； 同时接触的数目超过了设备支持的数目； |
38 | UIElement |
| Pointer CaptureLost |
此元素以前持有的指针捕获移动到另一个元素或其他位置时发生。 | 39 | UIElement |
| Pointer Entered |
当指针进入此元素的命中测试区域时发生 | 40 | UIElement |
| PointerExited | 当指针离开此元素的命中测试区域时发生。 | 41 | UIElement |
| PointerMoved | 当指针在该元素的命中测试区域内移动时发生。 | 42 | UIElement |
| Pointer Pressed |
当指针设备在此元素中启动按下操作时发生。 | 43 | UIElement |
| Pointer Released |
在此元素中释放以前启动按下操作的指针设备时发生。 | 44 | UIElement |
| Pointer WheelChanged |
指针控制盘的增量值更改时发生。 | 45 | UIElement |
| PreviewKeyDown | 当焦点在该元素上时按下某个键后发生。 | 46 | UIElement |
| PreviewKeyUp | 当焦点在该元素上时松开某个键后发生。 | 47 | UIElement |
| ProcessKeyboard Accelerators |
按下键盘快捷键（或快捷键）时发生。 | 48 | UIElement |
| RightTapped | 当指针位于元素上时右击输入时发生。 | 49 | UIElement |
| SizeChanged | 当此元素上的 ActualHeight 或 ActualWidth 属性的值发生更改时发生。 | 50 | UIElement |
| Tapped | 在此元素的命中测试区域上发生未处理的Tap交互时发生。
触摸、鼠标设备和笔设备都可以产生Tap动作。 |
51 | UIElement |
| Unloaded | 当从加载的元素的元素树中移除元素时发生。
由于用户启动的系统主题更改，Loaded 和 Unloaded 可能会在控件上引发。 主题更改会导致控件模板和包含的可视化树失效，这进而导致整个控件被卸载和重新加载。 因此，不能假定 Unloaded 仅在离开页面时才会发生。 请注意，在应用程序开始关闭后，不会引发 Unloaded 事件。 |
52 | Framework Element |
