WinUI 3中如何点击按钮切换MainWindow主窗口内容
WinUI 3 主窗口内切换内容实现方法
WinUI 3 中 Window 类仅作为顶层窗口的宿主容器,窗口内展示的所有UI元素都赋值给 Window 的 Content 属性,要实现同窗口内内容替换,不需要创建新的 Window 实例,直接替换 MainWindow 的 Content 属性即可,具体操作如下:
- 重构现有SecondWindow的内容
不要把业务UI直接写在SecondWindow的XAML中,右键项目新增一个WinUI 用户控件(UserControl)或者WinUI 页面(Page),命名为SecondContent,把原本写在SecondWindow里的所有XAML布局、交互逻辑全部迁移到这个新建的控件/页面中,没有其他用途的SecondWindow可以直接删除。注意:不能直接把已激活的SecondWindow的Content属性取值后赋值给MainWindow,WinUI中UI元素遵循单父容器规则,同时归属两个父容器会直接抛出运行时异常。
- 实现按钮点击切换逻辑
按钮点击事件中,直接给MainWindow的Content赋值新建的SecondContent实例即可替换原有内容,代码如下:
// 点击按钮切换主窗口内容 private void SwitchContentButton_Click(object sender, RoutedEventArgs e) { this.Content = new SecondContent(); }
如果需要保留MainWindow原有内容、支持后续切回,可以在MainWindow初始化时把初始内容存到私有字段里:
private UIElement _mainWindowOriginalContent; public MainWindow() { InitializeComponent(); // 缓存初始内容 _mainWindowOriginalContent = this.Content; } // 切回原内容的方法 private void SwitchBackToOriginal() { this.Content = _mainWindowOriginalContent; }
- 多内容场景推荐方案
如果后续需要在主窗口中切换多组内容,更推荐使用WinUI 3内置的Frame作为根容器做导航管理,天然支持页面缓存、导航日志、参数传递等能力,实现方式:- 在MainWindow构造函数中,初始化Frame作为窗口的根Content
- 通过Frame的
Navigate方法切换不同的Page页面
示例代码:
public MainWindow() { InitializeComponent(); // 初始化导航容器 Frame rootNavFrame = new Frame(); this.Content = rootNavFrame; // 默认加载初始主页面 rootNavFrame.Navigate(typeof(MainPage)); } // 按钮点击导航到SecondPage private void NavigateToSecondPage_Click(object sender, RoutedEventArgs e) { if (this.Content is Frame navFrame) { navFrame.Navigate(typeof(SecondPage)); } }
内容的提问来源于stack exchange,提问作者Ricky Kresslein
相关产品推荐
相关产品推荐

