NavigationWindow 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示支持内容导航的窗口。
public ref class NavigationWindow : System::Windows::Windowpublic ref class NavigationWindow : System::Windows::Window, System::Windows::Markup::IUriContext[System.Windows.Markup.ContentProperty]
[System.Windows.TemplatePart(Name="PART_NavWinCP", Type=typeof(System.Windows.Controls.ContentPresenter))]
public class NavigationWindow : System.Windows.Window[System.Windows.Markup.ContentProperty]
[System.Windows.TemplatePart(Name="PART_NavWinCP", Type=typeof(System.Windows.Controls.ContentPresenter))]
public class NavigationWindow : System.Windows.Window, System.Windows.Markup.IUriContext[<System.Windows.Markup.ContentProperty>]
[<System.Windows.TemplatePart(Name="PART_NavWinCP", Type=typeof(System.Windows.Controls.ContentPresenter))>]
type NavigationWindow = class
inherit Window[<System.Windows.Markup.ContentProperty>]
[<System.Windows.TemplatePart(Name="PART_NavWinCP", Type=typeof(System.Windows.Controls.ContentPresenter))>]
type NavigationWindow = class
inherit Window
interface IUriContextPublic Class NavigationWindow
Inherits WindowPublic Class NavigationWindow
Inherits Window
Implements IUriContext- 继承
-
NavigationWindow
- 属性
- 实现
示例
以下示例演示如何创建 NavigationWindow。
<NavigationWindow
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
x:Class="MainWindow"
Title="NavigationWindow Sample"
Source="http://www.microsoft.com" />
注解
NavigationWindow 派生自 Window，并扩展它，并能够导航到和显示内容。
内容可以是任何 .NET Framework 对象或 HTML 文件。 但是，一般情况下，Page 对象是打包导航内容的首选方法。
可以通过使用所需内容的 URI 设置 Source 属性来导航到内容。 此外，可以使用以下 Navigate 方法的重载之一来导航到内容：
当内容通过 URI 导航到时，NavigationWindow 将返回包含该内容的对象。
注意
按 URI 导航还支持导航到内容片段。 请参阅 FragmentNavigation。
或者，可以使用接受对象的 Navigate 方法重载之一导航到内容：
导航的生存期可以通过以下事件进行跟踪：
并不是每次发生导航时都会引发所有事件;引发的事件集由发生的导航类型（内容或内容片段）以及导航完成方式（已取消、停止或失败）确定。
下图说明了这些事件将触发的顺序：
在导航期间或之后，NavigationWindow 提供有关要导航到的内容的信息，包括导航到的内容的 URI（Source）、当前内容的 URI（CurrentSource），以及包含导航到的内容的对象（Content）。
导航到内容时，NavigationWindow 将导航记录为导航历史记录中的条目。 当发生新导航时，通过调用 Navigate 方法或通过调用 GoForward导航到前向导航历史记录中的条目，将条目添加到后退导航历史记录。 通过调用 GoBack导航到后退导航历史记录中的条目，将条目添加到前向导航历史记录。 CanGoBack 和 CanGoForward 分别报告后退导航历史记录和前向导航历史记录中是否有条目。
第一次从另一段内容导航到某个内容时，NavigationWindow 会自动显示导航 UI，允许用户在导航历史记录中向前导航。 可以通过设置 ShowsNavigationUI 属性来配置导航 UI 的显示时间。
可以通过调用 RemoveBackEntry来删除后退导航历史记录中的最新条目。
NavigationWindow 不会在导航历史记录中存储内容对象的实例。 相反，NavigationWindow 每次使用导航历史记录导航到内容对象时，都会创建内容对象的新实例。 此行为旨在避免在导航到大量内容和大量内容时占用过多的内存。 因此，从一个导航到下一个导航，不会记住内容的状态。 但是，WPF 提供了几种技术，你可以通过这些技术在导航历史记录中存储一段内容的状态。
使用 AddBackEntry，还可以记住单页实例的多个状态集。
NavigationWindow 是 WPF 中的两个导航器之一，另一个是 Frame。 从本质上讲，导航器是一个支持导航和导航历史记录的类。 从视觉上看，XBAP 使用 Internet Explorer 作为导航器，以提供集成的用户体验。 但是，XBAP 实际上使用 NavigationWindow 作为导航器;Internet Explorer 中运行的 XBAP 的 MainWindow 属性将返回对 NavigationWindow的引用，由 NavigationWindow 管理的导航历史记录与 Internet Explorer 管理的导航历史记录集成。
内容模型：NavigationWindow 是 ContentControl，这意味着 NavigationWindow 可以包含文本、图像或面板等内容。 此外，NavigationWindow 是根元素，因此不能是另一个元素内容的一部分。 有关 Button的内容模型的详细信息，请参阅 WPF 内容模型。
自定义 NavigationWindow 控件
若要将相同的属性设置应用于多个 NavigationWindow 控件，请使用 Style 属性。 可以修改默认 ControlTemplate，使控件具有唯一的外观。 有关创建 ControlTemplate的详细信息，请参阅 通过创建 ControlTemplate自定义现有控件的外观。 若要查看特定于 NavigationWindow的部件和状态，请参阅 NavigationWindow 样式和模板。
此控件的依赖属性可能由控件的默认样式设置。 如果属性是按默认样式设置的，则当控件出现在应用程序中时，该属性可能会从其默认值更改。 默认样式取决于应用程序运行时使用哪个桌面主题。
注意
如果控件的默认模板中同时存在该属性，并且通过使用 templateBinding设置
构造函数
| NavigationWindow() |
初始化 NavigationWindow 类的新实例。 |
字段
| BackStackProperty |
标识 BackStack 依赖属性。 |
| CanGoBackProperty |
标识 CanGoBack 依赖属性。 |
| CanGoForwardProperty |
标识 CanGoForward 依赖属性。 |
| ForwardStackProperty |
标识 ForwardStack 依赖属性。 |
| SandboxExternalContentProperty |
标识 SandboxExternalContent 依赖属性。 |
| ShowsNavigationUIProperty |
标识 ShowsNavigationUI 依赖属性。 |
| SourceProperty |
标识 Source 依赖属性。 |
属性
| ActualHeight |
获取此元素的呈现高度。 (继承自 FrameworkElement) |
| ActualWidth |
获取此元素的呈现宽度。 (继承自 FrameworkElement) |
| AllowDrop |
获取或设置一个值，该值指示此元素是否可以用作拖放操作的目标。 这是一个依赖属性。 (继承自 UIElement) |
| AllowsTransparency |
获取或设置一个值，该值指示窗口的工作区是否支持透明度。 (继承自 Window) |
| AreAnyTouchesCaptured |
获取一个值，该值指示是否至少捕获到此元素的一个触摸。 (继承自 UIElement) |
| AreAnyTouchesCapturedWithin |
获取一个值，该值指示是否至少捕获一个触摸到此元素或其可视化树中的任何子元素。 (继承自 UIElement) |
| AreAnyTouchesDirectlyOver |
获取一个值，该值指示是否在此元素上按下至少一次触摸。 (继承自 UIElement) |
| AreAnyTouchesOver |
获取一个值，该值指示是否在该元素或其可视化树中的任何子元素上按下至少一个触摸。 (继承自 UIElement) |
| Background |
获取或设置描述控件背景的画笔。 (继承自 Control) |
| BackStack |
获取用于枚举 NavigationWindow的后退导航历史记录中的条目的 IEnumerable。 |
| BindingGroup |
获取或设置用于元素的 BindingGroup。 (继承自 FrameworkElement) |
| BitmapEffect |
已过时.
已过时.
获取或设置直接应用于此元素的呈现内容的位图效果。 这是一个依赖属性。 (继承自 UIElement) |
| BitmapEffectInput |
已过时.
已过时.
获取或设置位图效果的输入源，该效果直接应用于此元素的呈现内容。 这是一个依赖属性。 (继承自 UIElement) |
| BorderBrush |
获取或设置描述控件边框背景的画笔。 (继承自 Control) |
| BorderThickness |
获取或设置控件的边框粗细。 (继承自 Control) |
| CacheMode |
获取或设置 UIElement的缓存表示形式。 (继承自 UIElement) |
| CanGoBack |
获取一个值，该值指示后退导航历史记录中是否至少有一个条目。 |
| CanGoForward |
获取一个值，该值指示前向导航历史记录中是否至少有一个条目。 |
| Clip |
获取或设置用于定义元素内容的轮廓的几何图形。 这是一个依赖属性。 (继承自 UIElement) |
| ClipToBounds |
获取或设置一个值，该值指示是剪辑此元素的内容（还是来自此元素的子元素的内容），以适应包含元素的大小。 这是一个依赖属性。 (继承自 UIElement) |
| CommandBindings |
获取与此元素关联的 CommandBinding 对象的集合。 CommandBinding 启用此元素的命令处理，并声明命令、其事件和此元素附加的处理程序之间的链接。 (继承自 UIElement) |
| Content |
获取或设置 ContentControl的内容。 (继承自 ContentControl) |
| ContentStringFormat |
获取或设置一个复合字符串，该字符串指定如何在 Content 属性显示为字符串时设置其格式。 (继承自 ContentControl) |
| ContentTemplate |
获取或设置用于显示 ContentControl内容的数据模板。 (继承自 ContentControl) |
| ContentTemplateSelector |
获取或设置一个模板选择器，该选择器使应用程序编写器能够提供自定义模板选择逻辑。 (继承自 ContentControl) |
| ContextMenu |
获取或设置上下文菜单元素，该元素应在通过用户界面（UI）从此元素中请求上下文菜单时显示。 (继承自 FrameworkElement) |
| CurrentSource |
获取上次导航到的内容的统一资源标识符（URI）。 |
| Cursor |
获取或设置当鼠标指针位于此元素上时显示的光标。 (继承自 FrameworkElement) |
| DataContext |
获取或设置元素参与数据绑定时的数据上下文。 (继承自 FrameworkElement) |
| DefaultStyleKey |
获取或设置用于引用此控件的样式的键，当使用或定义主题样式时。 (继承自 FrameworkElement) |
| DependencyObjectType |
获取包装此实例的 CLR 类型的 DependencyObjectType。 (继承自 DependencyObject) |
| DesiredSize |
获取此元素在布局过程的度量传递期间计算的大小。 (继承自 UIElement) |
| DialogResult |
获取或设置对话框结果值，该值是从 ShowDialog() 方法返回的值。 (继承自 Window) |
| Dispatcher |
获取与此 DispatcherObject 关联的 Dispatcher。 (继承自 DispatcherObject) |
| Effect |
获取或设置要应用于 UIElement的位图效果。 这是一个依赖属性。 (继承自 UIElement) |
| FlowDirection |
获取或设置文本和其他用户界面（UI）元素在控制布局的任何父元素中流动的方向。 (继承自 FrameworkElement) |
| Focusable |
获取或设置一个值，该值指示元素是否可以接收焦点。 这是一个依赖属性。 (继承自 UIElement) |
| FocusVisualStyle |
获取或设置一个属性，该属性允许自定义在捕获键盘焦点时应用于此元素的外观、效果或其他样式特征。 (继承自 FrameworkElement) |
| FontFamily |
获取或设置控件的字体系列。 (继承自 Control) |
| FontSize |
获取或设置字号。 (继承自 Control) |
| FontStretch |
获取或设置字体在屏幕上凝结或展开的程度。 (继承自 Control) |
| FontStyle |
获取或设置字体样式。 (继承自 Control) |
| FontWeight |
获取或设置指定字体的粗细或粗细。 (继承自 Control) |
| ForceCursor |
获取或设置一个值，该值指示此 FrameworkElement 是否应强制用户界面（UI）呈现由 Cursor 属性声明的游标。 (继承自 FrameworkElement) |
| Foreground |
获取或设置描述前景色的画笔。 (继承自 Control) |
| ForwardStack |
获取用于枚举 NavigationWindow的后退导航历史记录中的条目的 IEnumerable。 |
| HandlesScrolling |
获取一个值，该值指示控件是否支持滚动。 (继承自 Control) |
| HasAnimatedProperties |
获取一个值，该值指示此元素是否具有任何动画属性。 (继承自 UIElement) |
| HasContent |
获取一个值，该值指示 ContentControl 是否包含内容。 (继承自 ContentControl) |
| HasEffectiveKeyboardFocus |
获取一个值，该值指示 UIElement 是否具有焦点。 (继承自 UIElement) |
| Height |
获取或设置元素的建议高度。 (继承自 FrameworkElement) |
| HorizontalAlignment |
获取或设置在父元素（如面板或项控件）内组合时应用于此元素的水平对齐特征。 (继承自 FrameworkElement) |
| HorizontalContentAlignment |
获取或设置控件内容的水平对齐方式。 (继承自 Control) |
| Icon |
获取或设置窗口的图标。 (继承自 Window) |
| InheritanceBehavior |
获取或设置属性值继承、资源键查找和 RelativeSource FindAncestor 查找的范围限制。 (继承自 FrameworkElement) |
| InputBindings |
获取与此元素关联的输入绑定的集合。 (继承自 UIElement) |
| InputScope |
获取或设置此 FrameworkElement使用的输入的上下文。 (继承自 FrameworkElement) |
| IsActive |
获取一个值，该值指示窗口是否处于活动状态。 (继承自 Window) |
| IsArrangeValid |
获取一个值，该值指示此元素布局中子元素的计算大小和位置是否有效。 (继承自 UIElement) |
| IsEnabled |
获取或设置一个值，该值指示是否在用户界面（UI）中启用此元素。 这是一个依赖属性。 (继承自 UIElement) |
| IsEnabledCore |
获取一个值，该值将成为派生类中 IsEnabled 的返回值。 (继承自 UIElement) |
| IsFocused |
获取一个值，该值确定此元素是否具有逻辑焦点。 这是一个依赖属性。 (继承自 UIElement) |
| IsHitTestVisible |
获取或设置一个值，该值声明此元素是否可以作为其呈现内容的某些部分的命中测试结果返回。 这是一个依赖属性。 (继承自 UIElement) |
| IsInitialized |
获取一个值，该值指示此元素是在 XAML 处理器处理期间还是显式调用其 EndInit() 方法进行初始化。 (继承自 FrameworkElement) |
| IsInputMethodEnabled |
获取一个值，该值指示是否启用输入法系统（如输入法编辑器（IME）来处理此元素的输入。 (继承自 UIElement) |
| IsKeyboardFocused |
获取一个值，该值指示此元素是否具有键盘焦点。 这是一个依赖属性。 (继承自 UIElement) |
| IsKeyboardFocusWithin |
获取一个值，该值指示键盘焦点是元素或其可视化树子元素中的任意位置。 这是一个依赖属性。 (继承自 UIElement) |
| IsLoaded |
获取一个值，该值指示是否已加载此元素以供演示。 (继承自 FrameworkElement) |
| IsManipulationEnabled |
获取或设置一个值，该值指示是否在此 UIElement上启用操作事件。 (继承自 UIElement) |
| IsMeasureValid |
获取一个值，该值指示布局度量值返回的当前大小是否有效。 (继承自 UIElement) |
| IsMouseCaptured |
获取一个值，该值指示是否将鼠标捕获到此元素。 这是一个依赖属性。 (继承自 UIElement) |
| IsMouseCaptureWithin |
获取一个值，该值确定鼠标捕获是由此元素还是由其可视化树中的子元素保存。 这是一个依赖属性。 (继承自 UIElement) |
| IsMouseDirectlyOver |
获取一个值，该值指示鼠标指针的位置是否对应于命中测试结果，这将考虑元素组合。 这是一个依赖属性。 (继承自 UIElement) |
| IsMouseOver |
获取一个值，该值指示鼠标指针是否位于此元素上（包括可视化树中的子元素）。 这是一个依赖属性。 (继承自 UIElement) |
| IsSealed |
获取一个值，该值指示此实例当前是否密封（只读）。 (继承自 DependencyObject) |
| IsStylusCaptured |
获取一个值，该值指示触笔是否由此元素捕获。 这是一个依赖属性。 (继承自 UIElement) |
| IsStylusCaptureWithin |
获取一个值，该值确定触笔捕获是由此元素保留的，还是由元素边界及其可视化树中的元素保存。 这是一个依赖属性。 (继承自 UIElement) |
| IsStylusDirectlyOver |
获取一个值，该值指示触笔位置是否对应于命中测试结果，这将考虑元素组合。 这是一个依赖属性。 (继承自 UIElement) |
| IsStylusOver |
获取一个值，该值指示触笔游标是否位于此元素上（包括可视子元素）。 这是一个依赖属性。 (继承自 UIElement) |
| IsTabStop |
获取或设置一个值，该值指示控件是否包含在选项卡导航中。 (继承自 Control) |
| IsVisible |
获取一个值，该值指示此元素是否在用户界面（UI）中可见。 这是一个依赖属性。 (继承自 UIElement) |
| Language |
获取或设置应用于元素的本地化/全球化语言信息。 (继承自 FrameworkElement) |
| LayoutTransform |
获取或设置一个图形转换，该转换应在执行布局时应用于此元素。 (继承自 FrameworkElement) |
| Left |
获取或设置窗口左边缘相对于桌面的位置。 (继承自 Window) |
| LogicalChildren |
获取窗口逻辑子元素的枚举器。 (继承自 Window) |
| Margin |
获取或设置元素的外部边距。 (继承自 FrameworkElement) |
| MaxHeight |
获取或设置元素的最大高度约束。 (继承自 FrameworkElement) |
| MaxWidth |
获取或设置元素的最大宽度约束。 (继承自 FrameworkElement) |
| MinHeight |
获取或设置元素的最小高度约束。 (继承自 FrameworkElement) |
| MinWidth |
获取或设置元素的最小宽度约束。 (继承自 FrameworkElement) |
| Name |
获取或设置元素的标识名称。 该名称提供引用，以便代码隐藏（如事件处理程序代码）可以在 XAML 处理器处理期间构造标记元素后引用它。 (继承自 FrameworkElement) |
| NavigationService |
获取此 NavigationWindow 用于向其内容提供导航服务的 NavigationService。 |
| Opacity |
获取或设置在用户界面（UI）中呈现时应用于整个 UIElement 的不透明度因子。 这是一个依赖属性。 (继承自 UIElement) |
| OpacityMask |
获取或设置不透明度掩码，作为应用于此元素呈现内容的任何 alpha 通道掩码的 Brush 实现。 这是一个依赖属性。 (继承自 UIElement) |
| OverridesDefaultStyle |
获取或设置一个值，该值指示此元素是否包含主题样式中的样式属性。 (继承自 FrameworkElement) |
| OwnedWindows |
获取此窗口是所有者的窗口的集合。 (继承自 Window) |
| Owner | (继承自 Window) |
| Padding |
获取或设置控件内的填充。 (继承自 Control) |
| Parent |
获取此元素的逻辑父元素。 (继承自 FrameworkElement) |
| PersistId |
已过时.
获取唯一标识此元素的值。 (继承自 UIElement) |
| RenderSize |
获取（或设置）此元素的最终呈现大小。 (继承自 UIElement) |
| RenderTransform |
获取或设置影响此元素呈现位置的转换信息。 这是一个依赖属性。 (继承自 UIElement) |
| RenderTransformOrigin |
获取或设置由 RenderTransform声明的任何可能的呈现转换的中心点，相对于元素的边界。 这是一个依赖属性。 (继承自 UIElement) |
| ResizeMode |
获取或设置调整大小模式。 (继承自 Window) |
| Resources |
获取或设置本地定义的资源字典。 (继承自 FrameworkElement) |
| RestoreBounds |
获取窗口的大小和位置，然后再最小化或最大化。 (继承自 Window) |
| SandboxExternalContent |
获取或设置一个值，该值指示 NavigationWindow 是否隔离部分信任安全沙盒（具有默认 Internet 区域权限集）中的外部可扩展应用程序标记语言（XAML）内容。 |
| ShowActivated |
获取或设置一个值，该值指示在首次显示时是否激活窗口。 (继承自 Window) |
| ShowInTaskbar |
获取或设置一个值，该值指示窗口是否具有任务栏按钮。 (继承自 Window) |
| ShowsNavigationUI |
获取或设置一个值，该值指示 NavigationWindow 是否显示其导航 UI。 |
| SizeToContent |
获取或设置一个值，该值指示窗口是否自动调整自身大小以适应其内容的大小。 (继承自 Window) |
| SnapsToDevicePixels |
获取或设置一个值，该值确定此元素的呈现是否应在呈现过程中使用特定于设备的像素设置。 这是一个依赖属性。 (继承自 UIElement) |
| Source |
获取或设置当前内容的统一资源标识符（URI），或当前导航到的新内容的 URI。 |
| Style |
获取或设置呈现时此元素使用的样式。 (继承自 FrameworkElement) |
| StylusPlugIns |
获取与此元素关联的所有触笔插件（自定义）对象的集合。 (继承自 UIElement) |
| TabIndex |
获取或设置一个值，该值确定当用户使用 TAB 键浏览控件时元素接收焦点的顺序。 (继承自 Control) |
| Tag |
获取或设置可用于存储有关此元素的自定义信息的任意对象值。 (继承自 FrameworkElement) |
| TaskbarItemInfo |
获取或设置 Window的 Windows 7 任务栏缩略图。 (继承自 Window) |
| Template |
获取或设置控件模板。 (继承自 Control) |
| TemplatedParent |
获取对此元素的模板父级的引用。 如果未通过模板创建元素，则此属性不相关。 (继承自 FrameworkElement) |
| Title |
获取或设置窗口的标题。 (继承自 Window) |
| ToolTip |
获取或设置用户界面 （UI） 中为此元素显示的工具提示对象。 (继承自 FrameworkElement) |
| Top |
获取或设置窗口上边缘相对于桌面的位置。 (继承自 Window) |
| Topmost |
获取或设置一个值，该值指示窗口是否以最顶层 z 顺序显示。 (继承自 Window) |
| TouchesCaptured |
获取捕获到此元素的所有触摸设备。 (继承自 UIElement) |
| TouchesCapturedWithin |
获取捕获到此元素的所有触摸设备或其可视化树中的任何子元素。 (继承自 UIElement) |
| TouchesDirectlyOver |
获取此元素上的所有触摸设备。 (继承自 UIElement) |
| TouchesOver |
获取位于此元素上的所有触摸设备或其可视化树中的任何子元素。 (继承自 UIElement) |
| Triggers |
获取直接在此元素或子元素上建立的触发器的集合。 (继承自 FrameworkElement) |
| Uid |
获取或设置此元素的唯一标识符（用于本地化）。 这是一个依赖属性。 (继承自 UIElement) |
| UseLayoutRounding |
获取或设置一个值，该值指示布局舍入是否应用于布局期间此元素的大小和位置。 (继承自 FrameworkElement) |
| VerticalAlignment |
获取或设置在父元素（如面板或项控件）内组合时应用于此元素的垂直对齐特征。 (继承自 FrameworkElement) |
| VerticalContentAlignment |
获取或设置控件内容的垂直对齐方式。 (继承自 Control) |
| Visibility |
获取或设置此元素的用户界面（UI）可见性。 这是一个依赖属性。 (继承自 UIElement) |
| VisualBitmapEffect |
已过时.
已过时.
获取或设置 Visual的 BitmapEffect 值。 (继承自 Visual) |
| VisualBitmapEffectInput |
已过时.
已过时.
获取或设置 Visual的 BitmapEffectInput 值。 (继承自 Visual) |
| VisualBitmapScalingMode |
获取或设置 Visual的 BitmapScalingMode。 (继承自 Visual) |
| VisualCacheMode |
获取或设置 Visual的缓存表示形式。 (继承自 Visual) |
| VisualChildrenCount |
获取此元素中的视觉子元素数。 (继承自 FrameworkElement) |
| VisualClearTypeHint |
获取或设置确定 ClearType 在 Visual中的呈现方式的 ClearTypeHint。 (继承自 Visual) |
| VisualClip |
获取或设置 Visual 的剪辑区域作为 Geometry 值。 (继承自 Visual) |
| VisualEdgeMode |
获取或设置 Visual 的边缘模式作为 EdgeMode 值。 (继承自 Visual) |
| VisualEffect |
获取或设置要应用于 Visual的位图效果。 (继承自 Visual) |
| VisualOffset |
获取或设置视觉对象的偏移值。 (继承自 Visual) |
| VisualOpacity |
获取或设置 Visual的不透明度。 (继承自 Visual) |
| VisualOpacityMask |
获取或设置表示 Visual的不透明度掩码的 Brush 值。 (继承自 Visual) |
| VisualParent |
获取视觉对象的可视化树父级。 (继承自 Visual) |
| VisualScrollableAreaClip |
获取或设置 Visual的剪切可滚动区域。 (继承自 Visual) |
| VisualTextHintingMode |
获取或设置 Visual的 TextHintingMode。 (继承自 Visual) |
| VisualTextRenderingMode |
获取或设置 Visual的 TextRenderingMode。 (继承自 Visual) |
| VisualTransform | (继承自 Visual) |
| VisualXSnappingGuidelines |
获取或设置 x 坐标（垂直）准则集合。 (继承自 Visual) |
| VisualYSnappingGuidelines |
获取或设置 y 坐标（水平）准则集合。 (继承自 Visual) |
| Width |
获取或设置元素的宽度。 (继承自 FrameworkElement) |
| WindowStartupLocation |
获取或设置首次显示时窗口的位置。 (继承自 Window) |
| WindowState |
获取或设置一个值，该值指示窗口是还原、最小化还是最大化。 (继承自 Window) |
| WindowStyle |
获取或设置窗口的边框样式。 (继承自 Window) |
方法
事件
| Activated |
当窗口成为前台窗口时发生。 (继承自 Window) |
| Closed |
当窗口即将关闭时发生。 (继承自 Window) |
| Closing |
直接在调用 Close() 后发生，可以处理以取消窗口关闭。 (继承自 Window) |
| ContentRendered |
在呈现窗口的内容后发生。 (继承自 Window) |
| ContextMenuClosing |
在元素上的任何上下文菜单关闭之前发生。 (继承自 FrameworkElement) |
| ContextMenuOpening |
打开元素上的任何上下文菜单时发生。 (继承自 FrameworkElement) |
| DataContextChanged |
当此元素的数据上下文发生更改时发生。 (继承自 FrameworkElement) |
| Deactivated |
当窗口成为背景窗口时发生。 (继承自 Window) |
| DpiChanged |
在显示窗口的屏幕 DPI 发生更改后发生。 (继承自 Window) |
| DragEnter |
当输入系统将具有此元素的基础拖动事件报告为拖动目标时发生。 (继承自 UIElement) |
| DragLeave |
当输入系统报告具有此元素作为拖动原点的基础拖动事件时发生。 (继承自 UIElement) |
| DragOver |
当输入系统将具有此元素的基础拖动事件报告为潜在放置目标时发生。 (继承自 UIElement) |
| Drop |
当输入系统将此元素作为放置目标报告基础删除事件时发生。 (继承自 UIElement) |
| FocusableChanged |
当 Focusable 属性的值更改时发生。 (继承自 UIElement) |
| FragmentNavigation |
当导航到内容片段开始时发生（如果所需片段位于当前内容中），或者在加载源 XAML 内容之后（如果所需片段位于不同的内容中），则发生此事件。 |
| GiveFeedback |
当输入系统报告涉及此元素的基础拖放事件时发生。 (继承自 UIElement) |
| GotFocus |
当此元素获得逻辑焦点时发生。 (继承自 UIElement) |
| GotKeyboardFocus |
当键盘聚焦在此元素上时发生。 (继承自 UIElement) |
| GotMouseCapture |
当此元素捕获鼠标时发生。 (继承自 UIElement) |
| GotStylusCapture |
当此元素捕获触笔时发生。 (继承自 UIElement) |
| GotTouchCapture |
在捕获到此元素的触摸时发生。 (继承自 UIElement) |
| Initialized |
初始化此 FrameworkElement 时发生。 此事件与 IsInitialized 属性的值从 |
| IsEnabledChanged |
在此元素上 IsEnabled 属性值更改时发生。 (继承自 UIElement) |
| IsHitTestVisibleChanged |
在此元素上 IsHitTestVisible 依赖属性的值更改时发生。 (继承自 UIElement) |
| IsKeyboardFocusedChanged |
在此元素上 IsKeyboardFocused 属性值更改时发生。 (继承自 UIElement) |
| IsKeyboardFocusWithinChanged |
在此元素上 IsKeyboardFocusWithin 属性值更改时发生。 (继承自 UIElement) |
| IsMouseCapturedChanged |
在此元素上 IsMouseCaptured 属性值更改时发生。 (继承自 UIElement) |
| IsMouseCaptureWithinChanged |
当 IsMouseCaptureWithinProperty 的值在此元素上更改时发生。 (继承自 UIElement) |
| IsMouseDirectlyOverChanged |
在此元素上 IsMouseDirectlyOver 属性值更改时发生。 (继承自 UIElement) |
| IsStylusCapturedChanged |
在此元素上 IsStylusCaptured 属性值更改时发生。 (继承自 UIElement) |
| IsStylusCaptureWithinChanged |
在此元素上 IsStylusCaptureWithin 属性值更改时发生。 (继承自 UIElement) |
| IsStylusDirectlyOverChanged |
在此元素上 IsStylusDirectlyOver 属性值更改时发生。 (继承自 UIElement) |
| IsVisibleChanged |
在此元素上 IsVisible 属性值更改时发生。 (继承自 UIElement) |
| KeyDown |
当焦点位于此元素上时按下键时发生。 (继承自 UIElement) |
| KeyUp |
当焦点位于此元素上时释放键时发生。 (继承自 UIElement) |
| LayoutUpdated |
当与当前 Dispatcher 关联的各种视觉元素的布局发生更改时发生。 (继承自 UIElement) |
| LoadCompleted |
当导航到的内容已加载、分析和开始呈现时发生。 |
| Loaded |
在元素布局、呈现和准备交互时发生。 (继承自 FrameworkElement) |
| LocationChanged |
当窗口的位置发生更改时发生。 (继承自 Window) |
| LostFocus |
当此元素失去逻辑焦点时发生。 (继承自 UIElement) |
| LostKeyboardFocus |
当键盘不再专注于此元素时发生。 (继承自 UIElement) |
| LostMouseCapture |
当此元素丢失鼠标捕获时发生。 (继承自 UIElement) |
| LostStylusCapture |
当此元素丢失触笔捕获时发生。 (继承自 UIElement) |
| LostTouchCapture |
当此元素丢失触摸捕获时发生。 (继承自 UIElement) |
| ManipulationBoundaryFeedback |
在操作遇到边界时发生。 (继承自 UIElement) |
| ManipulationCompleted |
当 UIElement 对象的操作和惯性完成时发生。 (继承自 UIElement) |
| ManipulationDelta |
在操作过程中输入设备更改位置时发生。 (继承自 UIElement) |
| ManipulationInertiaStarting |
当输入设备在操作和惯性开始时失去与 UIElement 对象的接触时发生。 (继承自 UIElement) |
| ManipulationStarted |
当输入设备开始对 UIElement 对象执行操作时发生。 (继承自 UIElement) |
| ManipulationStarting |
首次创建操作处理器时发生。 (继承自 UIElement) |
| MouseDoubleClick |
单击两次或多次鼠标按钮时发生。 (继承自 Control) |
| MouseDown |
当指针位于此元素上时按下任何鼠标按钮时发生。 (继承自 UIElement) |
| MouseEnter |
当鼠标指针进入此元素的边界时发生。 (继承自 UIElement) |
| MouseLeave |
当鼠标指针离开此元素的边界时发生。 (继承自 UIElement) |
| MouseLeftButtonDown |
当鼠标指针位于此元素上时按下鼠标左键时发生。 (继承自 UIElement) |
| MouseLeftButtonUp |
当鼠标指针位于此元素上时释放鼠标左键时发生。 (继承自 UIElement) |
| MouseMove |
当鼠标指针在此元素上移动时发生。 (继承自 UIElement) |
| MouseRightButtonDown |
当鼠标指针位于此元素上时按下鼠标右键时发生。 (继承自 UIElement) |
| MouseRightButtonUp |
当鼠标指针位于此元素上时释放鼠标右键时发生。 (继承自 UIElement) |
| MouseUp |
在此元素上释放任何鼠标按钮时发生。 (继承自 UIElement) |
| MouseWheel |
当用户在鼠标指针位于此元素上时旋转鼠标滚轮时发生。 (继承自 UIElement) |
| Navigated |
在找到要导航到的内容时发生，并且可从 Content 属性获取，尽管它可能尚未完成加载。 |
| Navigating |
请求新导航时发生。 |
| NavigationFailed |
在导航到请求的内容时引发错误时发生。 |
| NavigationProgress |
在下载过程中定期发生，以提供导航进度信息。 |
| NavigationStopped |
在调用 StopLoading() 方法时或当前导航正在进行时请求新的导航时发生。 |
| PreviewDragEnter |
当输入系统将具有此元素的基础拖动事件报告为拖动目标时发生。 (继承自 UIElement) |
| PreviewDragLeave |
当输入系统报告具有此元素作为拖动原点的基础拖动事件时发生。 (继承自 UIElement) |
| PreviewDragOver |
当输入系统将具有此元素的基础拖动事件报告为潜在放置目标时发生。 (继承自 UIElement) |
| PreviewDrop |
当输入系统将此元素作为放置目标报告基础删除事件时发生。 (继承自 UIElement) |
| PreviewGiveFeedback |
在启动拖放操作时发生。 (继承自 UIElement) |
| PreviewGotKeyboardFocus |
当键盘聚焦在此元素上时发生。 (继承自 UIElement) |
| PreviewKeyDown |
当焦点位于此元素上时按下键时发生。 (继承自 UIElement) |
| PreviewKeyUp |
当焦点位于此元素上时释放键时发生。 (继承自 UIElement) |
| PreviewLostKeyboardFocus |
当键盘不再专注于此元素时发生。 (继承自 UIElement) |
| PreviewMouseDoubleClick |
当用户单击鼠标按钮两次或两次以上时发生。 (继承自 Control) |
| PreviewMouseDown |
当指针位于此元素上时按下任何鼠标按钮时发生。 (继承自 UIElement) |
| PreviewMouseLeftButtonDown |
当鼠标指针位于此元素上时按下鼠标左键时发生。 (继承自 UIElement) |
| PreviewMouseLeftButtonUp |
当鼠标指针位于此元素上时释放鼠标左键时发生。 (继承自 UIElement) |
| PreviewMouseMove |
当鼠标指针位于此元素上时鼠标指针移动时发生。 (继承自 UIElement) |
| PreviewMouseRightButtonDown |
当鼠标指针位于此元素上时按下鼠标右键时发生。 (继承自 UIElement) |
| PreviewMouseRightButtonUp |
当鼠标指针位于此元素上时释放鼠标右键时发生。 (继承自 UIElement) |
| PreviewMouseUp |
当鼠标指针位于此元素上时释放任何鼠标按钮时发生。 (继承自 UIElement) |
| PreviewMouseWheel |
当用户在鼠标指针位于此元素上时旋转鼠标滚轮时发生。 (继承自 UIElement) |
| PreviewQueryContinueDrag |
在拖放操作期间键盘或鼠标按钮状态发生更改时发生。 (继承自 UIElement) |
| PreviewStylusButtonDown |
当指针位于此元素上时按下触笔按钮时发生。 (继承自 UIElement) |
| PreviewStylusButtonUp |
当指针位于此元素上时释放触笔按钮时发生。 (继承自 UIElement) |
| PreviewStylusDown |
当触笔位于此元素上时触摸数字化器时发生。 (继承自 UIElement) |
| PreviewStylusInAirMove |
当触笔在元素上移动而不实际触摸数字化器时发生。 (继承自 UIElement) |
| PreviewStylusInRange |
当触笔足够接近数字化器以检测到时发生，同时在该元素上。 (继承自 UIElement) |
| PreviewStylusMove |
触笔在元素上移动时发生。 在数字化器检测到引发此事件时，触笔必须移动，否则将引发 PreviewStylusInAirMove。 (继承自 UIElement) |
| PreviewStylusOutOfRange |
当触笔离数字化器太远而无法检测到时发生。 (继承自 UIElement) |
| PreviewStylusSystemGesture |
当用户执行多个触笔手势之一时发生。 (继承自 UIElement) |
| PreviewStylusUp |
当用户在触笔位于此元素上时将触笔从数字化器上引发触笔时发生。 (继承自 UIElement) |
| PreviewTextInput |
当此元素以独立于设备的方式获取文本时发生。 (继承自 UIElement) |
| PreviewTouchDown |
当手指触摸屏幕时手指位于此元素上时发生。 (继承自 UIElement) |
| PreviewTouchMove |
当手指位于此元素上时，手指在屏幕上移动时发生。 (继承自 UIElement) |
| PreviewTouchUp |
当手指位于此元素上时，手指从屏幕上抬起时发生。 (继承自 UIElement) |
| QueryContinueDrag |
在拖放操作期间键盘或鼠标按钮状态发生更改时发生。 (继承自 UIElement) |
| QueryCursor |
当请求显示游标时发生。 每次鼠标指针移动到新位置时，都会对元素引发此事件，这意味着光标对象可能需要根据其新位置进行更改。 (继承自 UIElement) |
| RequestBringIntoView |
在此元素上调用 BringIntoView(Rect) 时发生。 (继承自 FrameworkElement) |
| SizeChanged |
在此元素上更改 ActualHeight 或 ActualWidth 属性更改值时发生。 (继承自 FrameworkElement) |
| SourceInitialized |
引发此事件以支持与 Win32 的互操作。 请参阅 HwndSource。 (继承自 Window) |
| SourceUpdated |
当源值更改此元素上任何现有属性绑定时发生。 (继承自 FrameworkElement) |
| StateChanged |
当窗口 WindowState 属性更改时发生。 (继承自 Window) |
| StylusButtonDown |
当指针位于此元素上时按下触笔按钮时发生。 (继承自 UIElement) |
| StylusButtonUp |
当指针位于此元素上时释放触笔按钮时发生。 (继承自 UIElement) |
| StylusDown |
触笔触摸数字化器时，触笔位于此元素上时发生。 (继承自 UIElement) |
| StylusEnter |
当触笔进入此元素的边界时发生。 (继承自 UIElement) |
| StylusInAirMove |
当触笔在元素上移动而不实际触摸数字化器时发生。 (继承自 UIElement) |
| StylusInRange |
当触笔足够接近数字化器以检测到时发生，同时在该元素上。 (继承自 UIElement) |
| StylusLeave |
当触笔离开元素的边界时发生。 (继承自 UIElement) |
| StylusMove |
当触笔移到此元素上时发生。 触笔必须在数字化器上移动才能引发此事件。 否则，将改为引发 StylusInAirMove。 (继承自 UIElement) |
| StylusOutOfRange |
当触笔离数字化器太远而无法检测到时发生，同时在该元素上。 (继承自 UIElement) |
| StylusSystemGesture |
当用户执行多个触笔手势之一时发生。 (继承自 UIElement) |
| StylusUp |
当用户在此元素上时将触笔从数字化器上引发触笔时发生。 (继承自 UIElement) |
| TargetUpdated |
当目标值更改此元素上的任何属性绑定时发生。 (继承自 FrameworkElement) |
| TextInput |
当此元素以独立于设备的方式获取文本时发生。 (继承自 UIElement) |
| ToolTipClosing |
在关闭元素上的任何工具提示之前发生。 (继承自 FrameworkElement) |
| ToolTipOpening |
打开元素上的任何工具提示时发生。 (继承自 FrameworkElement) |
| TouchDown |
当手指触摸屏幕时手指位于此元素上时发生。 (继承自 UIElement) |
| TouchEnter |
当触摸从外部移动到此元素的边界内时发生。 (继承自 UIElement) |
| TouchLeave |
当触摸从内到此元素边界外移动时发生。 (继承自 UIElement) |
| TouchMove |
当手指位于此元素上时，手指在屏幕上移动时发生。 (继承自 UIElement) |
| TouchUp |
当手指位于此元素上时，手指从屏幕上抬起时发生。 (继承自 UIElement) |
| Unloaded |
从已加载元素的元素树中删除元素时发生。 (继承自 FrameworkElement) |
显式接口实现
| IAddChild.AddChild(Object) |
此类型或成员支持 Windows Presentation Foundation （WPF） 基础结构，不打算直接从代码使用。 (继承自 ContentControl) |
| IAddChild.AddText(String) |
此类型或成员支持 Windows Presentation Foundation （WPF） 基础结构，不打算直接从代码使用。 (继承自 ContentControl) |
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
有关此成员的说明，请参阅 IsAmbientPropertyAvailable(String) 方法。 (继承自 FrameworkElement) |
| IUriContext.BaseUri |
获取或设置当前上下文的基本统一资源标识符（URI）。 |
适用于
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈